Accueil >JavaScript >Référence JS – méthodes et objets >Document.getElementById()

Document.getElementById()

document.getElementById(id)

Renvoie l’élément avec l’id indiqué, ou null. C’est la façon la plus rapide de trouver un élément précis.

L’exemple travaille avec le code HTML placé au-dessus du code JavaScript. Un élément affiché par console.log apparaît sous la forme de sa balise ouvrante.

Paramètres

  • id – la valeur de l’attribut id sans le signe #.

Valeur de retour

Un élément ou null.

Exemples

<form id="contact"><input id="email" type="email" value="marie@example.fr"></form>

const email = document.getElementById('email');
console.log(email, email.value);
console.log(document.getElementById('#email'), document.getElementById('signup'));
console.log(document.getElementById('email') === document.querySelector('#email'));

Résultat :

<input id="email" type="email" value="marie@example.fr"> marie@example.fr
null null
true

Points d’attention

  • Elle s’écrit sans # – getElementById('#email') cherche l’id « #email » et renvoie null.
  • Elle n’existe que sur document, pas sur les différents éléments (là, utilisez querySelector()).
  • Un id doit être unique sur la page ; en cas de doublons, la méthode renvoie le premier élément.

Prise en charge par les navigateurs

Baseline – largement disponible : fonctionne dans tous les navigateurs courants, et depuis longtemps (au plus tard depuis 2015). Depuis la version : Chrome 1, Firefox 1, Safari 1 ; absent de Node.js (API du navigateur). État : octobre 2026 (MDN browser-compat-data).

Voir aussi :
Document.querySelector()
HTMLInputElement.value