Atributo links do Documento DOM HTML

Definição e uso

links A propriedade retorna a coleção de todos os links do documento.

links a propriedade retorna HTMLCollection.

links a propriedade é de leitura.

os links na coleção representam os elementos <a> e <area> que possuem a propriedade href.

veja também:

Objeto Anchor do DOM HTML

Objeto Area do DOM HTML

Tag <a> do HTML

Tag <area> do HTML

Link do HTML

HTMLCollection

HTMLCollection é uma coleção semelhante a uma lista de elementos HTML.

os elementos podem ser acessados por índice na coleção (começando em 0).

length a propriedade retorna o número de elementos na coleção.

instância

exemplo 1

retornar o número de links no documento:

let numb = document.links.length;

experimente você mesmo

exemplo 2

obter a URL da primeira link do documento:

let url = document.links[0].href;

experimente você mesmo

exemplo 3

obter a URL da primeira link do documento:

let url = document.links.item(0).href;

experimente você mesmo

exemplo 4

obter a URL do elemento com id="myLink":

let url = document.links.namedItem("myLink").href;

experimente você mesmo

exemplo 5

adicionar uma borda vermelha à primeira link do documento:

document.links[0].style.border = "5px solid red";

experimente você mesmo

exemplo 6

percorrer todos os links e exibir a URL de cada link (href):

const links = document.links;
let text = "";
for (let i = 0; i < links.length; i++) {
  text += links[i].href + "<br>";
}

experimente você mesmo

sintaxe

document.links

propriedade

propriedade descrição
length número de elementos na coleção.

método

método descrição
[índice)

retorna o elemento com o índice especificado (começando em 0).

se o índice estiver fora do escopo, retorna null.
item(índice)

retorna o elemento com o índice especificado (começando em 0).

se o índice estiver fora do escopo, retorna null.
namedItem(id)

retorna com id do elemento.

se id não existe, retorna null.

retorno

tipo descrição
objeto

objeto HTMLCollection.

todos os elementos <a> e <area> no documento.

ordenados pela ordem em que aparecem no código-fonte.

suporte do navegador

document.links é uma característica do DOM Level 1 (1998).

Todos os navegadores suportam-o:

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
suporte 9-11 suporte suporte suporte suporte