CKTIS / JavaScript
CharacterData.data — čtení a změna dat uzlu
Vlastnost CharacterData.data umožňuje číst nebo nahradit textová data jednoho uzlu, například Text nebo Comment. Přiřazení hodnoty null nastaví prázdný řetězec.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
node.data
node.data = valueCharacterData.data je zapisovatelná vlastnost obsahující řetězcová data uzlu DOM. CharacterData je abstraktní rozhraní; používá se prostřednictvím konkrétních typů, jako jsou Text, Comment, CDATASection a ProcessingInstruction.
Čtení node.data vrací aktuální data. Přiřazení node.data = value nahradí celý obsah, místo aby připojilo text. Zvláštním případem je null: změní se na "", nikoli na řetězec "null". U objektu Comment hodnota obsahuje data komentáře bez jeho oddělovačů.
Jde o API DOM, nikoli o funkci samotného ECMAScriptu. MDN uvádí, že tato vlastnost je v prohlížečích široce dostupná od července 2015. Přítomnost Node.js 24 v repozitáři nedokazuje, že je toto API dostupné. Příklad vyžaduje prohlížečové document a používá odpojené uzly, takže stránku nemění.
Příklady
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));Výsledek
Hello Updated note ""
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.