Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

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

Zdroje