Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

HTMLAnchorElement: endereço href e destino target

HTMLAnchorElement representa uma hiperligação no DOM do browser. A propriedade href indica o endereço do recurso, enquanto target escolhe o contexto de navegação em que este será aberto. Saiba em que difere a propriedade href do atributo e o que significa _blank.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

const anchor = document.createElement("a");
anchor.href = "https://example.com/guide";
anchor.target = "_blank";
anchor.rel = "noopener";

HTMLAnchorElement é a interface DOM do elemento de hiperligação a e herda de HTMLElement. Duas propriedades da hiperligação determinam, separadamente, para onde esta aponta (href) e onde deve ser apresentado o recurso (target). Trata-se de uma Web API do browser, não de uma parte do ECMAScript; a versão de Node.js do repositório não comprova a sua disponibilidade.

Definir anchor.href atualiza o atributo href. Ao ler, um endereço relativo válido é resolvido com base no URL base do documento, enquanto anchor.getAttribute("href") devolve o texto guardado no atributo sem essa transformação. Se o atributo não existir, anchor.href devolve uma cadeia vazia. Se existir mas estiver vazio, o seu valor é resolvido em relação ao URL base do documento. Quando o URL base é hierárquico, o resultado não inclui o fragmento que esse URL possa conter. Quando o URL base é opaco, como um URL data:, a resolução pode falhar; nesse caso, anchor.href também devolve uma cadeia vazia. Um URL inválido pode ser devolvido sem alterações: ler href não é uma validação de segurança.

anchor.target reflete o atributo target. _self seleciona o contexto atual, _blank um novo, _parent o contexto ascendente e _top o contexto mais elevado. Se não existir o ascendente relevante, _parent e _top comportam-se como _self. O valor também pode identificar um contexto com nome. _blank não garante que se abra um separador em vez de uma janela; essa escolha depende das definições do browser.

Para _blank, pode definir explicitamente anchor.rel = "noopener" para impedir o acesso através de window.opener; os browsers modernos também o fazem implicitamente para _blank. O texto visível da hiperligação deve avisar de que será aberto um novo separador ou janela. Atribuir propriedades, por si só, não inicia a navegação. A MDN assinala href e target como amplamente disponíveis desde julho de 2015; isso não significa que todas as funcionalidades de HTMLAnchorElement tenham o mesmo suporte.

Exemplos

const anchor = document.createElement("a");
anchor.href = "https://example.com/guide";
anchor.target = "_blank";
anchor.rel = "noopener";

console.log(anchor.href);
console.log(anchor.getAttribute("href"));
console.log(anchor.target);

Resultado

https://example.com/guide
https://example.com/guide
_blank

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes