Esta tradução está incompleta. Ajude atraduzir este artigo.
A propriedade somente-leitura Node.baseURI
retorna a URLbase absoluta de um nó.
A URLbase é usada para resolver URLs relativas quando o navegador precisa obter uma URL absoluta, por exemplo, quando processa o atributo <img>
do elemento HTML 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 varios fatores, incluindo o o elemento <base>
em HTMl e o atributo xml:base em XML.
Sintaxe
var baseURI = node.baseURI;
baseURI
é umaDOMString
que representa a URL base doNode
espefíficado. Pode ser nulo se não for possível obter uma URL absoluta.node.baseURI
é somente-leitura.node.baseURI
pode mudar com o tempo(veja 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
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 document
.baseURI<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
para obter a URL base de um elemento.element
.baseURI
Specificação
Veja também
- Elemento
<base>
(HTML) Atributo xml:base
( Documentos XML).Node.baseURIObject
- Uma variante desta API para Mozilla add-ons e código interno. Retorna a URL base como umansIURI
.