CKTIS / JavaScript
Window — kontekst strony w przeglądarce
Window udostępnia stronie interfejsy przeglądarki: informacje o pikselach, relacje między oknami oraz zdarzenia rozmiaru i nawigacji. Poznaj różnicę między Window a WindowProxy oraz ograniczenia dostępu między originami.
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
window.devicePixelRatio; window.self; window.parent; window.origin; window.addEventListener("resize", handler); window.addEventListener("popstate", handler); window.addEventListener("hashchange", handler);Window jest globalnym obiektem dokumentu w przeglądarce, a nie częścią samego ECMAScript. Dostęp przez window odbywa się przez WindowProxy, który przekazuje operacje do aktualnego Window. Te interfejsy nie są dostępne w workerach jako window; obecność Node 24 w repozytorium nie dowodzi obsługi przeglądarkowej.
Window.self (window.self) wskazuje ten sam WindowProxy co window. Window.parent wskazuje okno rodzica ramki; w dokumencie najwyższego poziomu wskazuje samo okno. Możliwość uzyskania referencji do rodzica nie daje prawa do czytania jego DOM: dostęp między różnymi originami jest ograniczony. Window.origin zwraca tekstową serializację originu środowiska globalnego, zwykle schemat, host i ewentualny port; origin nieprzezroczysty daje ciąg "null", nie wartość null. Nie jest to pełny URL ani sekret uwierzytelniający.
Window.devicePixelRatio to stosunek rozmiaru piksela CSS do rozmiaru piksela urządzenia, przydatny np. przy skalowaniu bitmapy canvas. Nie zakładaj wartości 1 ani liczby całkowitej: wynik zależy od środowiska wyświetlania i powiększenia strony. Szczegóły tej właściwości określa CSSOM View, nie ECMAScript.
Window.resize, Window.popstate i Window.hashchange oznaczają zdarzenia, a nie metody. Rejestruj je przez addEventListener; odpowiadają im też onresize, onpopstate i onhashchange. resize sygnalizuje zmianę rozmiaru viewportu. popstate towarzyszy określonym zmianom aktywnego wpisu historii, np. przy Wstecz/Dalej; event.state udostępnia stan wpisu. hashchange sygnalizuje zmianę fragmentu URL i udostępnia oldURL oraz newURL. Same wywołania history.pushState() i history.replaceState() nie emitują żadnego z tych dwóch zdarzeń nawigacji, nawet gdy zmieniają fragment.
Przykład deterministycznie sprawdza self oraz rejestrację trzech nasłuchiwaczy. Syntetyczny Event nie zmienia rozmiaru okna, URL ani historii i nie zawiera pól właściwych dla PopStateEvent lub HashChangeEvent. isTrusted ma wartość false; przykład nie testuje rzeczywistej nawigacji.
Przykłady
(() => {
console.log(`self: ${window.self === window}`);
for (const type of ["resize", "popstate", "hashchange"]) {
window.addEventListener(type, (event) => {
console.log(`${event.type}: ${event.isTrusted}`);
}, { once: true });
window.dispatchEvent(new Event(type));
}
})();Wynik
self: true resize: false popstate: false hashchange: false
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.
Źródła
- HTML Standard
- HTML Standard — APIs related to navigation and session history
- HTML Standard — Web application APIs
- HTML Standard — Loading web pages
- HTML Standard — Images
- HTML Standard — Browsers
- Official reference — developer.mozilla.org: Window / devicePixelRatio
- Official reference — developer.mozilla.org: Window / resize_event
- Official reference — developer.mozilla.org: Window / popstate_event
- Official reference — developer.mozilla.org: API / Window