CharacterData

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨July 2015⁩.

TheCharacterData abstract interface represents aNode object that contains characters. This is an abstract interface, meaning there aren't any objects of typeCharacterData: it is implemented by other interfaces likeText,Comment,CDATASection, orProcessingInstruction, which aren't abstract.

Instance properties

This interface also inherits properties from its parents,Node andEventTarget.

CharacterData.data: A string representing the textual data contained in this object.
CharacterData.lengthRead only: Returns a number representing the size of the string contained in the object.
CharacterData.nextElementSiblingRead only: Returns the firstElement thatfollows this node, and is a sibling.
CharacterData.previousElementSiblingRead only: Returns the firstElement thatprecedes this node, and is a sibling.

Instance methods

This interface also inherits methods from its parents,Node andEventTarget.

CharacterData.after(): Inserts a set ofNode objects or strings in the children list of theCharacterData's parent, just after theCharacterData object.
CharacterData.appendData(): Appends the given string to theCharacterData.data string; when this method returns,data contains the concatenated string.
CharacterData.before(): Inserts a set ofNode objects or strings in the children list of theCharacterData's parent, just before theCharacterData object.
CharacterData.deleteData(): Removes the specified amount of characters, starting at the specified offset, from theCharacterData.data string; when this method returns,data contains the shortened string.
CharacterData.insertData(): Inserts the specified characters, at the specified offset, in theCharacterData.data string; when this method returns,data contains the modified string.
CharacterData.remove(): Removes the object from its parent children list.
CharacterData.replaceData(): Replaces the specified amount of characters, starting at the specified offset, with the specified string; when this method returns,data contains the modified string.
CharacterData.replaceWith(): Replaces the characters in the children list of its parent with a set ofNode objects or strings.
CharacterData.substringData(): Returns a string containing the part ofCharacterData.data of the specified length and starting at the specified offset.