Propriedade frameElement da Window

Definição e uso

frameElement A propriedade retorna o frame em que a janela está executando.

Se a janela não estiver executando dentro de um frame, frameElement A propriedade retorna null.

frameElement A propriedade é apenas leitura.

Dica:O frame pode ser qualquer elemento embutido:<frame>, <iframe>, <embed>, <object> etc.

Veja também:

Propriedade length

Propriedade frames

Exemplo

Exemplo 1

A janela atual está dentro de um frame?

if (window.frameElement) {
  let answer = "SIM";
}

Experimente você mesmo

Exemplo 2

Se a janela estiver dentro de um frame, mude a URL para "codew3c.com":

const frame = window.frameElement;
if (frame) {
  frame.src = "https://www.codew3c.com/";
}

Experimente você mesmo

Sintaxe

window.frameElement

ou:

frameElement

Retorno

Tipo Descrição
Objeto.

O host da janela (documento pai).

Se não existir host, será null.

Suporte do navegador

Todos os navegadores suportam window.frameElement

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Suporte Suporte Suporte Suporte Suporte Suporte

Páginas relacionadas

Objeto IFrame do DOM HTML

Etiqueta <iframe> do HTML