JavaScript: The Definitive Guide

2017-07-07 02:10:07

25.45. CharacterData.replaceData( ): replace characters of a Text or Comment node with a string

DOM Level 1 Core:

25.45.1. Synopsis

void replaceData(unsigned long offset, unsigned long count, String arg) tHRows DOMException;

25.45.1.1. Arguments

offset: The character position within the Text or Comment node at which the replacement is to begin.
count: The number of characters to be replaced.
arg: The string that replaces the characters specified by offset and count.

25.45.1.2. 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, or count is negative.
NO_MODIFICATION_ALLOWED_ERR: The node is read-only and may not be modified.

25.45.2. Description

This method replaces count characters starting at position offset with the contents of the string arg. If the sum of offset and count is greater than the length of the Text or Comment node, all characters from offset on are replaced.

Notice that the insertData( ) and deleteData( ) methods are both special cases of this one.