CKTIS / JavaScript
Document — aceder ao documento de uma página
Document representa um documento DOM. O objeto document permite encontrar elementos, ler a raiz do documento e utilizar propriedades da página relacionadas com o título, o foco e a visibilidade. É uma interface da plataforma Web, não uma parte do próprio ECMAScript.
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
document.getElementById(id)
document.documentElement
document.body
document.title
document.activeElement
document.hidden
document.addEventListener("visibilitychange", handler)Document representa um documento DOM; num script de página, document refere-se ao documento atual. Não é window nem o elemento raiz. É uma interface da plataforma Web: a disponibilidade de JavaScript, por si só, incluindo no Node 24, não demonstra que esta interface seja suportada.
Document.getElementById(id) devolve o primeiro elemento correspondente pela ordem da árvore, ou null. Passa o identificador sem # e verifica o resultado antes de o utilizar. Document.documentElement identifica o elemento raiz ou é null. Numa página HTML típica, é o elemento html. Document.body disponibiliza o elemento body ou frameset, mas pode ser null, por exemplo, antes de o analisador o criar. Document.title permite ler ou alterar o título do documento.
Document.activeElement identifica o elemento associado ao foco; não tem de ser um campo de texto. Quando o foco está dentro de um documento incorporado ou de uma árvore shadow, pode identificar o elemento que o incorpora ou o anfitrião, respetivamente, em vez do elemento mais profundo. Document.hidden é um valor booleano que indica se o documento está oculto, não se está sem foco. Document.visibilitychange designa o evento visibilitychange, não um método: trata-o com document.addEventListener("visibilitychange", handler) e lê document.hidden no controlador.
O exemplo cria um documento HTML separado, pelo que não altera a página aberta e produz valores previsíveis. Não testa o foco nem a visibilidade, que dependem do ambiente. A cobertura das fontes é limitada: o DOM Standard fornecido define o núcleo de Document, mas não define todas as extensões HTML enumeradas relativas ao título, ao corpo, ao foco e à visibilidade. Não foram estabelecidas aqui versões mínimas dos browsers.
Exemplos
const demo = document.implementation.createHTMLDocument("Document demo");
const item = demo.createElement("p");
item.id = "message";
item.textContent = "Hello, DOM";
demo.body.appendChild(item);
console.log(demo.documentElement.localName);
console.log(demo.body.localName);
console.log(demo.title);
console.log(demo.getElementById("message").textContent);
console.log(demo.getElementById("missing") === null);Resultado
html body Document demo Hello, DOM true
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.