Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.documentElement

Leggi 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.

Fonti