Window.frameElement

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

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.

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

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

Especificación Estado Observaciones
HTML Living Standard
La definición de 'Window.frameElement' en esta especificación.
Candidate Recommendation Especificación inicial.

Compatibilidad con navegadores

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help! (en-US)
Prestación Chrome Firefox (Gecko) Internet Explorer Opera Safari
Soporte básico 4? 1.0 (1.7 o anterior) 5.5? 12.1? 4?
Prestación Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Soporte básico ? 1.0 (1.7 o anterior) ? ? ?

Ver también

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