CharacterData: data property
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 data
property of the CharacterData
interface represent the value of the current object's data.
Value
A string with the character information contained in the CharacterData
node.
When set to the null
value, that null
value is converted to the empty string (""
), so cd.data = null
is equivalent to cd.data = ""
.
Example
Note: CharacterData
is an abstract interface.
The examples below use two concrete interfaces implementing it, Text
and Comment
.
Reading a comment using data
html
<!-- This is an HTML comment -->
<output id="result"></output>
js
const comment = document.body.childNodes[1];
const output = document.getElementById("result");
output.value = comment.data;
Setting the content of a text node using data
html
<span>Result: </span>Not set.
js
const span = document.querySelector("span");
const textNode = span.nextSibling;
textNode.data = "This text has been set using 'textNode.data'.";
Specifications
Specification |
---|
DOM # dom-characterdata-data |
Browser compatibility
Report problems with this compatibility data on GitHubdesktop | mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
data |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
See also
CharacterData.length
returning the length of the data contained in theCharacterData
node.