CKTIS / JavaScript
Node.textContent — lire et remplacer du texte
Node.textContent lit le texte d’un nœud ou remplace son contenu textuel, sans analyser le HTML.
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.textContent
node.textContent = textNode.textContent est une propriété du DOM, et non une fonctionnalité d’ECMAScript. Pour Element et DocumentFragment, elle concatène les données des nœuds Text descendants dans l’ordre de l’arbre, sans séparateur et en excluant les commentaires. Elle ne filtre pas le texte selon sa visibilité CSS.
Une affectation remplace tous les enfants par un seul nœud Text ; '' ou null les supprime sans en créer de nouveau. Le balisage reste du texte. Pour Attr, la propriété lit ou modifie la valeur ; pour CharacterData, les données. Pour Document et DocumentType, la lecture renvoie null et l’écriture ne fait rien.
Exemples
const box = document.createElement('div');
const child = document.createElement('span');
child.textContent = 'world';
box.append('Hello ', child);
console.log(box.textContent);
box.textContent = '<b>Literal</b>';
console.log(box.textContent);
console.log(box.childNodes.length, box.firstChild.nodeType);
box.textContent = null;
console.log(box.childNodes.length);Résultat
Hello world <b>Literal</b> 1 3 0
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.