CKTIS / JavaScript
CharacterData.data — lire et modifier les données d’un nœud
La propriété CharacterData.data permet de lire ou de remplacer les données textuelles d’un seul nœud, comme Text ou Comment. Lui attribuer null définit une chaîne vide.
Version : 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 est une propriété modifiable qui contient les données sous forme de chaîne d’un nœud DOM. CharacterData est une interface abstraite ; on l’utilise par l’intermédiaire de types concrets tels que Text, Comment, CDATASection et ProcessingInstruction.
La lecture de node.data renvoie les données actuelles. L’affectation de node.data = value remplace tout le contenu au lieu d’ajouter du texte. Le cas particulier est null : il devient "", et non la chaîne "null". Pour un Comment, la valeur correspond aux données du commentaire, sans ses délimiteurs.
Il s’agit d’une API DOM, et non d’une fonctionnalité d’ECMAScript lui-même. MDN indique que cette propriété est largement disponible dans les navigateurs depuis juillet 2015. La présence de Node.js 24 dans un dépôt ne prouve pas que cette API y est disponible. L’exemple nécessite un document de navigateur et utilise des nœuds détachés ; il ne modifie donc pas la page.
Exemples
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));Résultat
Hello Updated note ""
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.