Window es un objeto que corresponde a la ventana que muestra una página web. Dicha ventana puede ser creada dinámicamente.
No es un objeto de JavaScript, y no está definido por la especificación DOM del W3C. Es un estándar de facto.
Los atributos y métodos de la ventana de interfaz son reconocidos por Internet Explorer 4, Firefox 1, Opera 9, versiones más recientes y Safari. Este documento se basa en lo soportado por los navegadores en ausencia de estándar oficial, ver referencias.
La ventana actual es referenciada por la palabra clave window, y las ventanas creadas dinámicamente por el nombre dado al objeto asignado por el valor de retorno del método open.
Definición y prueba de los atributos y objetos internos de la ventana
Definición de los atributos y objetos internos
Estos atributos pueden ser leídos sólo para algunos, su valor puede ser asignado de otra manera.
marcos Los marcos de la ventana. Sólo lectura. length Número de marcos. Sólo lectura. name Nombre de la ventana. status Texto de la barra de estado
En Firefox, la modificación del texto es una opción. Vaya a Opciones, Contenido, JavaScript y haga clic en el botón Avanzado. A continuación, marque la casilla junto a «Cambiar el texto de la barra de estado». defaultStatus Texto por defecto en la barra de estado. closed Estado cerrado o no. opener Referencia a la ventana que abrió esta ventana. Ejemplo:
x = window.opener;
parent La ventana padre de una ventana. Ejemplo:
x = mywin.parent;
top El padre del nivel más alto.
Objetos de la ventana
Estos objetos tienen sus propios atributos y métodos que no se detallan aquí pero tienen su propia página.
documento Se refiere a una página, que está contenida en la ventana. Documento. history Lista de páginas previamente vistas en la misma ventana. Historial. location Designa la URL de una página que contiene la ventana. Location. screen La pantalla y sus propiedades: width, height, availWidth, availHeight, colorDepth.
Ver también las propiedades para la creación de ventanas en el capítulo: Abrir una nueva ventana en JavaScript.
Comprobación de las propiedades del objeto Windows en el navegador
Las propiedades no soportadas por un navegador son indefinidas.
Algunas propiedades se utilizan como parámetros del constructor de la ventana pero no son accesibles directamente y no se listan aquí.
innerWidth innerHeight
outerWidth outerHeight
locationbar menubar personalbar statusbar toolbars scrollbars
pageXOffset pageYOffset
screenX screenY
directories
status defaultStatus
opener
parent
top
name
length
No funciona con Firefox 7
offscreenBuffering
Podemos obtener valores equivalentes en Internet Explorer y con todos los navegadores:
document.body.clientHeight
document.body.clientWidth
document.body.offsetHeight
document.body.offsetWidth
document.documentElement.offsetHeight
document.documentElement.offsetWidth
Otros
Crypto
Atención: La declaración DOCTYPE podría tener un efecto sobre estos valores.
Métodos de ventana y demos
Los métodos para abrir o cerrar una ventana se describen en el capítulo: Abrir una nueva ventana en JavaScript.
Definiciones de los métodos alert(mensaje) Muestra un mensaje. x = prompt(mensaje) Presenta un cuadro de diálogo solicitando una respuesta del usuario y devuelve la respuesta. x = confirm(mensaje) Muestra un mensaje, una pregunta normalmente, con dos botones para confirmar o cancelar. Devuelve verdadero o falso. resizeTo(w, h) Cambia el tamaño de la anchura y la altura. scrollTo(x, y) El desplazamiento debe estar habilitado para la ventana de acuerdo con la bandera de las barras de desplazamiento, este es el caso por defecto. moveTo(x, y) Se mueve a la posición dada. id = setInterval(expression, milliseconds) Evalúa una expresión repetidamente de acuerdo con el tiempo en el intervalo. clearInterval(id) Borrar el intervalo. id = setTimeout(expression, milliseconde) Evaluar una expresión después de la fecha límite. clearTimeout(id) Borrar el retraso. focus() Pasar el foco a la ventana. blur() Suprimir el foco a la ventana actual/dada. createPopup() Crear una subventana. print() Iniciar la impresión del contenido de la ventana. Demostración de los métodos de la ventana HTML objet Haga clic en un botón para ver cómo funciona un método. El código correspondiente se muestra a la derecha.
Vea también
Un ejemplo de uso de setTimeout se incluye en la demostración de lightbox con efecto de desvanecimiento.