Document

Baseline

Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.

* Certaines parties de cette fonctionnalité peuvent bénéficier de prise en charge variables.

Voir la compatibilité complète
En savoir plus

L'interface Document représente n'importe quelle page web chargée dans le navigateur et sert de point d'entrée pour accéder au contenu de la page qui est formé par l'arbre du DOM.

L'arbre du DOM inclut les éléments tels que <body>, <table> et tous les autres présents dans la page. Il fournit des fonctionnalités à l'ensemble du document et permet, par exemple, d'obtenir l'URL de la page et de créer de nouveaux éléments dans le document.

L'interface Document décrit les propriétés et méthodes communes à toutes sortes de documents. Selon le type de document (par exemple HTML, XML, SVG, …), une API plus grande peut être disponible : les documents HTML, servis avec le type de contenu "text/html" implémentent également l'interface HTMLDocument tandis que les documents XML et SVG implémentent l'interface XMLDocument.

Constructeur

Document(): Crée un nouvel objet Document.

Propriétés d'instance

Cette interface hérite également des interfaces Node et EventTarget.

Document.activeElement Lecture seule: Retourne l'objet Element correspondant à l'élément qui possède la sélection.
Document.adoptedStyleSheets: Ajoute un tableau de feuilles de style construites à utiliser par le document. Ces feuilles de style peuvent aussi être partagées avec les sous-arbres DOM d'ombre (shadow DOM) du même document.
Document.body: Retourne le nœud <body> ou <frameset> du document courant.
Document.characterSet Lecture seule: Retourne le jeu de caractères utilisé par le document.
Document.childElementCount Lecture seule: Retourne le nombre d'éléments enfants pour le document courant.
Document.children Lecture seule: Retourne les éléments enfants pour le document courant.
Document.compatMode Lecture seule: Indique si le document est rendu à l'écran selon le mode quirks ou strict.
Document.contentType Lecture seule: Retourne le type MIME du document courant.
Document.currentScript Lecture seule: Retourne l'élément <script> dont le script est actuellement en cours de traitement et qui n'est pas un module JavaScript ^(angl.).
Document.customElementRegistry Lecture seule: L'objet CustomElementRegistry associé à ce document, ou null si aucun n'a été défini.
Document.doctype Lecture seule: Retourne la définition du type de document (Document Type Definition ou DTD) du document courant.
Document.documentElement Lecture seule: Retourne l'objet Element correspondant à l'élément qui est un enfant direct du document. Pour les documents HTML, il s'agit normalement d'un objet HTMLHtmlElement qui représente l'élément <html> du document.
Document.documentURI Lecture seule: Retourne l'emplacement du document sous la forme d'une chaîne de caractères.
Document.embeds Lecture seule: Retourne un objet HTMLCollection des éléments embarqués (avec <embed>) dans le document.
Document.featurePolicy Lecture seule: Retourne l'interface FeaturePolicy avec les politiques de fonctionnalités appliquées au document.
Document.firstElementChild Lecture seule: Retourne le premier élément enfant du document courant.
Document.fonts: Retourne l'interface FontFaceSet pour le document courant.
Document.forms Lecture seule: Retourne un objet HTMLCollection des éléments <form> du document.
Document.fragmentDirective Lecture seule: Retourne l'objet FragmentDirective pour le document courant.
Document.fullscreenElement Lecture seule: Retourne l'élément actuellement en mode plein écran pour ce document.
Document.head Lecture seule: Retourne l'élément <head> pour le document courant.
Document.hidden Lecture seule: Retourne une valeur booléenne qui indique si la page est considérée masquée ou non.
Document.images Lecture seule: Retourne un objet HTMLCollection des images du document.
Document.implementation Lecture seule: Retourne l'implémentation du DOM associée au document courant.
Document.lastElementChild Lecture seule: Retourne le dernier élément enfant du document courant.
Document.links Lecture seule: Retourne un objet HTMLCollection contenant l'ensemble des hyperliens du document.
Document.pictureInPictureElement Lecture seule: Retourne l'objet Element pour l'élément affiché en mode d'incrustation vidéo (picture-in-picture) pour ce document.
Document.pictureInPictureEnabled Lecture seule: Retourne true si la fonctionnalité d'incrustation vidéo est activée.
Document.plugins Lecture seule: Retourne un objet HTMLCollection contenant les plugins disponibles.
Document.pointerLockElement Lecture seule: Retourne l'élément définit comme cible pour les évènements de souris pendant que le pointeur est verrouillé. Cette propriété vaut null si le verrouillage est en cours, si le pointeur est déverrouillé ou si la cible est située dans un autre document.
Document.prerendering Lecture seule: Retourne un booléen indiquant si le document est en cours de pré-rendu, lorsqu'un pré-rendu est initié avec l'API Speculation Rules.
Document.scripts Lecture seule: Retourne un objet HTMLCollection contenant les éléments <script> du document.
Document.scrollingElement Lecture seule: Retourne une référence à l'objet Element correspondant à l'élément qui fait défiler le document. Document.styleSheets Lecture seule; Retourne un objet StyleSheetList contenant les objets CSSStyleSheet pour les feuilles de style CSS liées explicitement ou embarquées dans le document.
Document.timeline Lecture seule: Retourne la chronologie, sous la forme d'une instance DocumentTimeline, qui est automatiquement créée au chargement de la page.
Document.visibilityState Lecture seule: Retourne une chaîne de caractères qui indique l'état de visibilité du document. Les valeurs possibles sont visible, hidden, prerender, et unloaded.

