Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Window.parent, Window.self a Window.origin

Rozlišujte odkazy na aktuální a nadřazené okno od původu zapsaného jako řetězec. Samotný odkaz na okno nezaručuje přístup k jeho dokumentu.

Verze: ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

window.parent
window.self
window.origin

window.self vrací WindowProxy aktuálního kontextu prohlížení; běžně platí window.self === window. V rámci odkazuje window.parent na bezprostředně nadřazené okno, nikoli nutně na window.top. Na aktivní stránce nejvyšší úrovně odkazuje na ni samotnou. Getter parent může vrátit null, pokud jeho Window již není přidruženo k aktivnímu dokumentu navigačního kontextu.

Na aktivní stránce výraz window.parent !== window.self zjišťuje vložení do rámce, nikoli rozdílný původ, pokud nejsou zastíněny vestavěné gettery vlastností parent a self. WindowProxy si v témže kontextu prohlížení zachovává identitu i tehdy, když se při navigaci změní Window, kterému předává operace.

window.origin vrací původ globálního prostředí jako řetězec. U HTTP(S) původ určuje schéma, hostitel a port; výchozí port se v řetězci vynechává. Neprůhledný původ se serializuje jako "null", nikoli jako hodnota null. Dva takové řetězce neprokazují společný původ. location.origin naproti tomu popisuje původ adresy URL: počáteční dokument about:blank v rámci bez sandboxu může zdědit původ nadřazené stránky, i když původ jeho URL je "null".

K window.parent lze přistoupit i při různém původu, ale čtení window.parent.document nebo window.parent.origin je pak obvykle zablokováno výjimkou DOMException s názvem SecurityError. Pro předávání zpráv použijte postMessage s přesným targetOrigin, pokud lze původ příjemce určit. Při příjmu kontrolujte event.origin, očekávané event.source a formát dat. Nepovažujte samotné "null" za důkaz totožnosti odesílatele.

Jde o rozhraní webové platformy, ne o součást ECMAScriptu 2024. Web IDL označuje všechny tři vlastnosti jako readonly a [Replaceable]: přiřazení ze stejného původu může getter zastínit vlastní vlastností, ale nemění vztahy mezi okny ani bezpečnostní původ. Ve Web Workeru je self objektem WorkerGlobalScope a self.origin popisuje původ workeru; Window.parent tam není.

Příklady

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Window.parent, Window.self, and Window.origin</title>
</head>
<body>
  <script>
    (() => {
      const frame = document.createElement("iframe");
      frame.addEventListener("load", () => {
        const child = frame.contentWindow;
        console.log(JSON.stringify({
          self: child.self === child,
          parent: child.parent === window.self,
          embedded: child.parent !== child.self,
          inheritedOrigin: child.origin === window.origin,
          urlOrigin: child.location.origin
        }));
        frame.remove();
      }, { once: true });
      document.body.append(frame);
    })();
  </script>
</body>
</html>

Výsledek

{"self":true,"parent":true,"embedded":true,"inheritedOrigin":true,"urlOrigin":"null"}

Otevřete tento dokument HTML v prohlížeči jako stránku HTTPS nejvyšší úrovně bez sandboxu a bez pravidel blokujících vložený skript nebo prázdný rámec. Rámec zdědí původ stránky, ale původ jeho URL `about:blank` je `"null"`. Řádek JSON se v konzoli prohlížeče vypíše po události `load`.

Související lekce

  • JavaScript · Lekce 5 · Pokročilá · Verze: 4

Zdroje