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.

Retorna el elemento (como es <iframe> ó <object>) en el cual la ventana está incrustada o null si el elemento es bien de nivel superior (top-level) o bien está inrustada en un documento con un origen de diferente; esto es, en situaciones de origen cruzado.

Sintaxes

js
frameEl = window.frameElement;
  • frame El es el elemento dentro del cual está empotrada la ventana. Si la ventana no está incrustada dentro de otro documento, o si el documento en el que está empotrada tiene un origen diferente (como procede de un dominio diferente), este valor será null.

Nota: A pesar del nombre de esta propiedad, funciona para documentos empotrados en cualquier forma o método de incrustación, incluyendo <object>, <iframe>, or <embed>.

Ejemplo

js
var frameEl = window.frameElement;
// Si estamos empotrados, cambia la URL de elemento contenedor to 'http://mozilla.org/'
if (frameEl) {
  frameEl.src = "http://mozilla.org/";
}

Especificaciones

Specification
HTML
# dom-frameelement-dev

Compatibilidad con navegadores

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
frameElement

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Ver también

  • window.frames retorna un objeto enumerable, listando los sub-frames directos de la ventana actual.
  • window.parent retorna la ventana padre, la cual es la ventana que contiene el frameElement de la ventana hija.