Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Document — dostęp do dokumentu strony

Document reprezentuje dokument DOM. Obiekt document pozwala wyszukiwać elementy, odczytywać korzeń dokumentu oraz korzystać z właściwości strony dotyczących tytułu, fokusu i widoczności. To interfejs platformy WWW, a nie część samego ECMAScript.

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

Składnia

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

Document reprezentuje dokument DOM; w skrypcie strony document odnosi się do bieżącego dokumentu. Nie jest tym samym co window ani element główny. To interfejs platformy WWW: sama dostępność JavaScript, także w Node 24, nie dowodzi jego obsługi.

Document.getElementById(id) zwraca pierwszy pasujący element w kolejności drzewa albo null; przekazuj identyfikator bez # i sprawdzaj wynik przed użyciem. Document.documentElement wskazuje element główny lub ma wartość null. W typowej stronie HTML jest to element html. Document.body udostępnia element body albo frameset, ale może być null, np. zanim parser go utworzy. Document.title pozwala odczytać lub zmienić tytuł dokumentu.

Document.activeElement wskazuje element związany z fokusem; nie musi to być pole tekstowe. Przy fokusie wewnątrz osadzonego dokumentu lub drzewa cienia może wskazywać odpowiednio element osadzający lub host, zamiast najgłębszego elementu. Document.hidden to wartość logiczna opisująca ukrycie dokumentu, a nie brak fokusu. Document.visibilitychange oznacza zdarzenie visibilitychange, nie metodę: obsługuj je przez document.addEventListener("visibilitychange", handler) i odczytuj document.hidden w procedurze obsługi.

Przykład tworzy oddzielny dokument HTML, więc nie zmienia otwartej strony i daje przewidywalne wartości. Nie testuje fokusu ani widoczności, które zależą od środowiska. Zakres źródła jest ograniczony: podany DOM Standard definiuje rdzeń Document, lecz nie definiuje wszystkich wymienionych rozszerzeń HTML dotyczących tytułu, treści, fokusu i widoczności. Nie ustalono tu minimalnych wersji przeglądarek.

Przykłady

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

Wynik

html
body
Document demo
Hello, DOM
true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła