WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Window.parent, Window.self und Window.origin

Unterscheide Verweise auf das aktuelle und das übergeordnete Fenster vom Origin als Zeichenkette. Ein Fensterverweis allein erlaubt noch keinen Zugriff auf das Dokument.

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

Syntax

window.parent
window.self
window.origin

window.self gibt den WindowProxy des aktuellen Browsing-Kontexts zurück; normalerweise gilt window.self === window. In einem Frame verweist window.parent auf das direkt übergeordnete Fenster, nicht unbedingt auf window.top. Auf einer aktiven Seite der obersten Ebene verweist es auf diese Seite selbst. Der Getter parent kann null zurückgeben, wenn sein Window nicht mehr dem aktiven Dokument eines Navigationskontexts zugeordnet ist.

Auf einer aktiven Seite erkennt window.parent !== window.self eine Einbettung, keinen Origin-Unterschied, sofern die nativen Getter von parent und self nicht verdeckt sind. Ein WindowProxy behält im selben Browsing-Kontext seine Identität, auch wenn eine Navigation das Window wechselt, an das er Operationen weiterleitet.

window.origin gibt den Origin der globalen Umgebung als Zeichenkette zurück. Bei HTTP(S) bestimmen Schema, Host und Port den Origin; der Standardport entfällt in der Zeichenkette. Ein opaker Origin ergibt "null", nicht den Wert null. Zwei solche Zeichenketten belegen keinen gemeinsamen Origin. location.origin beschreibt dagegen den Origin der URL: Das anfängliche about:blank eines Frames ohne Sandbox kann den Origin der übergeordneten Seite erben, obwohl sein URL-Origin "null" ist.

Auch über Origin-Grenzen hinweg lässt sich window.parent abrufen. Lesezugriffe wie window.parent.document oder window.parent.origin werden dann aber normalerweise mit einer DOMException namens SecurityError blockiert. Verwende für Nachrichten postMessage mit einem exakten targetOrigin, wenn sich der Origin des Empfängers angeben lässt. Prüfe beim Empfang event.origin, das erwartete event.source und das Datenformat. Vertraue "null" allein nicht als Nachweis der Absenderidentität.

Diese APIs gehören zur Webplattform, nicht zu ECMAScript 2024. Web IDL kennzeichnet alle drei Eigenschaften als readonly und [Replaceable]: Eine Zuweisung innerhalb desselben Origins kann den Getter durch eine eigene Eigenschaft verdecken, ändert aber weder Fensterbeziehungen noch den Sicherheits-Origin. In einem Web Worker ist self der WorkerGlobalScope, und self.origin beschreibt den Worker; Window.parent gibt es dort nicht.

Beispiele

<!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>

Ergebnis

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

Öffne dieses HTML im Browser als HTTPS-Seite der obersten Ebene, ohne Sandbox und ohne Richtlinie, die das Inline-Skript oder den leeren Frame blockiert. Der Frame erbt den Origin der Seite, aber der Origin seiner URL `about:blank` ist `"null"`. Lies nach dem Ereignis `load` die JSON-Zeile in der Browserkonsole.

Zugehörige Lektionen

  • JavaScript · Lektion 5 · Fortgeschritten · Version: 4

Quellen