CKTIS / JavaScript
`document.getElementById()` e `document.body` a confronto
Usa `getElementById()` per cercare un elemento in base al suo ID e `document.body` per accedere al corpo del documento, anche se non ha un ID.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
document.getElementById(id)
document.body
document.body = newBodydocument.getElementById(id) cerca nell’albero di quel documento e restituisce un Element oppure null. Passa il valore esatto di id, per esempio "note", non un selettore CSS come "#note". La ricerca distingue maiuscole e minuscole. Gli ID devono essere univoci; in caso di duplicati viene restituita la prima corrispondenza nell’ordine dell’albero. Gli elementi non ancora inseriti nell’albero non vengono trovati.
Leggi document.body senza parentesi. La proprietà restituisce il primo figlio diretto dell’elemento HTML radice html che sia un elemento HTML body o un elemento HTML obsoleto frameset, oppure null se non ce ne sono. document.getElementById("body") cerca l’ID body, non il tag: può restituire un altro elemento oppure null anche se document.body esiste.
Un’assegnazione a document.body può sostituire l’intero nodo del corpo e il suo sottoalbero. Se il corpo non c’è, il nuovo elemento viene aggiunto all’elemento radice del documento. Assegnare null o un elemento diverso da un elemento HTML body o frameset, oppure eseguire l’assegnazione in assenza dell’elemento radice, genera una DOMException chiamata HierarchyRequestError.
Durante l’analisi della pagina, null può indicare che il nodo non è ancora stato creato. Con HTML statico, accedi al nodo dopo l’analisi, per esempio in un gestore di DOMContentLoaded registrato prima dell’evento, e controlla comunque il risultato prima di usarlo. Queste API appartengono alla piattaforma web, non a ECMAScript 2024; un web worker standard non può accedere al document della pagina.
Esempi
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>DOM lookup example</title>
</head>
<body>
<script>
(() => {
const doc = document.implementation.createHTMLDocument("DOM demo");
const body = doc.body;
console.log(`Before setting an ID: ${doc.getElementById("body")}`);
body.id = "body";
console.log(`Same node: ${doc.getElementById("body") === body}`);
console.log(`Wrong case: ${doc.getElementById("Body")}`);
const item = doc.createElement("p");
item.id = "note";
console.log(`Before insertion: ${doc.getElementById("note")}`);
body.appendChild(item);
console.log(`After insertion: ${doc.getElementById("note") === item}`);
})();
</script>
</body>
</html>Risultato
Before setting an ID: null Same node: true Wrong case: null Before insertion: null After insertion: true
Salva l’esempio come file `.html`, aprilo in un browser e controlla i messaggi nella console. Il documento separato contiene già un elemento `body`, ma senza ID. Dopo avergli assegnato un ID, entrambe le forme di accesso restituiscono lo stesso nodo. L’elemento `p` viene trovato solo dopo l’inserimento.
Lezioni correlate
- JavaScript · Lezione 6 · Avanzato · Versione: 4