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

CKTIS / JavaScript

DOM — modèle objet de document

Le DOM représente un document sous la forme d’un arbre d’objets que JavaScript peut lire et modifier. La manipulation du DOM comprend la création, l’insertion, la mise à jour et la suppression de nœuds. Il s’agit d’une interface fournie par l’environnement du navigateur, et non de la syntaxe du langage ECMAScript.

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

{
  const parent = document.createElement("div");
  const element = document.createElement("p");
  element.textContent = "Hello";
  parent.appendChild(element);
}

Le DOM (Document Object Model) est une représentation d’un document sous la forme d’un arbre d’objets. Le document, les éléments et le texte sont différents types de nœuds ; un élément n’est pas la même chose que le texte qu’il contient. DOM manipulation désigne la lecture et la modification de cet arbre par programmation, par exemple en mettant à jour du texte ou en ajoutant des éléments.

L’objet document fournit des opérations sur le document. document.createElement("p") crée un élément, mais ne l’insère pas automatiquement dans la page. Affecter une valeur à textContent définit du contenu textuel au lieu de l’interpréter comme du balisage. parent.appendChild(element) rattache un nœud à un parent ; si le nœud a déjà un parent, il le déplace au lieu de le copier. Pour modifier la page visible, il faut travailler avec des nœuds rattachés à son document.

Dans l’exemple, les deux éléments restent en dehors de l’arbre de la page. La lecture de container.textContent renvoie tout de même le texte de son descendant ; le résultat est donc déterministe et indépendant du contenu déjà présent sur la page. L’exemple ne dépend pas d’éléments qui devraient déjà exister.

La spécification ECMAScript définit le langage, et non les API du DOM. L’environnement fournit des objets et des fonctions supplémentaires. Le standard DOM du WHATWG définit createElement, textContent et appendChild. La prise en charge de ces API par les navigateurs doit être vérifiée séparément. Aucune édition d’ECMAScript n’est donc attribuée ici au DOM. La présence de Node 24 dans le dépôt ne prouve ni que document est disponible ni que les API de navigateur sont prises en charge ; l’exemple nécessite un environnement doté d’un DOM.

Exemples

const container = document.createElement("div");
const message = document.createElement("p");
message.textContent = "Hello, DOM!";
container.appendChild(message);
console.log(container.textContent);

Résultat

Hello, DOM!

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