Window: frameElement-Eigenschaft

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die Window.frameElement-Eigenschaft gibt das Element zurück (wie <iframe> oder <object>), in dem das Fenster eingebettet ist.

Hinweis: Trotz des Namens dieser Eigenschaft funktioniert sie für Dokumente, die in jedem Einbettungspunkt eingebettet sind, einschließlich <object>, <iframe> oder <embed>.

Wert

Das Element, in das das Fenster eingebettet ist. Wenn das Fenster nicht in ein anderes Dokument eingebettet ist oder wenn das Dokument, in das es eingebettet ist, einen anderen Ursprung hat, ist der Wert stattdessen null.

Beispiele

js
const frameEl = window.frameElement;
// If we're embedded, change the containing element's URL to 'https://mozilla.org/'
if (frameEl) {
  frameEl.src = "https://mozilla.org/";
}

Spezifikationen

Specification
HTML Standard
# dom-frameelement-dev

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch

  • window.frames gibt ein Array-ähnliches Objekt zurück, das die direkten Unterrahmen des aktuellen Fensters auflistet.
  • window.parent gibt das übergeordnete Fenster zurück, welches das Fenster enthält, das das frameElement des Unterfensters ist.