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 Standard
# dom-frameelement-dev

Compatibilidad con navegadores

BCD tables only load in the browser

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.