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.

Resumo

A propriedade somente leitura Node.baseURI retorna a URL base absoluta de um nó.

A URL base é usada para resolver URLs relativas quando o navegador precisa obter uma URL absoluta, por exemplo, quando processa o atributo src do elemento HTML <img> ou o atributo xlink:href do XML.

No caso comum, a URL base é simplesmente a localização do documento, mas ela pode ser afetada por vários fatores, incluindo o elemento <base> em HTML e o atributo xml:base em XML.

Sintaxe

var baseURI = node.baseURI;
  • baseURI é uma DOMString que representa a URL base do Node especificado. Pode ser null caso não consiga obter uma URL absoluta.
  • node.baseURI é somente leitura.
  • node.baseURI pode mudar com o tempo (ver abaixo).

Detalhes

A URL base de um documento

É a URL base de um documento padrão ao endereço do documento ( como exibido pelo navegador e disponível em window.location ), mas pode mudar o padrão:

  • Quando uma tag HTML <base> é encontrada no documento;
  • Quando esse é um novo documento creado dinamicamente.

Veja a seção URLs base do padrão HTML para mais detalhes.

Você pode usar document.baseURI para obter a URL base de um documento. Note que a obtenção da URL base para um documento pode retornar diferentes URLs ao longo do tempo se as tags <base> ou a localização do documento mudarem.

A URL base de um elemento

A URL base de um elemento em HTML é, normalmente, igual a URL base do documento onde o nó está.

Se o documento contém atributos xml:base ( que você não deve fazer em documento HTML), o element.baseURI recebe os atributos xml:base dos elementos pai into account when computing the base URL. Veja xml:base para mais detalhes.

Você pode usar element.baseURI para obter a URL base de um elemento.

Especificações

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

Compatibilidade com navegadores

BCD tables only load in the browser

Ver também

  • Elemento <base> (HTML)
  • Atributo xml:base (Documentos XML)
  • Node.baseURIObject – uma variante desta API para complementos da Mozilla e código interno. Retorna a URL base como uma nsIURI