Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Wyszukiwanie elementu po ID a stan ładowania dokumentu

`getElementById()` sprawdza, czy element jest już w drzewie dokumentu, a `readyState` określa etap ładowania. Koniec parsowania nie gwarantuje znalezienia elementu.

Wersja: Current web platform; runtime support varies

Składnia

document.getElementById(id); // Element | null
document.readyState; // "loading" | "interactive" | "complete"

document.getElementById(id) przeszukuje bieżące drzewo danego dokumentu. Podaj dokładną wartość id z uwzględnieniem wielkości liter, bez dodawania # jak w selektorze CSS. Metoda zwraca Element albo null. Jeśli identyfikator się powtarza, zwraca pierwszy pasujący element w kolejności drzewa, ale w dokumencie HTML identyfikatory powinny być unikatowe. Sprawdź wynik przed użyciem: odczyt właściwości z null powoduje TypeError.

document.readyState to właściwość tylko do odczytu, a nie metoda. Podczas zwykłego ładowania strony "loading" oznacza trwające parsowanie, "interactive" — zakończone parsowanie, a "complete" — koniec ładowania zasobów, na które czeka zdarzenie load obiektu window, tuż przed jego wywołaniem. Zmiana wartości wywołuje readystatechange na dokumencie. DOMContentLoaded następuje po przejściu do "interactive", po wykonaniu klasycznych skryptów z defer i po tym, jak przeglądarka zainicjuje wykonywanie skryptów modułowych bez async przewidzianych do uruchomienia po parsowaniu. Zdarzenie nie gwarantuje, że kod po await na najwyższym poziomie modułu już się wykonał. Nie czeka bezpośrednio na obrazy.

Jeśli inicjalizacja wymaga tylko sparsowanego DOM-u, przy document.readyState === "loading" zarejestruj na dokumencie obsługę DOMContentLoaded z opcją { once: true }; w przeciwnym razie uruchom inicjalizację od razu. "interactive" nie gwarantuje, że DOMContentLoaded już wystąpiło. Nawet przy "complete" wyszukiwanie może zwrócić null, na przykład gdy aplikacja wstawi element dopiero później. Standard DOM definiuje getElementById(), a standard HTML definiuje readyState. Są to API platformy WWW, a nie elementy ECMAScriptu; środowisko bez DOM-u przeglądarki może ich nie udostępniać.

Przykłady

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Document readiness and ID lookup</title>
</head>
<body>
  <script>
    const doc = document.implementation.createHTMLDocument();
    const item = doc.createElement("p");
    item.id = "status";

    console.log(doc.readyState);
    console.log(doc.getElementById("status") === null);
    doc.body.append(item);
    console.log(doc.getElementById("status") === item);
    console.log(doc.getElementById("Status") === null);
  </script>
</body>
</html>

Wynik

complete
true
true
true

Zapisz przykład jako plik HTML, otwórz go w przeglądarce i sprawdź wynik w konsoli. Nowy dokument ma stan `complete`, ale element o ID `status` można znaleźć dopiero po wstawieniu go do drzewa; `Status` nadal nie pasuje.

Powiązane lekcje

  • JavaScript · Lekcja 39 · Średniozaawansowany · Wersja: 3

Źródła