CKTIS / JavaScript
Document.body — accedere all’elemento body del documento
Document.body è una proprietà della Web API accessibile come document.body. Restituisce un elemento body, un elemento frameset legacy oppure null. L’assegnazione sostituisce l’intero elemento, non solo il suo contenuto.
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.body
document.body = newBodyDocument.body è una proprietà dell’interfaccia Document, accessibile come document.body. Restituisce il primo figlio diretto dell’elemento radice del documento che sia un elemento body o frameset nello spazio dei nomi HTML. Se non c’è alcun figlio con queste caratteristiche, restituisce null. L’elemento radice non deve necessariamente essere un elemento html. Non restituisce testo né una copia dell’elemento.
Prima di usare il risultato, considera la possibilità che sia null, per esempio quando il parser non ha ancora creato l’elemento body. Questa è una Web API definita dall’HTML Standard, non una funzionalità di ECMAScript in sé. La versione di Node nel repository non dimostra che questa API del browser sia disponibile.
L’assegnazione document.body = newBody sostituisce l’elemento esistente e il relativo sottoalbero; non copia il contenuto precedente. Assegnare lo stesso elemento non comporta modifiche. Se manca l’elemento body, quello nuovo viene aggiunto all’elemento radice. Se manca l’elemento radice, oppure si assegna null o un elemento div, viene generata una DOMException HierarchyRequestError: sono accettati gli elementi body e frameset.
L’esempio opera su un documento separato. Mostra la sostituzione dell’elemento e il distacco di quello precedente senza modificare la pagina visualizzata.
Esempi
const doc = document.implementation.createHTMLDocument("");
const original = doc.body;
original.textContent = "Before";
const replacement = doc.createElement("body");
replacement.textContent = "After";
doc.body = replacement;
console.log(doc.body === replacement);
console.log(doc.body.textContent);
console.log(original.parentNode === null);Risultato
true After 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.