WindowOrWorkerGlobalScope执行者:window

window

该 window 对象表示一个包含 DOM 文档的窗口;该 document 属性指向在该窗口中加载的 DOM 文档。使用该 document.defaultView 属性可以获得给定文档的窗口。

本节提供了通过 DOM window 对象可用的所有方法、属性和事件的简要参考。该 window 对象实现了 Window 接口,该接口继而从 AbstractView 接口继承。JavaScript Reference 和 DOM Reference 中列出了一些额外的全局函数、命名空间、对象、接口和构造函数,通常不与 window 关联,但可用。

在 Firefox 等标签浏览器中,每个标签都包含自己的 window 对象(如果您正在编写扩展,则浏览器窗口本身也是一个单独的窗口。也就是说,该 window 对象不在同一窗口中的选项卡之间共享。一些方法,即 window.resizeTo 与 window.resizeBy 适用于整个窗口,而不应用于 window 对象所属的特定选项卡。一般来说,不能合理地与选项卡相关的任何内容都属于 window。

window属性

该接口从 EventTarget 接口继承属性并实现来自 WindowOrWorkerGlobalScope 和 WindowEventHandlers mixin 的属性。

请注意,属性是对象(例如,用于覆盖内置元素的原型)将在下面的单独部分中列出。

Window.closed 只读
该属性指示当前窗口是否关闭。
Window.console 只读
返回提供对浏览器调试控制台访问权的控制台对象的引用。
Window.content和 Window._content 只读 
返回当前窗口中对内容元素的引用。自从 Firefox 57(最初只有 Nightly-only)以来,这两个版本都只能从 Chrome(特权)代码获得,并且不再可用于Web。
Window.controllers只读
返回当前 chrome 窗口的 XUL 控制器对象。
Window.customElements只读
返回对该CustomElementRegistry对象的引用,该对象可用于注册新的自定义元素并获取有关以前注册的自定义元素的信息。
Window.crypto 只读
返回浏览器加密对象。
Window.defaultStatus 自Gecko 23以来已过时
获取/设置给定窗口的状态栏文本。
Window.devicePixelRatio 只读
返回当前显示中物理像素与设备无关像素之间的比率。
Window.dialogArguments 只读
获取在调用window.showModalDialog()时传递给窗口的参数(如果它是一个对话框)。这是一个nsIArray
Window.directories 
      window.personalbar 的同义词。
Window.document 只读
返回窗口包含的文档的引用。
Window.DOMMatrix 只读 
返回DOMMatrix对象的引用,该对象表示4x4矩阵,适用于2D和3D操作。
Window.DOMMatrixReadOnly 只读 
返回DOMMatrixReadOnly对象的引用,该对象表示4x4矩阵,适用于2D和3D操作。
Window.DOMPoint 只读 
返回DOMPoint对象的引用,该对象表示坐标系中的2D或3D点。
Window.DOMPointReadOnly 只读 
返回DOMPointReadOnly对象的引用,该对象表示坐标系中的2D或3D点。
Window.DOMQuad 只读 
返回DOMQuad对象的引用,该对象提供了一个四边形对象,即具有四个角和四条边的对象。
Window.DOMRect 只读 
返回DOMRect对象的引用,它表示一个矩形。
Window.DOMRectReadOnly 只读 
返回DOMRectReadOnly对象的引用,它表示一个矩形。
Window.frameElement 只读
返回嵌入窗口的元素;如果窗口未嵌入,则返回 null。
Window.frames 只读
返回当前窗口中的子帧数组。
Window.fullScreen
此属性指示窗口是否全屏显示。
Window.globalStorage  自Gecko 13以来已过时
自Gecko 13(Firefox 13)以来不受支持。改为使用Window.localStorage
原因是:多个存储对象用于跨多个页面存储数据。
Window.history 只读
返回对历史对象的引用。
Window.innerHeight 只读
获取浏览器窗口内容区域的高度,包括(如果呈现)水平滚动条。
Window.innerWidth 只读
获取浏览器窗口的内容区域的宽度,包括(如果呈现)垂直滚动条。
Window.isSecureContext 只读
指示上下文是否能够使用需要安全上下文的功能。
Window.length 只读
返回窗口中的帧数。另见window.frames
Window.location
获取/设置窗口对象的位置或当前URL。
Window.locationbar 只读
返回位置栏对象,其可见性可以在窗口中切换。
Window.localStorage 只读
返回对本地存储对象的引用,该对象用于存储只能由创建它的原点访问的数据。
Window.menubar 只读
返回菜单栏对象,其可见性可以在窗口中切换。
Window.messageManager
返回此窗口的消息管理器对象。
Window.mozAnimationStartTime 只读 
自当前动画周期开始的时间以毫秒为单位的时间。
Window.mozInnerScreenX 只读
以屏幕坐标返回窗口视口左上角的水平(X)坐标。此值以CSS像素报告。如果有需要,请参阅nsIDOMWindowUtils中的 mozScreenPixelsPerCSSPixel ,以适应屏幕像素的换算系数。
Window.mozInnerScreenY 只读 
以屏幕坐标返回窗口视口左上角的垂直(Y)坐标。此值以CSS像素报告。如果需要,请参阅mozScreenPixelsPerCSSPixel以适应屏幕像素的转换因子。
Window.mozPaintCount 只读
返回当前文档在此窗口中渲染到屏幕的次数。这可以用来计算渲染性能。
Window.name
获取/设置窗口的名称。
Window.navigator 只读
返回对导航器对象的引用。
Window.NetworkInformation 只读 
返回对NetworkInformation接口的引用,该接口提供有关设备用于与网络进行通信的连接的信息,并提供在连接类型更改时通知脚本的方法。 
Window.opener
返回打开当前窗口的窗口的引用。
Window.orientation只读
返回相对于设备自然方向的视口以度为单位(以90度递增)的方向。
Window.outerHeight 只读
获取浏览器窗口外部的高度。
Window.outerWidth 只读
获取浏览器窗口外部的宽度。
Window.pageXOffset 只读
别名window.scrollX
Window.pageYOffset只读
别名 window.scrollY
Window.sessionStorage 只读
返回用于存储数据的会话存储对象的引用,该数据只能由创建它的原点访问。
Window.StaticRange  只读
返回一个创建StaticRange对象的  StaticRange() 构造函数。
Window.parent 只读
返回对当前窗口或子帧的父项的引用。
Window.performance 只读
返回一个Performance对象,其中包含timingnavigation属性,每个对象都是提供与性能相关的数据的对象。
Window.personalbar 只读

返回 personalbar 对象,其可见性可在窗口中切换。

Window.pkcs11 自Gecko 29以来已过时
以前提供了安装和删除 PKCS11 模块的访问权限。
Window.returnValue

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

Window.screen 只读
返回对与窗口关联的屏幕对象的引用。
Window.screenX 只读
从屏幕左侧返回用户浏览器左边框的水平距离。
Window.screenY 只读
从屏幕顶部返回用户浏览器顶部边界的垂直距离。
Window.scrollbars 只读
返回滚动条对象,其可见性可以在窗口中切换。
Window.scrollMaxX只读
窗口可以水平滚动的最大偏移量,即文档宽度减去视口宽度。
Window.scrollMaxY只读
窗口可以垂直滚动的最大偏移量(即文档高度减去视口高度)。
Window.scrollX 只读
返回文档已经水平滚动的像素数。
Window.scrollY 只读
返回文档已经垂直滚动的像素数。
Window.self 只读
返回窗口对象本身的对象引用。
Window.sessionStorage
返回用于在单个页面会话中存储数据的存储对象。
Window.sidebar 只读
返回对侧栏的窗口对象的引用。
Window.speechSynthesis 只读
返回一个SpeechSynthesis对象,这是使用 Web Speech API 语音合成功能的入口点。
Window.status
获取/设置浏览器底部状态栏中的文本。
Window.statusbar 只读
返回状态栏对象,其可见性可以在窗口中切换。
Window.toolbar 只读
返回工具栏对象,其可见性可以在窗口中切换。
Window.top 只读
返回窗口层次结构中最顶层窗口的引用。该属性是只读的。
Window.visualViewport 只读
返回表示给定窗口的可视视口的VisualViewport对象。
Window.window 只读
返回对当前窗口的引用。
window[0] window[1]等等。
返回对框架中的window对象的引用。查看Window.frames获得更多信息。

从别处实施的属性

WindowOrWorkerGlobalScope.caches 只读
返回与当前上下文关联的CacheStorage对象。该对象启用了功能,例如存储资产以供离线使用,并生成对请求的自定义响应。
WindowOrWorkerGlobalScope.indexedDB 只读
为应用程序异步访问索引数据库提供了一种机制;返回一个IDBFactory对象。
WindowOrWorkerGlobalScope.isSecureContext 只读
返回一个布尔值,指示当前上下文是否安全(true)或不(false)。
WindowOrWorkerGlobalScope.origin 只读
返回全局对象的原点,串行化为一个字符串。(这在目前还没有在任何浏览器中实现。)

window方法

该接口从 EventTarget 接口继承方法并实现来自 WindowOrWorkerGlobalScope 和 EventTarget 的方法。

Window.alert()
显示一个警告对话框。
Window.back()  

在窗口历史记录中向后移动一个。

Window.blur()
将焦点从窗口中移开。
Window.cancelAnimationFrame() 
使您能够使用Window.requestAnimationFrame取消之前计划的回调。
Window.cancelIdleCallback() 
使您能够使用Window.requestIdleCallback取消之前计划的回调。
Window.captureEvents() 
注册窗口以捕获指定类型的所有事件。
Window.clearImmediate()
使用setImmediate取消重复执行集。
Window.close()
关闭当前窗口。
Window.confirm()
显示一个对话框,其中包含用户需要回复的消息。
Window.disableExternalCapture() 自Gecko 24以来已过时
FIXME: NeedsContents
Window.dispatchEvent()
用于触发事件。
Window.dump() 
将消息写入控制台。
Window.enableExternalCapture() 自Gecko 24以来已过时
FIXME: NeedsContents
Window.find()
在窗口中搜索给定的字符串。
Window.focus()
集中于当前窗口。
Window.forward()  
将历史记录中的窗口向前移动一个文档。
Window.getAttention()  
闪烁应用程序图标。
Window.getAttentionWithCycleCount()
FIXME: NeedsContents
Window.getComputedStyle()
获取指定元素的计算样式。计算样式表示元素的所有 CSS 属性的计算值。
Window.getDefaultComputedStyle() 
获取指定元素的默认计算样式,忽略作者样式表。
Window.getSelection()
返回代表所选项目的选择对象。
Window.home()  
将浏览器返回到主页。
Window.matchMedia()
返回表示指定媒体查询字符串的MediaQueryList对象。
Window.maximize()
FIXME: NeedsContents
Window.minimize() (仅限顶级XUL窗口)
最小化窗口。
Window.moveBy()
将当前窗口移动指定量。
Window.moveTo()
将窗口移动到指定的坐标。
Window.open()
打开一个新窗口。
Window.openDialog()  
打开一个新的对话窗口。
Window.postMessage()
为一个窗口提供一种安全的方法,将一串数据发送到另一个窗口,该窗口不必与第一个窗口位于同一个域中。
Window.print()
打开“打印(Print)”对话框打印当前文档。
Window.prompt()
返回用户在提示对话框中输入的文本。
Window.releaseEvents()  
从捕获特定类型的事件中释放该窗口。
Window.requestAnimationFrame()
告诉浏览器正在进行动画,请求浏览器为下一个动画帧计划重新绘制窗口。
Window.requestIdleCallback()  
在浏览器空闲期间启用任务计划。
Window.resizeBy()
调整当前窗口的大小。
Window.resizeTo()
动态调整窗口大小。
Window.restore()  
FIXME: NeedsContents
Window.routeEvent() 自Gecko 24以来已过时
FIXME: NeedsContents
Window.scroll()
将窗口滚动到文档中的特定位置。
Window.scrollBy()
按给定量滚动窗口中的文档。
Window.scrollByLines() 
按给定的行数滚动文档。
Window.scrollByPages() 
将当前文档滚动指定的页数。
Window.scrollTo()
滚动到文档中的一组特定坐标。
Window.setCursor()  (仅限顶级XUL窗口)
更改当前窗口的光标
Window.setImmediate()
浏览器完成其他繁重任务后执行一项功能
Window.setResizable() 
切换用户调整窗口大小的功能。
Window.sizeToContent() 
根据其内容调整窗口大小。
Window.stop()
此方法停止窗口加载。
Window.updateCommands() 
更新当前 chrome 窗口(UI)的命令状态。

从别处实施的方法

EventTarget.addEventListener()
在窗口上注册一个事件处理程序到特定的事件类型。
WindowOrWorkerGlobalScope.atob()
对已使用 base-64 编码进行编码的数据字符串进行解码。
WindowOrWorkerGlobalScope.btoa()
从一串二进制数据创建一个 base-64 编码的 ASCII 字符串。
WindowOrWorkerGlobalScope.clearInterval()
使用WindowOrWorkerGlobalScope.setInterval()取消重复执行集。
WindowOrWorkerGlobalScope.clearTimeout()
使用WindowOrWorkerGlobalScope.setTimeout()取消延迟执行集。
WindowOrWorkerGlobalScope.createImageBitmap()
接受各种不同的图像源,并返回一个Promise解析为ImageBitmap。可选地,源被裁剪成源自(sx,sy),宽度为 sw,高度为 sh 的像素的矩形。
WindowOrWorkerGlobalScope.fetch()
开始从网络获取资源的过程。
EventTarget.removeEventListener
从窗口中删除事件侦听器。
WindowOrWorkerGlobalScope.setInterval()
计划每次经过给定数量的毫秒时执行的函数。
WindowOrWorkerGlobalScope.setTimeout()
安排一个函数在给定的时间内执行。

过时的方法

Window.showModalDialog() 
显示模式对话框。在Chrome 43和Firefox 55中完全删除了此方法。

事件处理程序

这些 window 对象的属性可以设置为建立事件处理程序,以处理可能感兴趣的窗口中可能发生的各种事件。

该接口从 EventTarget 接口继承事件处理程序,并从 WindowEventHandlers 实现事件处理程序。

注意:从 Gecko 9.0 开始,您现在可以使用语法“if ("onabort" in window)”来确定是否存在给定的事件处理程序属性。这是因为事件处理程序接口已更新为适当的 Web IDL 接口。

GlobalEventHandlers.onabort
当资源加载已被中止时调用,例如用户在仍在进行时取消加载。
WindowEventHandlers.onafterprint
打印对话框关闭时调用。参考afterprint事件。
WindowEventHandlers.onbeforeprint
当打印对话框打开时调用。参考beforeprint事件。
Window.onbeforeinstallprompt
在提示用户将网站保存到移动主屏幕之前分派的事件处理程序属性。
WindowEventHandlers.onbeforeunload
窗口上的事件处理程序属性,用于在窗口之前卸载事件。
GlobalEventHandlers.onblur
在窗口失去焦点后调用,例如由于弹出窗口。
GlobalEventHandlers.onchange
窗口上的更改事件的事件处理程序属性。
GlobalEventHandlers.onclick
在按下并释放 ANY 鼠标键后调用。
GlobalEventHandlers.ondblclick
当使用任何鼠标按钮进行双击时调用。
GlobalEventHandlers.onclose
窗口关闭后调用。
GlobalEventHandlers.oncontextmenu
当按下鼠标右键时调用。
Window.ondevicelight
任何 light 级别的事件处理程序属性都将发生更改。
Window.ondevicemotion
如果加速计检测到更改,则调用(对于移动设备)。
Window.ondeviceorientation
当方向改变时调用(对于移动设备)。
Window.ondeviceorientationabsolute  仅限Chrome
任何设备方向更改的事件处理程序属性。
Window.ondeviceproximity
设备接近事件的事件处理程序属性
GlobalEventHandlers.onerror
在资源加载失败时调用,或者在运行时发生错误时调用。参考error事件。
GlobalEventHandlers.onfocus
在窗户收到或重新获得焦点后调用。查看focus活动。
WindowEventHandlers.onhashchange
窗口上hashchange事件的事件处理程序属性;当哈希标记(“#”)之后的 URL 部分发生更改时调用。
Window.onappinstalled
当页面被安装为 web 应用程序时调用。查看appinstalled事件。
Window.ongamepadconnected
表示一个事件处理程序,当游戏板连接时(gamepadconnected事件触发时)将运行。
Window.ongamepaddisconnected
表示一个事件处理程序,当游戏板断开连接时(gamepaddisconnected事件触发时)将运行。
Window.oninput
当 <input> 元素的值更改时调用。
GlobalEventHandlers.onkeydown
当您开始按任意键时调用。查看keydown事件。
GlobalEventHandlers.onkeypress
当按键(Shift,Fn 和 CapsLock 除外)处于按下位置时调用。查看keypress事件。
GlobalEventHandlers.onkeyup
当您完成释放任何密钥时调用。查看keyup事件。
WindowEventHandlers.onlanguagechange
窗口上languagechange事件的事件处理程序属性。
GlobalEventHandlers.onload
在所有资源和 DOM 完全加载后调用。当页面从缓存中加载时不会被调用,比如后退按钮。
WindowEventHandlers.onmessage
是一个EventHandler表示在引发message事件时要调用的代码。
GlobalEventHandlers.onmousedown
当按下任何鼠标键时调用。
GlobalEventHandlers.onmousemove
当鼠标移动到窗口内时连续调用。
GlobalEventHandlers.onmouseout
指针离开窗口时调用。
GlobalEventHandlers.onmouseover
当指针进入窗口时调用。
GlobalEventHandlers.onmouseup
当任何鼠标按钮被释放时调用。
Window.onmozbeforepaint
   MozBeforePaint事件的事件处理程序属性,如果事件已被Window.mozRequestAnimationFrame()方法调用请求,则在重新绘制窗口之前发送此事件。
WindowEventHandlers.onoffline
当网络连接丢失时调用。查看offline事件。
WindowEventHandlers.ononline
网络连接建立时调用。查看online事件。
WindowEventHandlers.onpagehide
在 onunload 事件之前,当用户从页面导航离开页面时调用。查看pagehide事件。
WindowEventHandlers.onpageshow
在所有资源和 DOM 完全加载后调用。查看pageshow事件。
Window.onpaint
窗口上的 paint 事件的事件处理程序属性。
WindowEventHandlers.onpopstate
当按下后退按钮时调用。
Window.onrejectionhandled 
处理Promise拒绝事件的事件处理程序。
GlobalEventHandlers.onreset
当表单重置时调用。
GlobalEventHandlers.onresize
在您调整窗口大小时连续调用。
GlobalEventHandlers.onscroll
当通过 ANY 方式移动滚动条时调用。如果资源完全适合窗口,则不能调用此事件。
GlobalEventHandlers.onwheel
当鼠标滚轮围绕任何轴旋转时调用。
GlobalEventHandlers.onselect
在输入字段中的文本被选中后调用。
GlobalEventHandlers.onselectionchange
是一个EventHandler表示在selectionchange引发事件时要调用的代码。
WindowEventHandlers.onstorage
当会话存储或本地存储发生更改时调用。查看storage事件。
GlobalEventHandlers.onsubmit
在提交表单时调用。
WindowEventHandlers.onunhandledrejection 
未处理的Promise拒绝事件的事件处理程序。
WindowEventHandlers.onunload
当用户离开页面时调用。
Window.onuserproximity
用户邻近事件的事件处理程序属性。
Window.onvrdisplayconnect
表示当兼容 VR 设备连接到计算机时(vrdisplayconnected事件触发时)将运行的事件处理程序。
Window.onvrdisplaydisconnect
表示一个事件处理程序,当兼容 VR 设备与计算机断开连接时(vrdisplaydisconnected事件触发时)将运行该事件处理程序。
Window.onvrdisplayactivate
表示一个事件处理程序,当显示器能够呈现给(当vrdisplayactivate事件触发时)时将运行,例如,如果已经移动 HMD 以使其脱离待机状态或被戴上被唤醒。
Window.onvrdisplaydeactivate
代表一个事件处理程序,当显示器不能再显示时(vrdisplaydeactivate事件触发时),例如如果 HMD 由于一段时间不活动而进入待机模式或睡眠模式,将运行该事件处理程序。
Window.onvrdisplayblur
表示一个事件处理程序,当浏览器,操作系统或 VR 硬件由于某种原因(当vrdisplayblur事件触发时)由于某种原因而导致显示暂停时(例如用户正在与系统菜单或浏览器交互时)防止跟踪或失​​去经验。
Window.onvrdisplayfocus
表示一个事件处理程序,当模糊后(当vrdisplayfocus事件触发时)呈现给显示器时,该事件处理程序将运行。
Window.onvrdisplaypresentchange
表示当 VR 设备的呈现状态改变时将运行的事件处理程序 - 即从呈现到呈现,或反之亦然(当vrdisplaypresentchange事件触发时)。

window构造函数

另请参阅 DOM 接口。

DOMParser
DOMParser 可以将存储在字符串中的 XML 或 HTML 源解析为 DOM  文档,在 DOM 分析和序列化中指定DOMParser
Window.GeckoActiveXObject
FIXME: NeedsContents
Image
用于创建一个HTMLImageElement
Option
用于创建一个 HTMLOptionElement
Window.QueryInterface
FIXME: NeedsContents
Window.XMLSerializer
FIXME: NeedsContents
Worker
用于创建 Web worker
Window.XPCNativeWrapper
FIXME: NeedsContents
Window.XPCSafeJSObjectWrapper
FIXME: NeedsContents

window接口

请参阅 DOM 参考

浏览器兼容性

电脑端 移动端
Chrome
Edge
Firefox
Internet Explorer
Opera
Safari
Android webview
Chrome for Android
Edge Mobile Firefox for Android
Opera for Android
iOS Safari
基本支持 支持:1 支持:12 支持:1 支持 支持 支持 支持 支持:1 支持:12 支持:4 支持 支持
以上内容是否对您有帮助:

您可能还喜欢:

在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号

意见反馈
返回顶部