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

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

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

Sources