WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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 = value

CharacterData.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.

Quellen