Объект window
представляет собой окно, содержащее DOM документ; свойство document
указывает на DOM document, загруженный в данном окне. Окно текущего документа может быть получено с помощью свойства document.defaultView
.
Данный раздел содержит описание всех методов, свойств и событий, доступных через объект window
DOM. Объект window
реализует интерфейс Window
, который наследуется от интерфейса AbstractView
. Некоторые дополнительные глобальные функции, пространства имен объектов, интерфейсы и конструкторы, как правило, не связаные с окном, но доступные в нем, перечислены в JavaScript ссылки и DOM ссылки.
В браузерах, поддерживающих вкладки, таком как Firefox, каждая вкладка содержит свой собственный объект window
(и если вы пишете расширение, окно браузера тоже является отдельным объектом window - см. Работа с окнами в chrome коде). Таким образом, объект window
не разделяется между разными вкладками в одном и том же окне. Некоторые методы, а именно window.resizeTo
и window.resizeBy
применяеются для всего окна и не принадлежат объекту window
отдельной вкладки. Как правило, если что-то логически нельзя отнести ко вкладке, это относят к окну.
Свойства
Данный интерфейс наследует свойства из интерфейса EventTarget
и реализует свойства из WindowOrWorkerGlobalScope
и миксин WindowEventHandlers
.
Отметим, что свойства, являющиеся объектами (например, перезаписанные прототипы встроенных элементов), перечислены в отдельном разделе ниже.
Window.applicationCache
Только для чтения- Объект
OfflineResourceList
, обеспечивающий для окна доступ к ресурсам вне сети. Window.closed
Только для чтения- Свойство, указывающее было ли текущее окно закрыто или нет.
Window.Components
- Точка доступа к богатому функционалу XPCOM. Некоторые свойства, т.к. classes, доступны только для достаточно привелегированного кода. Web-код не должен использовать эти свойства.
Window.console
Только для чтения- Возвращает ссылку на объект консоли, обеспечивающего доступ к консоли браузера.
Window.content
and Window._content Только для чтения- Возвращает ссылку на элемент содержимого в текущем окне. Устаревший вариант в нижним подчеркиванием более не доступен для Web-содержимого.
Window.controllers
Только для чтения- Возвращает XUL контроллер объектов для текущего окна chrome.
Window.crypto
Только для чтения- Возвращает зашифрованный объект браузера.
Window.defaultStatus
Вышла из употребления с версии Gecko 23- Получает/устанавливает текст статус-бара для данного окна.
Window.devicePixelRatio
Только для чтения- Возвращает соотношение между физическими пикселями и пикселями на дисплее текущего устройства.
Window.dialogArguments
Только для чтения- Получает аргументы, переданные в окно (если это диалоговое окно) в момент вызова
window.showModalDialog()
. ЭтоnsIArray
. Window.directories
- Синоним
window.personalbar
Window.document
Только для чтения- Возвращает ссылку на содержащийся в окне документ.
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
Только для чтения- Возвращает объект locationbar, который может быть добавлен и убран из окна.
Window.localStorage
Только для чтения- Возвращает ссылку на локальный объект хранилища, используемый для хранения данных, которые могут быть доступны только первоисточникам, создавшим их.
Window.menubar
Только для чтения- Возвращает объект menubar, который может быть добавлен и убран из окна.
Window.messageManager
- Возвращает объект message manager для окна.
Window.mozAnimationStartTime
Только для чтения- Время в миллисекундах с момента начала цикла данной анимации.
Window.mozInnerScreenX
Только для чтения- Возвращает горизонтальную (X) координату верхнего левого угла окна просмотра в экранных координатах. Значение возвращается в CSS-пикселях. Смотри
mozScreenPixelsPerCSSPixel
вnsIDOMWindowUtils
для конвертирования и адаптирования к экранным пикселям, если необходимо. Window.mozInnerScreenY
Только для чтения- Возвращает вертикальные (Y) координаты верхнего левого угла окна просмотра в экранных координатах. Значение возвращается в CSS-пикселях. Смотри
mozScreenPixelsPerCSSPixel
для конвертирования и адаптирования к экранным пикселям, если необходимо. Window.mozPaintCount
Только для чтения- Возвращает количество раз, за которые текущий документ был отрендерен для текущего экрана в этом окне. Может быть использовано для подсчета скорости преобразования.
Window.name
- Получает/устанавливает имя для окна.
Window.navigator
Только для чтения- Возвращает ссылку на объект навигатора.
Window.opener
- Возвращает ссылку на окно, открывшее текущее окно.
Window.orientation
Только для чтения- Возвращает ориентировку в градусах (с увеличением на 90 градусов) окна просмотра относительно настоящей ориентировки устройства.
Window.outerHeight
Только для чтения- Получает высоту вместе с внешней частью браузерного окна.
Window.outerWidth
Только для чтения- Получает ширину вместе с внешней частью браузерного окна.
Window.pageXOffset
Только для чтения- Псевдоним для
window.scrollX
. Window.pageYOffset
Только для чтения- Псевдоним для
window.scrollY
Window.sessionStorage
Только для чтения- Возвращает ссылку на объект хранения сессии, используемый для хранения данных, которые могут быть получены только источником, создавшим их.
Window.parent
Только для чтения- Возвращает ссылку на родителя текущего окна или встроеного фрейма.
Window.performance
Только для чтения- Обеспечивает главенствующее пространство для аттрибутов, относящихся к производительности.
Window.personalbar
Только для чтения- Возвращает объект personalbar, который может быть добавлен и убран из окна.
Window.pkcs11
Вышла из употребления с версии Gecko 29- Раньше предоставлял доступ к установке и удалению PKCS11 модуля.
Window.returnValue
- Возвращаемое значение, которое будет передано в функцию, которая вызвала
window.showModalDialog()
для отображения окна как модального диалога. Window.screen
Только для чтения- Возвращает ссылку на объект экрана, ассоциируемый с окном.
Window.screenX
Только для чтения- Возвращает горизонтальный размер левой рамки браузера пользователя с левой стороны экрана.
Window.screenY
Только для чтения- Возвращает вертикальный размер верхней рамки браузера пользователя с верхней стороны экрана.
Window.scrollbars
Только для чтения- Возвращает объект scrollbars, который может быть добавлен и убран из окна.
Window.scrollMaxX
Только для чтения- Максимальный отступ, на который может быть проскроллено окно по горизонтали, состоящее из разницы ширины документа и ширины области просмотра.
Window.scrollMaxY
Только для чтения- Максимальный отступ, на который может быть проскроллено окно по вертикали, (т.е., разница высоты документа и высоты области просмотра).
Window.scrollX
Только для чтения- Возвращает число пикселей, на которое документ уже был проскроллен по горизонтали.
Window.scrollY
Только для чтения- Возвращает число пикселей, на которое документ уже был проскроллен по вертикали.
Window.self
Только для чтения- Возвращает ссылку на самого себя.
Window.sessionStorage
- Возвращает объект хранилища для данных в пределах сессии одной страницы.
Window.sidebar
Только для чтения- Возвращает ссылку на объект окна sidebar.
Window.speechSynthesis
Только для чтения- Возвращает объект
SpeechSynthesis
, который является точкой входа для использования Web Speech API, функционала для речевого синтеза. Window.status
- Получает/устанавливает тект в statusbar внизу браузера.
Window.statusbar
Только для чтения- Возвращает объект statusbar, который может быть добавлен и убран из окна.
Window.toolbar
Только для чтения- Возвращает объект toolbar, который может быть добавлен и убран из окна.
Window.top
Только для чтения- Возвращает ссылку на самое первое окно в иерархии текущих окон. Только для чтения.
Window.window
Только для чтения- Возвращает ссылку на текущее окно.
window[0]
,window[1]
, etc.- Возвращает ссылку на объект окна во фреймах. Смотри
Window.frames
.
Свойства, реализованные из других мест
WindowOrWorkerGlobalScope.caches
Только для чтения- Возвращает объект
CacheStorage
, связанный с текущим контекстом. Этот объект добавляет такой функционал как хранение ресурсов для использования вне сети и генерирования встроенных ответов на запросы. WindowOrWorkerGlobalScope.indexedDB
Только для чтения- Обеспечивает механизм для приложений для возможности асинхронного доступа индексированных баз данных; возвращает объект
IDBFactory
. WindowOrWorkerGlobalScope.isSecureContext
Только для чтения- Возвращает булеановское занчение, указывающее является ли текущий контент безопасным (
true
) или нет (false
). WindowOrWorkerGlobalScope.origin
Только для чтения- Возаращает источник глобального объекта, преобразованного в строку. (Это свойство пока еще не существует, поэтому не может быть использовано в браузерах.)
Методы
Этот интерфейс наследует методы от интерфейса EventTarget
и реализует свойства WindowOrWorkerGlobalScope
и EventTarget
.
Window.alert()
- Отображает предупреждающее диалоговое окно.
Window.back()
- Возвращается на один шаг назад в истории окна.
Window.blur()
- Убирает фокус с окна.
Window.cancelIdleCallback()
- Позволяет отменить функцию обратного вызова прежде чем определить расписание ее выозва с
Window.requestIdleCallback
. Window.captureEvents()
- Регестрирует окно, которое будет перехватывать все события опереденного типа.
Window.clearImmediate()
- Отменяет повторяющееся исполнение, установленное с помощью
setImmediate
. WindowTimers.clearInterval()
- Отменяет повторяющееся исполнене, установленное с помощью
WindowTimers.setInterval()
. WindowTimers.clearTimeout()
- Отменяет повторяющееся исполнене, установленное с помощью
WindowTimers.setTimeout()
. Window.close()
- Закрывает текущее окно.
Window.confirm()
- Отображает диалог с сообщением, на которое пользователь должен ответить.
Window.disableExternalCapture()
Вышла из употребления с версии Gecko 24- FIXME: NeedsContents
Window.dispatchEvent()
- Используется для вызова события.
Window.dump()
- Отправляет сообщение в консоль.
Window.enableExternalCapture()
Вышла из употребления с версии Gecko 24- FIXME: NeedsContents
Window.find()
- Ищет необходимую строку в окне window.
Window.focus()
- Устанавливает фокус на текущем окне.
Window.forward()
- Переходит на один документ вперед в текущей истории окна.
Window.getAttention()
- Заставляет мигать иконку приложения.
Window.getAttentionWithCycleCount()
- FIXME: NeedsContents
Window.getComputedStyle()
- Получает подсчитанные стили для определенного элемента. Подсичтанные стили включают подсчитанные занчения всех CSS свойств элемента.
Window.getDefaulComputedStyle()
- Получает подсчитанные стили по умолчанию для определенного элемента, игнорируя авторские стили.
Window.getSelection()
- Возвращает выбранный объект, представляющий выбранный элемент(ы).
Window.home()
- Возаращает браузер на домашнюю страницу.
Window.matchMedia()
- Возвращает объект
MediaQueryList
, представляющий указанную строку медиа-запроса. Window.maximize()
- FIXME: NeedsContents
Window.minimize()
(top-level XUL windows only)- Минимизирует окно.
Window.moveBy()
- Сдвигает текущее окно на определенное значение.
Window.moveTo()
- Сдвигает окно до определенных координат.
Window.mozRequestAnimationFrame()
- Cообщает браузеру, что анимация находится в прогрессе, требуя, чтобы браузер определил время перерисовки окна для следующего анимационного фрейма. Это вызовет событие
MozBeforePaint,
прежде чем произойдет перерисовка . Window.open()
- Открывает новое окно.
Window.openDialog()
- Opens a new dialog window.
Window.postMessage()
- Предоставляет безопасный способ для одного окна передать строку с данными в другое окно, которое должно находиться в пределах того же домена, что и первое.
Window.print()
- Открывет Print Dialog для распечатки текущего документа.
Window.prompt()
- Возвращает текст, введенный пользователем в диалоге подсказки.
Window.releaseEvents()
- Возвращает окно с захваченных событий определенного типа.
Window.removeEventListener()
- Удаляет слушателя события из окна.
Window.requestIdleCallback()
- Позволяет назначить раписание задачь во время периода простоя браузера.
Window.resizeBy()
- Меняет размер текущего окна на определенное число.
Window.resizeTo()
- Динамически меняет размер окна.
Window.restore()
- FIXME: NeedsContents
Window.routeEvent()
Вышла из употребления с версии Gecko 24- FIXME: NeedsContents
Window.scroll()
- Scrolls the window to a particular place in the document.
Window.scrollBy()
- Прокручивает документ в окна на данное число.
Window.scrollByLines()
- Прокурчивает документ на данное число строк.
Window.scrollByPages()
- Прокурчивает документ на данное число стараниц.
Window.scrollTo()
- Прокручивает до заданных координат в документе.
Window.setCursor()
- Меняет курсор для текущего окна.
Window.setImmediate()
- Исполняет функцию после того, как браузер некую тяжелую задачу.
WindowTimers.setInterval()
- Назначает выполнение функции каждые X миллисекунд.
Window.setResizable
- FIXME: NeedsContents
WindowTimers.setTimeout()
- Устанавливает отложенное выполнение функции.
Window.showModalDialog()
- Отображает модальный диалог.
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, которые могут устанавливаться для перехвата всех событий, которые могут происходить с объектом window.
Интерфейс наследует обработчики событий от EventTarget
интерфейса и реализует обработчики событий WindowEventHandlers
.
Замета: Начиная с Gecko 9.0, вы можете использовать синтаксис if ("onabort" in window),
чтобы определить существует ли обработчик данного события. Интерфейсы обработчиков событий были обновлеы таким образом, чтобы соответсовать web IDL интерфейсам. Смотри обработчики собыйти DOM для деталей.
GlobalEventHandlers.onabort
- Обработчик события для отмены событий в окне.
WindowEventHandlers.onafterprint
- Вызывается, когда закрывается диалоговое окно распечатки. Смотри событие
afterprint
. WindowEventHandlers.onbeforeprint
- Вызывается, когда открывается диалоговое окно распечатки. Смотри событие
beforeprint
. Window.onbeforeinstallprompt
- Событие вызывается прежде чем пользователь согласится сохранить сайт на домашний экран на мобильном устройстве.
WindowEventHandlers.onbeforeunload
- Событие вызывается перед удалением события из окна.
GlobalEventHandlers.onblur
- Свойство обработчика событий для исчезновение фокуса на окне.
GlobalEventHandlers.onchange
- Свойство обработчика событий для изменения в окне.
GlobalEventHandlers.onclick
- Свойство обработчика событий для клика в окне.
GlobalEventHandlers.ondblclick
- Вызывается, когда был сделан двойной клик ЛЮБОЙ кнопкой мыши.
GlobalEventHandlers.onclose
- Свойство обработчика событий для обработки закрытия окна.
GlobalEventHandlers.oncontextmenu
- Свойство обработчика событий для правого клика в окне.
Window.ondevicelight
- Свойство обработчика событий для отслеживания изменения уровня света.
- {domxref("Window.ondevicemotion")}}
- Вызывается, если было определено изменение акселерометра (для мобильных устройств).
Window.ondeviceorientation
- Вызывается, когда была изменена ориентация (для мобильных устройств).
Window.ondeviceorientation
- Свойство обработчика событий для смены ориентации любого устройства.
Window.ondeviceproximity
- Свойство обработчика событий для определения близости устройства.
GlobalEventHandlers.onerror
- Свойство обработчика событий для события
error
, возникшего в окне. GlobalEventHandlers.onfocus
- Свойство обработчика событий для события
focus
в окне. WindowEventHandlers.onhashchange
- Свойство обработчика событий для отлова изменения хэша в окне; вызывается, когда часть URL после ("#") была изменена.
Window.onappinstalled
- Вызывается, когда страница установлена, как приложение. Смотри
appinstalled
событие. Window.oninput
- Вызывается, когда значение элемента <input> было изменено.
GlobalEventHandlers.onkeydown
- Свойство обработчика событий для события
keydown
в окне. GlobalEventHandlers.onkeypress
- Свойство обработчика событий для события
keypress
в окне. GlobalEventHandlers.onkeyup
- Свойство обработчика событий для события
keyup
в окне. WindowEventHandlers.onlanguagechange
- Свойство обработчика событий для события
languagechange
в окне. GlobalEventHandlers.onload
- Свойство обработчика событий для загрузки окна.
WindowEventHandlers.onmessage
EventHandler
, представляющий собой код, который будет вызван, когда произойдет событиеmessage
.GlobalEventHandlers.onmousedown
- Свойство обработчика событий для события mousedownв окне.
GlobalEventHandlers.onmousemove
- Свойство обработчика событий для события mousemove в окне.
GlobalEventHandlers.onmouseout
- Свойство обработчика событий для события mouseout в окне.
GlobalEventHandlers.onmouseover
- Свойство обработчика событий для события mouseover в окне.
GlobalEventHandlers.onmouseup
- Свойство обработчика событий для события mouseup в окне.
Window.onmozbeforepaint
- Свойство обработчика событий для события
MozBeforePaint
, которое присылается прежде чем окно будет перерисовано, если событие необходимо из-за вызова методаWindow.mozRequestAnimationFrame()
. WindowEventHandlers.onoffline
- Вызывается, когда было потеряно соединение с сетью. Смотри событие
offline
. WindowEventHandlers.ononline
- Вызывается, когда соединение с сетью было установлено. Смотри событие
online
. WindowEventHandlers.onpageshow
- Свойство обработчика событий для события pageshow в окне.
WindowEventHandlers.onpagehide
- Свойство обработчика событий для события pagehide в окне.
Window.onpaint
- Свойство обработчика событий для события paint в окне.
WindowEventHandlers.onpopstate
- Вызывается, когда была нажата кнопка назад.
Window.onrejectionhandled
- Свойство обработчика событий для обработки отказа события
Promise
. GlobalEventHandlers.onreset
- Свойство обработчика событий для события reset в окне.
GlobalEventHandlers.onresize
- Свойство обработчика событий для изменения размера окна.
GlobalEventHandlers.onscroll
- Свойство обработчика событий для прокрутки окна.
GlobalEventHandlers.onwheel
- Вызывается, когда ыло прокручено колесико мыши в любую сторону.
GlobalEventHandlers.onselect
- Свойство обработчика событий для события выбора в окне.
GlobalEventHandlers.onselectionchange
EventHandler
, представлющий собой код, который будет вызван, когда проихойдет событиеselectionchange
.GlobalEventHandlers.onsubmit
- Свойство обработчика событий для события submits в окне формы.
WindowEventHandlers.onunhandledrejection
- Свойство обработчика событий для отвязки обработчика отказа события
Promise
. Window.onunload
- Свойство обработчика событий для события unload в окне.
Window.onuserproximity
- Свойство обработчика событий для события изменения близости пользоватя к устройству.
Window.onvrdisplayconnected
- Представляет обработчик события, который будет запущен, когда подходящее устройство виртуальной реальности было присоединено к компьютеру (когда запускается событие
vrdisplayconnected
). Window.onvrdisplaydisconnected
- Представляет обработчик события, который будет запущен, когда подходящее устройство виртуальной реальности было отсоединено от компьютера (когда запускается событие
vrdisplaydisconnected
). Window.onvrdisplaypresentchange
- Представляет обработчик события, который будет запущен, когда изменится состояние устройства виртуальной реальности — т.е. перейдет от представленного к непредставленному или наоборот (когда будет запущено событие
onvrdisplaypresentchange
).
Конструкторы
Смотри так же DOM Interfaces.
Window.ConstantSourceNode
- Создает экземпляр
ConstantSourceNode
Window.DOMParser
- FIXME: NeedsContents
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
Интерфейс
Смотри DOM Reference