CKTIS / JavaScript
CharacterData.data — odczyt i zmiana danych węzła
Właściwość CharacterData.data pozwala odczytać lub zastąpić dane tekstowe pojedynczego węzła, na przykład Text lub Comment. Przypisanie null ustawia pusty ciąg znaków.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
node.data
node.data = valueCharacterData.data to zapisywalna właściwość zawierająca ciąg znaków danego węzła DOM. CharacterData jest interfejsem abstrakcyjnym; korzystasz z niego przez konkretne typy, takie jak Text, Comment, CDATASection i ProcessingInstruction.
Odczyt node.data zwraca bieżące dane. Przypisanie node.data = value zastępuje całą ich zawartość, zamiast dopisywać tekst. Szczególnym przypadkiem jest null: zostaje zamienione na "", a nie na ciąg "null". W przypadku Comment wartością są dane komentarza, bez znaczników komentarza.
Jest to API DOM, a nie funkcja samego ECMAScript. MDN oznacza tę właściwość jako szeroko dostępną w przeglądarkach od lipca 2015 roku. Obecność Node.js 24 w repozytorium nie dowodzi dostępności tego API. Przykład wymaga przeglądarkowego document i używa odłączonych węzłów, więc nie zmienia strony.
Przykłady
const text = document.createTextNode("Hello");
const comment = document.createComment("note");
console.log(text.data);
text.data = "Updated";
console.log(text.data);
console.log(comment.data);
text.data = null;
console.log(JSON.stringify(text.data));Wynik
Hello Updated note ""
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.