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

CKTIS / JavaScript

Document — accéder au document d’une page

Document représente un document DOM. L’objet document permet de rechercher des éléments, de lire la racine du document et d’utiliser des propriétés de page liées au titre, au focus et à la visibilité. Il s’agit d’une interface de la plateforme Web, et non d’une partie d’ECMAScript lui-même.

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(id)
document.documentElement
document.body
document.title
document.activeElement
document.hidden
document.addEventListener("visibilitychange", handler)

Document représente un document DOM ; dans un script de page, document désigne le document actuel. Ce n’est ni window ni l’élément racine. Il s’agit d’une interface de la plateforme Web : la seule disponibilité de JavaScript, y compris dans Node 24, ne prouve pas que cette interface est prise en charge.

Document.getElementById(id) renvoie le premier élément correspondant dans l’ordre de l’arbre, ou null. Passe l’identifiant sans # et vérifie le résultat avant de l’utiliser. Document.documentElement désigne l’élément racine ou vaut null. Dans une page HTML typique, il s’agit de l’élément html. Document.body fournit l’élément body ou frameset, mais peut valoir null, par exemple avant que l’analyseur ne le crée. Document.title permet de lire ou de modifier le titre du document.

Document.activeElement désigne l’élément associé au focus ; il ne s’agit pas nécessairement d’un champ de texte. Lorsque le focus se trouve dans un document intégré ou un arbre d’ombre, il peut désigner respectivement l’élément intégrant ou l’hôte, plutôt que l’élément le plus profond. Document.hidden est une valeur booléenne qui indique si le document est masqué, et non s’il a perdu le focus. Document.visibilitychange désigne l’événement visibilitychange, pas une méthode : gère-le avec document.addEventListener("visibilitychange", handler) et lis document.hidden dans le gestionnaire.

L’exemple crée un document HTML distinct : il ne modifie donc pas la page ouverte et produit des valeurs prévisibles. Il ne teste pas le focus ni la visibilité, qui dépendent de l’environnement. La couverture des sources est limitée : le DOM Standard fourni définit le cœur de Document, mais pas toutes les extensions HTML mentionnées concernant le titre, le corps, le focus et la visibilité. Les versions minimales des navigateurs n’ont pas été établies ici.

Exemples

const demo = document.implementation.createHTMLDocument("Document demo");
const item = demo.createElement("p");
item.id = "message";
item.textContent = "Hello, DOM";
demo.body.appendChild(item);

console.log(demo.documentElement.localName);
console.log(demo.body.localName);
console.log(demo.title);
console.log(demo.getElementById("message").textContent);
console.log(demo.getElementById("missing") === null);

Résultat

html
body
Document demo
Hello, DOM
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