JavaScript: The Definitive Guide, Fourth Edition

Name

CharacterData.insertData( ) — insert a string into a Text or Comment node

Availability

DOM Level 1 Core

Synopsis

void insertData(unsigned long offset,
                String arg) 
    throws DOMException;

Arguments

offset

The character position within the Text or Comment node at which the string is to be inserted.

arg

The string to insert.

Throws

This method may throw a DOMException with one of the following code values in the following circumstances:

INDEX_SIZE_ERR

offset is negative or greater than the length of the Text or Comment node.

NO_MODIFICATION_ALLOWED_ERR

The node is read-only and may not be modified.

Description

This method inserts the specified string arg into the text of a Text or Comment node at the specified position offset.