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.
CharacterData
Properties
This interface also inherits properties from its parents, Node
and EventTarget
.
-
CharacterData.data
-
Is a string representing the textual data contained in this object.
-
CharacterData.length
Read only -
Returns a number representing the size of the string contained in the object.
-
CharacterData.nextElementSibling
Read only -
Returns the first
Element
that follows this node, and is a sibling. -
CharacterData.previousElementSibling
Read only -
Returns the first
Element
that precedes this node, and is a sibling.
Methods
This interface also inherits methods from its parents, Node
and EventTarget
.
-
CharacterData.after()
-
Inserts a set of
Node
objects or strings in the children list of theCharacterData
's parent, just after theCharacterData
object. -
CharacterData.appendData()
-
Appends the given string to the
CharacterData.data
string; when this method returns,data
contains the concatenated string. -
CharacterData.before()
-
Inserts a set of
Node
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 the
CharacterData.data
string; when this method returns,data
contains the shortened string. -
CharacterData.insertData()
-
Inserts the specified characters, at the specified offset, in the
CharacterData.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
DOMString
; when this method returns,data
contains the modified string. -
CharacterData.replaceWith()
-
Replaces the characters in the children list of its parent with a set of
Node
objects or strings. -
CharacterData.substringData()
-
Returns a string containing the part of
CharacterData.data
of 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
|
1
|
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
|
1
|
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
|
1
|
18
|
4
|
≤12.1
|
1
|
1.0
|
deleteData |
1
|
12
|
1
|
6
|
≤12.1
|
1
|
1
|
18
|
4
|
≤12.1
|
1
|
1.0
|
insertData |
1
|
12
|
1
|
6
|
≤12.1
|
1
|
1
|
18
|
4
|
≤12.1
|
1
|
1.0
|
length |
1
|
12
|
1
|
5
|
≤12.1
|
1
|
1
|
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
|
1
|
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
|
1
|
18
|
4
|
≤12.1
|
1
|
1.0
|
See also
- The DOM overview page.
- The concrete interfaces implemented it:
Text
,CDATASection
,ProcessingInstruction
, andComment
.
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/CharacterData