Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Document — accedere al documento di una pagina

Document rappresenta un documento DOM. L’oggetto document consente di trovare elementi, leggere la radice del documento e usare proprietà della pagina relative a titolo, focus e visibilità. È un’interfaccia della piattaforma web, non una parte di ECMAScript stesso.

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

Sintassi

document.getElementById(id)
document.documentElement
document.body
document.title
document.activeElement
document.hidden
document.addEventListener("visibilitychange", handler)

Document rappresenta un documento DOM; in uno script di pagina, document fa riferimento al documento corrente. Non è né window né l’elemento radice. È un’interfaccia della piattaforma web: la sola disponibilità di JavaScript, anche in Node 24, non dimostra che sia supportata.

Document.getElementById(id) restituisce il primo elemento corrispondente nell’ordine dell’albero oppure null. Passa l’identificatore senza # e controlla il risultato prima di usarlo. Document.documentElement identifica l’elemento radice oppure vale null. In una tipica pagina HTML, è l’elemento html. Document.body fornisce l’elemento body o frameset, ma può valere null, per esempio prima che il parser lo crei. Document.title consente di leggere o modificare il titolo del documento.

Document.activeElement identifica l’elemento associato al focus; non deve necessariamente essere un campo di testo. Quando il focus si trova all’interno di un documento incorporato o di un albero shadow, può identificare rispettivamente l’elemento contenitore o l’host anziché l’elemento più profondo. Document.hidden è un valore booleano che descrive se il documento è nascosto, non se è privo di focus. Document.visibilitychange indica l’evento visibilitychange, non un metodo: gestiscilo con document.addEventListener("visibilitychange", handler) e leggi document.hidden nel gestore.

L’esempio crea un documento HTML separato, quindi non modifica la pagina aperta e produce valori prevedibili. Non verifica il focus né la visibilità, che dipendono dall’ambiente. La copertura delle fonti è limitata: il DOM Standard fornito definisce il nucleo di Document, ma non tutte le estensioni HTML elencate relative a titolo, corpo, focus e visibilità. Qui non sono state stabilite le versioni minime dei browser.

Esempi

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);

Risultato

html
body
Document demo
Hello, DOM
true

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti