Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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

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

Sources