Extensions pour `HTMLDocument`

L'interface Document pour les documents HTML hérite de l'interface HTMLDocument ou est étendue pour ces documents.

Document.cookie

Retourne une liste, dont les éléments sont séparés par des points-virgules, des cookies du document ou permet de définir un cookie.

Document.defaultView Lecture seule

Retourne une référence à l'objet de la fenêtre.

Document.designMode

Permet d'accéder ou de définir la possibilité d'éditer l'ensemble du document.

Document.dir

Permet d'accéder ou de définir la directionnalité (écriture de droite à gauche ou de gauche à droite) du document.

Document.fullscreenEnabled Lecture seule

Indique si le mode plein écran est disponible.

Document.lastModified Lecture seule

Retourne la date à laquelle le document a été modifié pour la dernière fois.

Document.location Lecture seule

Retourne l'URI du document courant.

Document.readyState Lecture seule

Retourne l'état de chargement du document.

Document.referrer Lecture seule

Retourne l'URI de la page qui a lié vers cette page.

Document.title

Permet d'accéder ou de définir le titre du document courant.

Document.URL Lecture seule

Retourne l'emplacement du document sous la forme d'une chaîne de caractères. Propriétés nommées

Certains éléments du document sont également exposés comme propriétés :

Pour chaque élément HTML <embed>, <form>, <iframe>, <img> et <object>, sa propriété name (si elle n'est pas vide) est exposée. Par exemple, si le document contient <form name="my_form">, alors document["my_form"] (et son équivalent document.my_form) retourne une référence vers cet élément.
Pour chaque élément HTML <object>, sa propriété id (si elle n'est pas vide) est exposée.
Pour chaque élément HTML <img> avec un name non vide, sa propriété id (si elle n'est pas vide) est exposée.

Si une propriété correspond à un seul élément, cet élément est directement retourné. Si cet élément unique est une iframe, alors sa propriété contentWindow est retournée à la place. Si la propriété correspond à plusieurs éléments, alors un objet HTMLCollection contenant tous ces éléments est retourné.

Propriétés dépréciées

Document.alinkColor: Retourne ou définit la couleur des liens actifs dans le corps du document.
Document.all: Donne accès à tous les éléments du document — retourne un objet HTMLAllCollection enraciné sur le nœud document. Propriété héritée, non standard, à ne pas utiliser.
Document.anchors Lecture seule: Retourne la liste de toutes les ancres du document.
Document.applets Lecture seule: Retourne un objet HTMLCollection vide. Propriété héritée qui retournait la liste des applets du document.
Document.bgColor: Obtient ou définit la couleur d'arrière-plan du document courant.
Document.charset Lecture seule: Alias de Document.characterSet. Utilisez cette propriété à la place.
Document.domain: Obtient ou définit le domaine du document courant.
Document.fgColor: Obtient ou définit la couleur de premier plan, ou couleur du texte, du document courant.
Document.fullscreen: Retourne true lorsque le document est en mode plein écran.

Document

Constructeur

Propriétés d'instance

Extensions pour HTMLDocument

Propriétés dépréciées

Extensions pour `HTMLDocument`