CKTIS / JavaScript
Vyhledání prvku podle ID a kontrola stavu dokumentu
`getElementById()` zjišťuje, zda je prvek právě ve stromu dokumentu. `readyState` označuje fázi načítání, nikoli přítomnost konkrétního prvku.
Verze: Current web platform; runtime support varies
Syntaxe
document.getElementById(id); // Element | null
document.readyState; // "loading" | "interactive" | "complete"document.getElementById(id) prohledává aktuální strom daného dokumentu. Zadej přesnou hodnotu id, včetně správné velikosti písmen, a nepřidávej předponu # používanou v selektorech CSS. Metoda vrátí Element nebo null. Při duplicitních ID vrátí první odpovídající prvek v pořadí stromu, ale ID mají být v dokumentu HTML jedinečná. Výsledek nejdřív zkontroluj: čtení vlastnosti hodnoty null vyvolá TypeError.
document.readyState je vlastnost pouze pro čtení, nikoli metoda. Při běžném načítání stránky "loading" znamená, že zpracování dokumentu parserem probíhá, a "interactive", že skončilo. Stav "complete" nastane, když jsou načtené zdroje, které zdržují událost load na objektu window, těsně před touto událostí. Změna stavu vyvolá na dokumentu událost readystatechange. DOMContentLoaded nastane po přechodu do "interactive", po provedení klasických skriptů s defer a poté, co prohlížeč zahájí vyhodnocování modulových skriptů bez async, které se mají spustit po zpracování dokumentu parserem. Událost nezaručuje, že kód za await na nejvyšší úrovni modulu už proběhl. Nečeká přímo na obrázky.
Pokud inicializace potřebuje jen DOM vytvořený parserem, při document.readyState === "loading" na dokumentu zaregistruj obsluhu DOMContentLoaded s volbou { once: true }; jinak inicializaci spusť hned. "interactive" nezaručuje, že DOMContentLoaded už nastala. I při "complete" může hledání vrátit null, například pokud aplikace vloží prvek až později. Standard DOM definuje getElementById() a standard HTML definuje readyState. Obojí patří do webových API, ne do ECMAScriptu; prostředí bez DOMu prohlížeče je nemusí poskytovat.
Příklady
<!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>Výsledek
complete true true true
Ulož příklad jako soubor HTML, otevři ho v prohlížeči a zkontroluj výstup v konzoli. Nový dokument už má stav `complete`, ale `status` lze najít až po vložení prvku. `Status` se ani potom neshoduje.
Související lekce
- JavaScript · Lekce 39 · Středně pokročilá · Verze: 3