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

CKTIS / JavaScript

document.getElementById — trouver un élément par son ID

document.getElementById(elementId) renvoie l’élément portant l’ID indiqué ou null. La recherche distingue les majuscules et les minuscules et parcourt les descendants du document.

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

document.getElementById(elementId)

document.getElementById(elementId) est une méthode du DOM, et non une partie d’ECMAScript lui-même. Passez une valeur id, par exemple "status", sans préfixe # : l’argument n’est pas un sélecteur CSS. Le résultat est un Element ou null. La recherche distingue les majuscules et les minuscules ; un identifiant vide ne correspond à aucun élément.

La méthode parcourt les descendants du document. Un élément détaché ne sera pas trouvé. En présence d’ID en double, elle renvoie le premier élément dans l’ordre de l’arbre, qui n’est pas nécessairement le premier créé. Vérifiez que le résultat n’est pas null avant de l’utiliser ; effectuez la recherche seulement après avoir ajouté l’élément cible au document.

getElementById est également disponible sur DocumentFragment, mais pas sur les objets Element ordinaires. La recherche dans le document ne pénètre pas dans les arbres d’ombre. L’exemple nécessite un environnement DOM de navigateur ; une version de Node.js à elle seule ne permet pas d’établir la disponibilité de cette API.

Exemples

{
  const document = globalThis.document.implementation.createHTMLDocument("");
  const item = document.createElement("div");
  item.id = "status";

  console.log(document.getElementById("status") === null);
  document.body.appendChild(item);
  console.log(document.getElementById("status") === item);
  console.log(document.getElementById("Status") === null);
  item.remove();
  console.log(document.getElementById("status") === null);
}

Résultat

true
true
true
true

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