Esta tradução está incompleta. Por favor, ajude a traduzir este artigo.

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ção

Especificação Status Comentário
DOM
The definition of 'baseURI' in that specification.
Padrão em tempo real  
Document Object Model (DOM) Level 3 Core Specification
The definition of 'baseURI' in that specification.
Obsoleto Introduzida

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

Etiquetas do documento e colaboradores

Colaboradores desta página: cammarin, Josue-Bastos
Última atualização por: cammarin,