Window 对象

属性

说明

状态

closed

这个属性指示当前窗口是否关闭

只读

console

返回 console 对象的引用，该对象提供了对浏览器调试控制台的访问

只读

customElements

返回对CustomElementRegistry对象的引用，该对象可用于注册新的自定义元素，并获取有关先前注册的自定义元素的信息

只读

crypto

返回浏览器 crypto 对象

只读

devicePixelRatio

返回当前显示器的物理像素和设备独立像素的比例

只读

document

返回对当前窗口所包含文档的引用

只读

DOMMatrix

返回对 DOMMatrix 对象的引用，该对象表示 4x4 矩阵，适用于 2D 和 3D 操作

只读

DOMMatrixReadOnly

返回对 DOMMatrixReadOnly (en-US) 对象的引用，该对象表示 4x4 矩阵，适用于 2D 和 3D 操作。

只读

DOMPoint

返回对 DOMPoint 对象的引用，该对象表示坐标系中的 2D 或 3D 点。

只读

DOMPointReadOnly

返回对 DOMPointReadOnly (en-US) 对象的引用，该对象表示坐标系中的 2D 或 3D 点

只读

DOMQuad

返回对 DOMQuad 对象的引用，该对象表示一个四边形对象，即具有四个角和四个边的对象。

只读

DOMRect

返回对 DOMRect 对象的引用，该对象表示一个矩形

只读

DOMRectReadOnly

返回对 DOMRectReadOnly 对象的引用，该对象表示一个矩形

只读

event

返回当前事件，即当前由 JavaScript 代码的上下文处理的事件，如果当前没有处理任何事件，则返回 undefined。应尽可能使用直接传递给事件处理程序的 Event 对象

只读

frameElement

返回嵌入窗口的元素，如果未嵌入窗口，则返回 null

只读

frames

返回当前窗口中所有子窗体的数组

只读

fullScreen

此属性表示窗口是否以全屏显示

history

返回一个对history对象的引用。

只读

innerHeight

获得浏览器窗口的内容区域的高度，包含水平滚动条(如果有的话)。

只读

innerWidth

获得浏览器窗口的内容区域的宽度，包含垂直滚动条(如果有的话)。

只读

isSecureContext

指出上下文环境是否能够使用安全上下文环境的特征。

只读

length

返回窗口中的frames数量。参见frames。

只读

location

获取、设置window对象的location，或者当前的URL.

locationbar

返回locationbar对象，其可视性可以在窗口中切换。

只读

localStorage

返回用来存储只能在创建它的源下访问的数据的本地存储对象的引用

只读

menubar

返回菜单条对象，它的可视性可以在窗口中切换

只读

messageManager

返回窗口的messagemanager对象。

只读

mozAnimationStartTime

返回当前动画循环开始经过的毫秒数

只读

mozInnerScreenX

返回窗口视口左上角的水平 (X) 坐标，以屏幕坐标表示。该值以 CSS 像素为单位报告。如果需要，请参阅 nsIDOMWindowUtils 中的 mozScreenPixelsPerCSSPixel 以获取适应屏幕像素的转换因子。

只读

mozInnerScreenY

返回窗口视口左上角的垂直 (Y) 坐标，以屏幕坐标表示。该值以 CSS 像素为单位报告。如果需要，请参阅 mozScreenPixelsPerCSSPixel 以获取适应屏幕像素的转换因子

只读

mozPaintCount

返回当前文档在此窗口中呈现到屏幕的次数。这可用于计算渲染性能

只读

name

获取/设置窗口的名称

navigator

返回对 navigator 对象的引用

只读

opener

返回对打开当前窗口的那个窗口的引用

outerHeight

返回浏览器窗口的外部高度

只读

outerWidth

返回浏览器窗口的外部宽度

只读

pageXOffset

window.scrollX的别名。

只读

pageYOffset

window.scrollY的别名

只读

parent

返回当前窗口或子窗口的父窗口的引用

只读

performance

返回一个 Performance 对象，其中包括计时和导航属性，每个属性都是一个提供与性能相关的（en-US）数据的对象。有关其他信息和示例，另请参阅使用导航计时。

只读

personalbar

返回 personalbar 对象，它的可视性可以在窗口中切换

只读

returnValue

要返回给调用 window.showModalDialog() 以将窗口显示为模式对话框的函数的返回值

screen

返回对与窗口关联的屏幕对象的引用

只读

screenX screenLeft

这两个属性都返回从用户浏览器视口的左边框到屏幕左侧的水平距离

只读

screenY

screenTop

这两个属性都返回从用户浏览器视口的顶部边框到屏幕顶部的垂直距离

只读

scrollbars

返回滚动条对象，其可见性可以在窗口中切换

只读

scrollMaxX

窗口可以水平滚动到的最大偏移量，即文档宽度减去视口宽度

只读

scrollMaxY

窗口可以垂直滚动到的最大偏移量（即文档高度减去视口高度）。

只读

scrollX

返回文档已经水平滚动的像素数

只读

scrollY

返回文档已经垂直滚动的像素数

只读

self

返回对窗口对象本身的对象引用

只读

sessionStorage

返回对会话存储对象的引用，该对象用于存储只能由创建它的源访问的数据

sidebar

返回对侧边栏窗口对象的引用

只读

speechSynthesis

返回一个 SpeechSynthesis 对象，它是使用 Web Speech API 语音合成功能的入口点。

只读

status

获取/设置浏览器底部状态栏中的文本。

statusbar

返回状态栏对象，其可见性可以在窗口中切换

只读

toolbar

返回工具栏对象，其可见性可以在窗口中切换

只读

top

返回对窗口层次结构中最顶层窗口的引用。该属性是只读的

只读

visualViewport

返回一个 VisualViewport 对象，它表示给定窗口的可视视口

只读

window

返回对当前窗口的引用

只读

window[0], window[1], etc.

返回对框架中窗口对象的引用。有关更多详细信息，请参见 Window.frames

caches

返回与当前上下文关联的 CacheStorage 对象。此对象启用诸如存储资产以供离线使用以及生成对请求的自定义响应等功能

只读

indexedDB

为应用程序提供异步访问索引数据库能力的机制；返回一个 IDBFactory 对象。

只读

isSecureContext

返回一个布尔值，指示当前上下文是否安全 (true) 或不安全 (false)。

只读

origin

返回全局对象的来源，序列化为字符串。 （这似乎还没有在任何浏览器中实现。）

方法

说明

alert()

显示警报对话框

blur()

将焦点从窗口移开

cancelAnimationFrame()

使您能够取消以前使用 Window.requestAnimationFrame 安排的回调。

cancelIdleCallback()

使您能够取消以前使用 Window.requestIdleCallback 安排的回调

clearImmediate()

使用 setImmediate 取消重复执行集

close()

关闭当前窗口。

confirm()

显示一个对话框，其中包含用户需要响应的消息。

dispatchEvent()

用于触发事件

dump()

向控制台写入消息

find()

在窗口中搜索给定的字符串

focus()

将焦点设置在当前窗口上

getComputedStyle()

获取指定元素的计算样式。 Computed style 表示元素所有 CSS 属性的计算值

getDefaultComputedStyle()

获取指定元素的默认计算样式，忽略作者样式表

getSelection()

返回代表所选项目的选择对象

matchMedia()

返回一个 MediaQueryList 对象，表示指定的媒体查询字符串

maximize()

最大化窗口

minimize()

最小化窗口

moveBy()

将当前窗口移动指定的量

moveTo()

将窗口移动到指定坐标

open()

打开一个新窗口

postMessage()

为一个窗口向另一个窗口发送数据字符串提供了一种安全方法，该窗口不必与第一个窗口处于相同的域中

print()

打开打印对话框以打印当前文档

prompt()

返回用户在提示对话框中输入的文本

requestAnimationFrame()

requestAnimationFrame()

requestIdleCallback()

启用在浏览器空闲期间对任务进行调度

resizeBy()

将当前窗口调整到一定的大小

resizeTo()

动态调整窗口

scroll()

滚动窗口到文档中的特定位置

scrollBy()

按给定的数量在窗口中滚动文档

scrollByLines()

按给定行数滚动文档。

scrollByPages()

按指定页数滚动当前文档。

scrollTo()

滚动到文档中的特定坐标集。

setImmediate()

在浏览器完成其他繁重任务后执行一个函数。

setResizable()

切换用户调整窗口大小的能力。

sizeToContent()

根据内容设置窗口大小。

stop()

这个方法停止窗口加载。

updateCommands()

更新当前 chrome 窗口 (UI) 命令的状态

addEventListener()

将事件处理程序注册到窗口上的特定事件类型。

atob()

解码使用 base-64 编码的数据字符串

btoa()

从二进制数据字符串创建 base-64 编码的 ASCII 字符串。

clearInterval()

取消使用setInterval（）的重复执行集

clearTimeout()

使用 setTimeout() 取消延迟执行集

createImageBitmap()

接受各种不同的图像源，并返回解析为 ImageBitmap 的 Promise (en-US)。可选地，源被裁剪为源自 (sx, sy) 的像素矩形，宽度为 sw，高度为 sh。

fetch()

开始从网络获取资源的过程

EventTarget.removeEventListener

从窗口中移除一个事件监听器

setInterval()

每次经过给定的毫秒数时安排一个函数执行。

setTimeout()

安排一个函数在给定的时间内执行。

属性

说明

onappinstalled

在将页面作为 Web 应用安装时调用。请参阅事件。appinstalled

onbeforeinstallprompt

在提示用户将网站保存到移动设备上的主屏幕之前调度的事件处理程序属性。

ondevicelight

任何环境光级别更改的事件处理程序属性

ondevicemotion

如果加速度计检测到更改，则调用（对于移动设备）

ondeviceorientation

更改方向时调用（对于移动设备）

ondeviceorientationabsolute

任何设备方向更改的事件处理程序属性。

ondeviceproximity

设备邻近性事件的事件处理程序属性

ongamepadconnected

表示将在连接游戏手柄时（当gamepadconnected 事件触发时）运行的事件处理程序

ongamepaddisconnected

表示一个事件处理程序，该处理程序将在游戏手柄断开连接时（当gamepaddisconnected事件触发时）运行

onpaint

窗口上绘制事件的事件处理程序属性

onrejectionhandled

处理 Promise 拒绝事件的事件处理程序。

onuserproximity

用户邻近性事件的事件处理程序属性。

onvrdisplayconnect

表示一个事件处理程序，该处理程序将在兼容的 VR 设备连接到计算机时（当vrdisplayconnected事件触发时）运行。

onvrdisplaydisconnect

表示一个事件处理程序，该处理程序将在兼容的 VR 设备与计算机断开连接时（当 vrdisplaydisconnected 事件触发时）运行。

onvrdisplayactivate

表示一个事件处理程序，该事件处理程序将在显示器能够呈现给时（当 vrdisplayactivate 事件触发时）运行，例如，如果 HMD 已被移动以使其脱离待机状态，或者通过被打开而唤醒。

onvrdisplaydeactivate

表示一个事件处理程序，该处理程序将在无法再显示显示器时（当 vrdisplaydeactivate 事件触发时）运行，例如，如果 HMD 由于一段时间不活动而进入待机或睡眠模式。

onvrdisplayblur

表示一个事件处理程序，当浏览器、操作系统或 VR 硬件由于某种原因（当 vrdisplayblur 事件触发时）暂停对显示器的演示时（例如，当用户与系统菜单或浏览器交互时），该事件处理程序将运行，以防止跟踪或失去经验。

onvrdisplayfocus

表示一个事件处理程序，该处理程序将在模糊后恢复对显示器的演示时（当事件触发时）运行。vrdisplayfocus

onvrdisplaypresentchange

表示一个事件处理程序，该处理程序将在 VR 设备的呈现状态更改时运行 — 即从呈现变为不呈现，反之亦然（当 vrdisplaypresentchange 事件触发时）

其他事件处理程序

说明

GlobalEventHandlers.onabort

在资源加载已中止时调用，例如用户在加载仍在进行时取消加载

WindowEventHandlers.onafterprint

在打印对话框关闭时调用

WindowEventHandlers.onbeforeprint

在打开打印对话框时调用

WindowEventHandlers.onbeforeunload

窗口上卸载前事件的事件处理程序属性。

GlobalEventHandlers.onblur

在窗口失去焦点（例如，由于弹出窗口）后调用。

GlobalEventHandlers.onchange

窗口上更改事件的事件处理程序属性。

GlobalEventHandlers.onclick

按下 & 释放任意鼠标按钮后调用

GlobalEventHandlers.ondblclick

在使用任何鼠标按钮进行双击时调用。

GlobalEventHandlers.onclose

窗口关闭后调用

GlobalEventHandlers.oncontextmenu

按下鼠标右键时调用

GlobalEventHandlers.onerror

在资源无法加载或运行时发生错误时调用

GlobalEventHandlers.onfocus

在窗口接收或重新获得焦点后调用。查看事件

WindowEventHandlers.onhashchange

窗口上事件的事件处理程序属性;当哈希标记 （“#”） 之后的 URL 部分发生更改时调用

GlobalEventHandlers.oninput

当<输入>元素的值更改时调用

GlobalEventHandlers.onkeydown

在您开始按任意键时调用

GlobalEventHandlers.onkeypress

当键（Shift、Fn 和大写锁定除外）处于按下位置时调用。请参阅事件

GlobalEventHandlers.onkeyup

在完成释放任何密钥时调用

WindowEventHandlers.onlanguagechange

窗口上事件的事件处理程序属性

GlobalEventHandlers.onload

在所有资源和 DOM 完全加载后调用。从缓存加载页面时不会调用，例如使用后退按钮。

WindowEventHandlers.onmessage

表示引发事件时要调用的代码

GlobalEventHandlers.onmousedown

按下任何鼠标按钮时调用。

GlobalEventHandlers.onmousemove

当鼠标在窗口内移动时连续调用。

GlobalEventHandlers.onmouseout

在指针离开窗口时调用。

GlobalEventHandlers.onmouseover

指针进入窗口时调用

GlobalEventHandlers.onmouseup

释放任何鼠标按钮时调用

WindowEventHandlers.onoffline

在网络连接丢失时调用。请参阅事件

WindowEventHandlers.ononline

在建立网络连接时调用。请参阅事件

WindowEventHandlers.onpagehide

当用户在 onunload 事件之前离开页面时调用

WindowEventHandlers.onpageshow

在所有资源和 DOM 完全加载后调用

WindowEventHandlers.onpopstate

按下后退按钮时调用。

GlobalEventHandlers.onreset

重置表单时调用

GlobalEventHandlers.onresize

在调整窗口大小时连续调用。

GlobalEventHandlers.onscroll

当滚动条通过 ANY 方式移动时调用。如果资源完全适合窗口，则无法调用此事件

GlobalEventHandlers.onwheel

当鼠标滚轮围绕任何轴旋转时调用

GlobalEventHandlers.onselect

选择输入字段中的文本后调用

GlobalEventHandlers.onselectionchange

表示引发事件时要调用的代码。event handlerselectionchange

WindowEventHandlers.onstorage

在会话存储或本地存储发生更改时调用。查看活动storage

GlobalEventHandlers.onsubmit

提交表单时调用

WindowEventHandlers.onunhandledrejection

未处理的 Promise 拒绝事件的事件处理程序。

WindowEventHandlers.onunload

当用户离开页面时调用。

事件

说明

error

当资源加载失败或无法使用时触发。例如，如果脚本执行错误或图像无法找到或无效。也可以通过 onerror 属性获得

languagechange

当用户的首选语言更改时，在全局范围对象上触发。也可以通过 onlanguagechange 属性获得

orientationchange

当设备的方向改变时触发。也可以通过 onorientationchange 属性获得

devicemotion

以固定间隔触发，指示设备正在接收的物理加速度大小和旋转速率（如果有）

deviceorientation

当磁力计方向传感器提供有关设备当前方向与地球坐标系相比的新数据时触发

resize

调整窗口大小时触发。也可以通过 onresize 属性获得

storage

当存储区域（localStorage 或 sessionStorage）在另一个文档的上下文中被修改时触发。也可以通过 onstorage 属性获得

动画事件

说明

animationcancel

当动画意外中止时触发。也可以通过 onanimationcancel 属性获得

animationend

当动画正常完成时触发。也可以通过 onanimationend 属性获得

animationiteration

当动画迭代完成时触发。也可以通过 onanimationiteration 属性获得

animationstart

动画开始时触发。也可以通过 onanimationstart 属性获得

剪贴板事件

说明

clipboardchange

当系统剪贴板内容改变时触发

copy

当用户通过浏览器的用户界面启动复制操作时触发。也可以通过 oncopy 属性获得

cut

当用户通过浏览器的用户界面启动剪切操作时触发。也可以通过 oncut 属性获得

paste

当用户通过浏览器的用户界面启动粘贴操作时触发。也可以通过 onpaste 属性获得

连接事件

说明

offline

当浏览器无法访问网络并且 navigator.onLine 的值已切换为 false 时触发。也可通过 onoffline 属性获得

online

当浏览器获得对网络的访问权并且 navigator.onLine 的值已切换为 true 时触发。也可通过在线属性获得

焦点事件

说明

blur

当元素失去焦点时触发。也可以通过 onblur 属性获得

focus

当元素获得焦点时触发。也可以通过 onfocus 属性获得

游戏手柄事件

说明

gamepadconnected

当浏览器检测到游戏手柄已连接或第一次使用游戏手柄的按钮/轴时触发。也可以通过 ongamepadconnected 属性获得

gamepaddisconnected

当浏览器检测到游戏手柄已断开连接时触发。也可以通过 ongamepaddisconnected 属性获得

历史事件

说明

hashchange

当 URL 的片段标识符发生更改时触发（URL 中以 # 符号开头和之后的部分）。也可以通过 onhashchange 属性获得

pagehide

当浏览器在切换到显示与会话历史不同的文档的过程中隐藏当前文档时发送。例如，当用户单击“后退”按钮或单击“前进”按钮以在会话历史中向前移动时，就会发生这种情况。也可以通过 onpagehide 事件处理程序属性获得

pageshow

当浏览器由于导航任务使文档可见时发送，不仅包括首次加载页面时，还包括用户在导航到同一选项卡中的另一个页面后导航回该页面的情况。也可使用 onpageshow 事件处理程序属性

popstate

当活动的历史条目改变时触发。也可以使用 onpopstate 事件处理程序属性

加载和停止加载事件

说明

beforeunload

当窗口、文档及其资源即将被卸载时触发。也可以通过 onbeforeunload 属性获得

DOMContentLoaded

当文档完全加载和解析时触发，无需等待样式表、图像和子框架完成加载

load

加载整个页面时触发，包括所有依赖资源，例如样式表图像。也可以通过 onload 属性获得

unload

在卸载文档或子资源时触发。也可以通过 onunload 属性获得

清单事件

说明

appinstalled

当浏览器成功将页面安装为应用程序时触发。也可以通过 onappinstalled 属性获得

beforeinstallprompt

当即将提示用户安装 Web 应用程序时触发。也可以通过 onbeforeinstallprompt 属性获得

消息事件

说明

message

当窗口接收到消息时触发，例如来自另一个浏览上下文对 Window.postMessage() 的调用。也可以通过 onmessage 属性获得

messageerror

当 Window 对象收到无法反序列化的消息时触发。也可以通过 onmessageerror 属性获得

打印事件

说明

afterprint

在相关文档开始打印或打印预览关闭后触发。也可以通过 onafterprint 属性获得

beforeprint

当相关文档即将打印或预览打印时触发。也可以通过 onbeforeprint 属性获得

Promise拒绝事件

说明

rejectionhandled

每次 JavaScript Promise 被拒绝时发送，无论是否有处理程序来捕获拒绝。也可以通过 onrejectionhandled 事件处理程序属性获得

unhandledrejection

当 JavaScript Promise 被拒绝但没有处理程序来捕获拒绝时发送。也可以使用 onunhandledrejection 事件处理程序属性

过渡事件

说明

transitioncancel

当取消 CSS 转换时触发。也可以通过 ontransitioncancel 属性获得

transitionend

当 CSS 转换完成时触发。也可以通过 ontransitionend 属性获得

transitionrun

首次创建 CSS 过渡时触发。也可以通过 ontransitionrun 属性获得

transitionstart

当 CSS 转换实际开始时触发。也可以通过 ontransitionstart 属性获得

WebVR 事件

说明

vrdisplayactivate

当 VR 显示器可供展示时触发，例如，如果 HMD 已被移动以使其脱离待机状态，或者被戴上时被唤醒。也可通过 onvrdisplayactivate (en-US) 属性获得

vrdisplayblur

当浏览器、操作系统或 VR 硬件由于某种原因暂停向 VR 显示器的演示时触发。也可通过 onvrdisplayblur (en-US) 属性获得

vrdisplayconnect

当兼容的 VR 显示器连接到计算机时触发。也可通过 onvrdisplayconnect属性获得

vrdisplaydeactivate

当无法再向其展示 VR 显示器时触发，例如，如果 HMD 由于一段时间不活动而进入待机或睡眠模式。也可通过 onvrdisplaydeactivate属性获得

vrdisplaydisconnect

当兼容的 VR 显示器与计算机断开连接时触发。也可通过 onvrdisplaydisconnect  属性获得

vrdisplayfocus

在模糊后恢复到 VR 显示器的演示时触发。也可通过 onvrdisplayfocus 属性获得

vrdisplaypresentchange

当 VR 显示器的呈现状态发生变化时触发 - 即从呈现变为不呈现，反之亦然。也可通过 onvrdisplaypresentchange (en-US) 属性获得

vrdisplaypointerrestricted

当 VR 显示器的指针输入通过指针锁定元素限制为消耗时触发。也可通过 onvrdisplaypointerrestricted (en-US) 属性获得

vrdisplaypointerunrestricted

当 VR 显示器的指针输入不再限制为通过指针锁定元素消耗时触发。也可通过 onvrdisplaypointerunrestricted (en-US) 属性获得