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.

La propriété Window.frameElement renvoie l'élément (tel que <iframe> ou <object>) dans lequel la fenêtre est intégrée.

Note : Malgré le nom de cette propriété, elle fonctionne pour les documents intégrés dans n'importe quel point d'incorporation, y compris <object>, <iframe>, ou <embed>.

Syntaxe

js
const frameEl = window.frameElement;

Valeur

L'élément dans lequel la fenêtre est intégrée. Si la fenêtre n'est pas intégrée dans un autre document, ou si le document dans lequel elle est intégrée a un origin, la valeur est null à la place.

Exemple

js
const frameEl = window.frameElement;
// Si nous sommes incorporés, modifiez l'URL de l'élément contenant en 'http://mozilla.org/'
if (frameEl) {
  frameEl.src = "http://mozilla.org/";
}

Spécifications

Specification
HTML Standard
# dom-frameelement-dev

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi

  • window.frames renvoie un objet de type tableau, listant les sous-cadres directs de la fenêtre courante.
  • window.parent renvoie la fenêtre parente, qui est la fenêtre contenant le frameElement de la fenêtre enfant.