KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

document.getElementById — een element zoeken op ID

document.getElementById(elementId) geeft het element met de opgegeven ID terug, of null. De zoekopdracht is hoofdlettergevoelig en doorzoekt de afstammelingen van het document.

Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

document.getElementById(elementId)

document.getElementById(elementId) is een DOM-methode en maakt geen deel uit van ECMAScript zelf. Geef een id-waarde door, zoals "status", zonder een #-prefix: het argument is geen CSS-selector. Het resultaat is een Element of null. De zoekopdracht is hoofdlettergevoelig; een lege identificatie levert geen overeenkomst op.

De methode doorzoekt de afstammelingen van het document. Een losgekoppeld element wordt niet gevonden. Bij dubbele ID’s geeft de methode het eerste element in boomvolgorde terug, niet noodzakelijk het element dat als eerste is gemaakt. Controleer voordat je het resultaat gebruikt of het niet null is; zoek pas nadat het doelelement aan het document is toegevoegd.

getElementById is ook beschikbaar op DocumentFragment, maar niet op gewone Element-objecten. Zoeken in het document gaat shadow trees niet binnen. Het voorbeeld vereist een browser-DOM-omgeving; alleen een Node.js-versie bewijst niet dat deze API beschikbaar is.

Voorbeelden

{
  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);
}

Resultaat

true
true
true
true

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen