El objeto window representa la ventana que contiene un documento DOM.
Esta sección proporciona una pequeña referencia a todos las propiedades, métodos y eventos disponibles del objeto window. El objeto window implementa la interfaz Window, que a su vez hereda de la interfaz AbstractView. Algunas funciones como: globales adicionales, espacios de nombres, interfaces y constructores no típicamente asociados con el objeto window pero disponibles en éste.
La propiedad window.document apunta al DOM cargado en esa ventana. El objeto window al que pertenece un documento puede ser obtenido usando la propiedad window.document.defaultView.
No existe un estándar público que se aplique al objeto Window, pero todos los principales navegadores lo admiten.
Propiedad | Descripción |
---|---|
ApplicationCache | solo lectura |
Closed | solo lectura, informa si la ventana esta cerrado o no. |
Components | ? |
Console | Devuelve una referencia al objeto window.console, que proporciona métodos para registrar información en la consola del navegador. |
Content | ? |
Controllers | ? |
DefaultStatus | Establece o devuelve el texto predeterminado en la barra de estado de una ventana. |
DevicePixelRatio | ? |
DialogArgument | ? |
Directories | ? |
Document | Devuelve el objeto window.document. |
FrameElement | Devuelve el elemento <iframe> en el que se inserta la ventana actual. |
Frames | Devuelve todos los elementos <iframe> en la ventana actual. |
Global | ? |
History | Devuelve el objeto window.history. |
InnerHeight | La altura interna de la ventana del navegador (px) |
InnetWidth | El ancho interno de la ventana del navegador (px) |
Length | Devuelve el número de elementos <iframe> en la ventana actual. |
Location | Devuelve el objeto window.location. |
LocationBar | ? |
LocationStorage | Permite guardar pares clave/valor en un navegador web. Almacena los datos sin fecha de vencimiento. |
MenuBar | ? |
MessageManager | ? |
Name | Establece o devuelve el nombre de una ventana. |
Navigator | Devuelve el objeto window.navigator. |
Opener | Devuelve una referencia a la ventana que creó la ventana. |
OuterHeight | Devuelve el alto de la ventana del navegador, incluidas las barras de desplazamiento. |
OuterWidth | Devuelve el ancho de la ventana del navegador, incluidas las barras de desplazamiento. |
PageXOffset | Devuelve los px del documento actual que se ha desplazado (horizontalmente) desde la esquina superior izquierda de la ventana. |
PageYOffset | Devuelve los px del documento actual que se ha desplazado (verticalmente) desde la esquina superior izquierda de la ventana. |
Parent | Devuelve la ventana principal de la ventana actual. |
Performance | ? |
PersonalBar | ? |
ReturnValue | ? |
Screen | Devuelve el objeto window.screen. |
ScreenX | Alias de pageXOffset |
ScreenY | Alias de pageYOffset |
ScrollBars | ? |
ScrollX | Devuelve la coordenada horizontal de la ventana en relación con la pantalla. |
ScrollY | Devuelve la coordenada vertical de la ventana en relación con la pantalla. |
Self | Devuelve la ventana actual |
SessionStorage | Permite guardar pares clave/valor en un navegador web. Almacena los datos para una sesión |
SideBar | ? |
Status | Establece o devuelve el texto en la barra de estado de una ventana. |
ToolBar | ? |
Top | Devuelve la ventana superior del navegador. |
En un navegador con pestañas (como todos actualmente) cada pestaña contiene su propio objeto window, es decir no se comparte entre diferentes pestañas de la misma ventana del navegador. Algunos métodos, como window.resizeTo y window.resizeBy se aplican sobre toda la ventana del navegador y no sobre una pestaña específica a la que pertenece el objeto window. Generalmente, cualquier cosa que razonablemente no pueda pertenecer a una pestaña, pertenece a la ventana.
Método | Descripción |
---|---|
Alert() | Muestra una ventana de alerta. |
Atob() | |
Back() | Un paso atrás en el historial |
Blur() | Pone le foco en la ventana |
Btoa() | |
ClearInterval() | |
ClearTimeout() | |
Close() | Cierra la ventana actual. Ojo solo si fue abierto desde JavaScript. |
Confirm() | Muestra una venta con dos opciones: confirmar y cancelar. |
DisparchEvent() | Usada para lanzar un evento |
Dump() | Escribe un mensaje en la consola |
EnableExtrenalCapture() | ? |
Find() | Busca una cadena en la ventana. |
Focus() | Pone el foco en la ventana actual. |
GetAttention() | ? |
GetAttentionWidthCycleCount() | ? |
GetComputedStyle() | Obtiene los estilos CSS calculados actuales aplicados a un elemento. |
GetSelection() | Devuelve un objeto window.selection que representa el rango de texto seleccionado por el usuario. |
Home() | Retorna el navegador a la pagina home |
MatchMedia() | Devuelve un objeto MediaQueryList que representa la cadena de consulta de medios CSS especificada. |
Maximize() | ? |
Minimize() | ? |
MoveBy() | Mueve una ventana en relación con su posición actual. |
MoveTo() | Mueve la ventana actual. |
OpenDialog() | ? |
Open() | Abre un archivo en una nueva ventana. |
PostMesage() | ? |
Print() | Imprime el contenido de la ventana actual. |
Prompt() | Muestra un cuadro de diálogo que solicita al visitante que ingrese. |
ReleaseEvent() | ? |
RemoveEventListener() | ? |
ResizeBy() | Cambia el tamaño de la ventana por los px especificados. |
ResizeTo() | Cambia el tamaño de la ventana actual. |
RequestAnimationFrame() | Solicita al navegador que llame a una función para actualizar una animación antes del próximo repintado. |
Restore() | ? |
RouteEvent() | ? |
Scroll() | Deprecated. Reemplazado por window.scrollTo(). |
ScrollBy() | Desplaza el documento por el número especificado de px. |
ScrollTo() | Desplaza el documento a las coordenadas especificadas. |
SetCursor() | ? |
SetImmediate() | Llama a una función o evalúa una expresión a intervalos específicos (milisegundos) |
SetTimeout() | Llama a una función o evalúa una expresión después de un número específico (milisegundos) |
Setresizable() | ? |
SizeToContent() | ? |
Stop() | Detiene la carga de la ventana. |
UpdateCommends() | ? |
DOMparser | |
GeckoActiveXobject | |
Image | |
Option | |
QueryInterface | |
XMLserializer | |
Worker | |
XPCnativeWrapper | |
XPCsafeJSobjectWrapper |
Este objeto contiene información sobre la pantalla de usuario.
width | devuelve el ancho de la pantalla del visitante en px. |
height | devuelve el alto de la pantalla del visitante en px. |
availWidth | devuelve el ancho de la pantalla del visitante, en px, menos las características de la interfaz como la barra de tareas de Windows. |
availHeight | devuelve la altura de la pantalla del visitante, en px, menos las características de la interfaz como la barra de tareas de Windows. |
colorDepth | devuelve el número de bits usados para mostrar un color. 8 bits (256/VGA), 16 bits (65536) o 24 bits. |
pixelDepth | devuelve la profundidad de px de la pantalla. 24 px |
Se puede usar para obtener la dirección de la página actual (URL) y redirigir el navegador a una nueva página.
window.location.propiedad; location.propiedad;
href | devuelve el href (URL) de la página actual |
hostname | devuelve el nombre de dominio del servidor web |
pathname | devuelve la ruta y el nombre de archivo de la página actual |
protocol | devuelve el protocolo web utilizado (http: o https :) |
assign() | carga un nuevo documento |
<button onClick="window.location.assign('js110a.htm')">Ejemplo</button>
Este objeto tiene el historial del navegador.
window.history.método; history.método;
back() | igual que volver a hacer clic en el navegador. |
forward() | igual que hacer clic en el navegador hacia adelante. |
<button onClick="window.history.back()">Ejemplo</button>
Este objeto contiene información sobre el navegador del visitante.
window.navigator.propiedad; navigator.propiedad;
appName | propiedad devuelve el nombre de la aplicación del navegador. |
appCodeName | propiedad devuelve el nombre del código de la aplicación del navegador. |
appVersion | propiedad devuelve información sobre la versión del navegador. |
product | propiedad devuelve el nombre del producto del motor del navegador. |
platform | propiedad devuelve el nombre del producto del motor del navegador. Sistema operativo. |
onLine | propiedad devuelve verdadero si el navegador está en línea. |
cookieEnabled | devuelve verdadero si las cookies están habilitadas, de lo contrario falso. |
userAgent | propiedad devuelve el encabezado de agente de usuario enviado por el navegador al servidor. |
language | propiedad devuelve el idioma del navegador. |
javaEnabled() | método que devuelve verdadero si Java está habilitado. |
A menudo se usa un cuadro de confirmación si desea que el usuario verifique o acepte algo. Cuando aparece un cuadro de confirmación, el usuario tendrá que hacer clic en "Aceptar" o "Cancelar" para continuar. Si el usuario hace clic en "Aceptar", el cuadro devuelve verdadero. Si el usuario hace clic en "Cancelar", el cuadro devuelve falso.
window.alert('texto'); alert('texto');
<Script> if (confirm('Presiona un boton')){ txt = 'Presionaste aceptar'; }else{ txt = 'resionaste cancelar'; } </Script>
A menudo se usa un cuadro de aviso si desea que el usuario ingrese un valor antes de ingresar a una página. Cuando aparece un cuadro emergente, el usuario tendrá que hacer clic en "Aceptar" o "Cancelar" para continuar después de ingresar un valor de entrada. Si el usuario hace clic en "Aceptar", el cuadro devuelve el valor de entrada. Si el usuario hace clic en "Cancelar", el cuadro devuelve nulo.
window.prompt('texto'); prompt('texto');
<Script> var persona = prompt('Por favor ingresa tu nombre','Harry Potter'); if (persona == null || persona == '')){ txt = 'Usuario no quizo responder.'; }else{ txt = 'Hola ' + persona + '\ncomo estas hoy ?'; } </Script>
Se llaman objetos de sincronizacion porque permiten ejecutar código a intervalos predefinidos.
window.setTimeout(funcion,milisegundos); window.setInterval(funcion,milisegundos); window.clearTimeout(variable); window.clearInterval(variable);
En este ejemplo tardamos 3 segundos en levantar una ventana emergente.
<button onclick="setTimeout(tarda, 3000);">Ejemplo</button> <Script> funtion tarda(){ alert('Hola...'); } </Script>
En este ejemplo mostramos un reloj que podemos parar (solo funciona una vez).
<span id=demo></span> <button onclick="clearInterval(reloj)">Parar</button> <Script> var reloj = setInterval(muestra,1000); funtion muestra(){ var r = new Date(); document.getElementById('demo').innerHTML = r.toLocaleTimeString(); } </Script>
El objeto Consola proporciona acceso a la consola de depuración del navegador.
assert() | Escribe un mensaje de error en la consola si la afirmación es falsa. |
clear() | Limpia la consola. |
count() | Registra el número de veces que se ha llamado a esta llamada particular a console.count(). |
error() | Envía un mensaje de error a la consola. |
group() | Crea un nuevo grupo en línea en la consola. Esto sangra los siguientes mensajes de la consola en un nivel adicional, hasta que se llame a console.groupEnd() |
groupCollapsed() | Crea un nuevo grupo en línea en la consola. Sin embargo, el nuevo grupo se crea contraído. El usuario deberá usar el botón de divulgación para expandirlo. |
groupEnd() | Sale del grupo en línea actual en la consola. |
info() | Envía un mensaje informativo a la consola. |
log() | Envía un mensaje a la consola. |
table() | Muestra datos tabulares como una tabla. |
time() | Inicia un temporizador (puede rastrear cuánto tiempo lleva una operación). |
timeEnd() | Detiene un temporizador que fue iniciado previamente por console.time(). |
trace() | Emite un seguimiento de pila a la consola. |
warn() | Envía un mensaje de advertencia a la consola. |
Solo se puede cerrar una ventana que fue abierta desde JavaScrip. A continuación hay dos botones una de abrir (funciona) y otro de abrir que no funcionara en esta pagina pero si en la pagina abierta con el botón
Para que siempre funcione un boton con close() una cosa que puedes hacer es abrir e inmediatamnente volver a cerarar. Ver codigo.
<button onClick="window.open('','_self').close();">Descartar</button>