CKTIS / JavaScript
CharacterData.data – Knotendaten lesen und ändern
Die Eigenschaft CharacterData.data liest die Textdaten eines einzelnen Knotens, etwa eines Text- oder Kommentarknotens, oder ersetzt sie. Wird null zugewiesen, wird eine leere Zeichenfolge gesetzt.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
node.data
node.data = valueCharacterData.data ist eine beschreibbare Eigenschaft, die die Zeichenfolgendaten eines DOM-Knotens enthält. CharacterData ist eine abstrakte Schnittstelle; verwendet wird sie über konkrete Typen wie Text, Comment, CDATASection und ProcessingInstruction.
Beim Lesen von node.data werden die aktuellen Daten zurückgegeben. Durch node.data = value wird der gesamte Inhalt ersetzt, nicht etwa Text angehängt. Der Sonderfall null wird zu "", nicht zur Zeichenfolge "null". Bei einem Comment enthält der Wert die Kommentardaten ohne die Kommentar-Begrenzer.
Dies ist eine DOM-API und keine Funktion von ECMAScript selbst. MDN kennzeichnet diese Eigenschaft seit Juli 2015 als in Browsern breit verfügbar. Dass ein Repository Node.js 24 enthält, belegt nicht, dass diese API verfügbar ist. Das Beispiel benötigt ein Browser-document und verwendet abgetrennte Knoten, verändert die Seite also nicht.
Beispiele
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));Ergebnis
Hello Updated note ""
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.