CKTIS / JavaScript
Document.documentElement — l’elemento radice del documento
Document.documentElement restituisce l’elemento radice del documento oppure null. La proprietà è di sola lettura, ma l’elemento stesso può essere modificato.
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.documentElementLeggi Document.documentElement su un’istanza di Document, ad esempio con document.documentElement. Restituisce l’Element il cui genitore è il documento, oppure null se non esiste un elemento di questo tipo. Un documento può avere al massimo un elemento simile.
Il parser HTML crea normalmente un elemento html come radice del documento, ma il DOM non impone quel nome di tag. Se sostituisci la radice con un altro elemento, ad esempio body, la proprietà restituisce il nuovo elemento. In XML il nome dipende dal documento. Non confondere questa proprietà con firstChild, che può invece fare riferimento, per esempio, a una dichiarazione del tipo di documento.
Il fatto che la proprietà sia di sola lettura non significa che l’elemento restituito sia immutabile. L’esempio rimuove la radice di un documento XML separato; la lettura successiva restituisce null. Questa è un’API DOM, non una funzionalità del linguaggio ECMAScript.
Esempi
const doc = document.implementation.createDocument(null, "root");
console.log(doc.documentElement.localName);
doc.documentElement.remove();
console.log(doc.documentElement);Risultato
root null
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.