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.
The CharacterData abstract interface represents a Node object that contains characters. This is an abstract interface, meaning there aren't any objects of type CharacterData: it is implemented by other interfaces like Text, Comment, CDATASection, or ProcessingInstruction, which aren't abstract.
Instance properties
This interface also inherits properties from its parents, Node and EventTarget.
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 first
Elementthat follows this node, and is a sibling. CharacterData.previousElementSiblingRead only-
Returns the first
Elementthat precedes this node, and is a sibling.
Instance methods
This interface also inherits methods from its parents, Node and EventTarget.
CharacterData.after()-
Inserts a set of
Nodeobjects or strings in the children list of theCharacterData's parent, just after theCharacterDataobject. CharacterData.appendData()-
Appends the given string to the
CharacterData.datastring; when this method returns,datacontains the concatenated string. CharacterData.before()-
Inserts a set of
Nodeobjects or strings in the children list of theCharacterData's parent, just before theCharacterDataobject. CharacterData.deleteData()-
Removes the specified amount of characters, starting at the specified offset, from the
CharacterData.datastring; when this method returns,datacontains the shortened string. CharacterData.insertData()-
Inserts the specified characters, at the specified offset, in the
CharacterData.datastring; when this method returns,datacontains 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,
datacontains the modified string. CharacterData.replaceWith()-
Replaces the characters in the children list of its parent with a set of
Nodeobjects or strings. CharacterData.substringData()-
Returns a string containing the part of
CharacterData.dataof the specified length and starting at the specified offset.
Specifications
| Specification |
|---|
| DOM # interface-characterdata |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
CharacterData
|
|
|
|
|
|
|
|
|
|
|
|
|
after
|
|
|
|
|
|
|
|
|
|
|
|
|
appendData
|
|
|
|
|
|
|
|
|
|
|
|
|
before
|
|
|
|
|
|
|
|
|
|
|
|
|
data
|
|
|
|
|
|
|
|
|
|
|
|
|
deleteData
|
|
|
|
|
|
|
|
|
|
|
|
|
insertData
|
|
|
|
|
|
|
|
|
|
|
|
|
length
|
|
|
|
|
|
|
|
|
|
|
|
|
nextElementSibling
|
|
|
|
|
|
|
|
|
|
|
|
|
previousElementSibling
|
|
|
|
|
|
|
|
|
|
|
|
|
remove
|
|
|
|
|
|
|
|
|
|
|
|
|
replaceData
|
|
|
|
|
|
|
|
|
|
|
|
|
replaceWith
|
|
|
|
|
|
|
|
|
|
|
|
|
substringData
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
See also
- The DOM overview page.
- The concrete interfaces implemented it:
Text,CDATASection,ProcessingInstruction, andComment.