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.
On this page
CharacterData
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 Standard # interface-characterdata |
Browser compatibility
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
CharacterData |
1 | 12 | 1 | 5 | ≤12.1 | 1 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
after |
54 | 17 | 49 | No | 39 | 10 | 54 | 54 | 49 | 41 | 10 | 6.0 |
appendData |
1 | 12 | 1 | 6 | ≤12.1 | 1 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
before |
54 | 17 | 49 | No | 39 | 10 | 54 | 54 | 49 | 41 | 10 | 6.0 |
data |
1 | 12 | 1 | 5 | ≤12.1 | 1 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
deleteData |
1 | 12 | 1 | 6 | ≤12.1 | 1 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
insertData |
1 | 12 | 1 | 6 | ≤12.1 | 1 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
length |
1 | 12 | 1 | 5 | ≤12.1 | 1 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
nextElementSibling |
29 | 17 | 25 | No | 16 | 9 | 4.4 | 29 | 25 | 16 | 9 | 2.0 |
previousElementSibling |
29 | 17 | 25 | No | 16 | 9 | 4.4 | 29 | 25 | 16 | 9 | 2.0 |
remove |
24 | 12 | 23 | No | 15 | 7 | 4.4 | 25 | 23 | 14 | 7 | 1.5 |
replaceData |
1 | 12 | 1 | 6 | ≤12.1 | 1 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
replaceWith |
54 | 17 | 49 | No | 39 | 10 | 54 | 54 | 49 | 41 | 10 | 6.0 |
substringData |
1 | 12 | 1 | 6 | ≤12.1 | 1 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
See also
- The DOM overview page.
- The concrete interfaces implemented it:
Text,CDATASection,ProcessingInstruction, andComment.
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/CharacterData