window.frameElement

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.

（<iframe> や <object> のような）ウィンドウが埋め込まれた要素を返します。要素がトップレベルであるか異なるスクリプト生成元をもつ文書に埋め込まれるかのいずれかの場合は、 null を返します。

構文

frameEl = window.frameElement;
  • frameEl は、ウィンドウが埋め込まれた要素です。ウィンドウが別の文書に埋め込まれていない場合、または埋め込まれている文書が異なる生成元を持つ（例えば異なるドメインから設置されている）場合、これは null になります。

メモ: このプロパティの名前にもかかわらず、これは<object>、<iframe>、または <embed>を含むすべての埋め込みポイント内に埋め込まれた文書の役に立ちます。

例

js
var frameEl = window.frameElement;
// 埋め込みの場合、要素の URL が 'http://mozilla.org/' に変わります。
if (frameEl) {
  frameEl.src = "http://mozilla.org/";
}

仕様書

Specification
HTML
# dom-frameelement-dev

ブラウザーの互換性

関連項目

  • window.frames は、現在のウィンドウの直接のサブフレームを一覧する、配列のようなオブジェクトを返します。
  • window.parent は、子ウィンドウのframeElementを含むウィンドウである、親ウィンドウを返します。