Node.baseURI

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

La propriété en lecture seule Node.baseURI renvoie l'URL de base absolue d'un noeud.

L'URL de base est utilisée pour résoudre les URL relatives quand le navigateur a besoin d'obtenir une URL absolue, par exemple lors du traitement de l'attribut src en HTML ou XML xlink:href d'un élément <img> HTML.

En général, l'URL de base est simplement l'emplacement du document, mais elle peut être affectée par de nombreux facteurs, y compris l'élément <base> en HTML et l'attribut xml:base en XML.

Syntaxe

js
var baseURI = node.baseURI;
  • baseURI est une DOMString (chaîne de caractères) représentant l'URL de base du Node spécifié. Elle peut être null s'il est impossible d'obtenir une URI absolue.
  • node.baseURI est en lecture seule.
  • node.baseURI peut changer avec le temps (voir ci-dessous).

Détails

L'URL de base d'un document

L'URL de base d'un document est par défaut l'adresse du document (telle qu'affichée par le navigateur et disponible dans window.location), mais peut changer par défaut :

  • Si une balise HTML <base> est trouvée dans le document ;
  • Lorsque celui-ci est un nouveau document créé dynamiquement.

Voir la page Base URLs section of the HTML Living standard (en) pour plus de détails.

Vous pouvez utiliser document.baseURI pour obtenir l'URL de base d'un document. Notez que l'obtention de l'URL de base d'un document peut renvoyer des URL différentes au fil du temps si la balise <base> ou l'emplacement du document change.

L'URL de base d'un élément

L'URL de base d'un element en HTML est normalement équivalente à celle du document dans lequel se trouve le noeud.

Si le document contient des attributs xml:base (ce que vous ne devriez pas faire dans les documents HTML), l'element.baseURI prend en compte l'attribut xml:base des parents de l'élément lors du calcul de l'URL de base. Voir xml:base pour plus de détails.

Vous pouvez utiliser element.baseURI pour obtenir l'URL de base d'un élément.

Spécifications

Specification
DOM Standard
# ref-for-dom-node-baseuri①

Voir aussi

  • l'élément <base> (HTML)
  • l'attribut xml:base (documents XML).
  • Node.baseURIObject - une variante de cette API pour les add-ons Mozilla et le code interne. Renvoie l'URL de base en tant que nsIURI.