Window
======

Объект `window` представляет собой окно, содержащее DOM документ; свойство `document` указывает на DOM document (en-US), загруженный в данном окне. Окно текущего документа может быть получено с помощью свойства `document.defaultView`.

Данный раздел содержит описание всех методов, свойств и событий, доступных через объект `window` DOM. Объект `window` реализует интерфейс `Window`, который наследуется от интерфейса `AbstractView`. Некоторые дополнительные глобальные функции, пространства имён объектов, интерфейсы и конструкторы, как правило, не связанные с окном, но доступные в нем, перечислены в JavaScript ссылки и DOM ссылки.

В браузерах, поддерживающих вкладки, таком как Firefox, каждая вкладка содержит свой собственный объект `window` (и если вы пишете расширение, окно браузера тоже является отдельным объектом window - см. Работа с окнами в chrome коде). Таким образом, объект `window` не разделяется между разными вкладками в одном и том же окне. Некоторые методы, а именно `window.resizeTo` (en-US) и `window.resizeBy` (en-US) применяется для всего окна и не принадлежат объекту `window` отдельной вкладки. Как правило, если что-то логически нельзя отнести ко вкладке, это относят к окну.

Свойства
--------

*Данный интерфейс наследует свойства из интерфейса `EventTarget`.*

Отметим, что свойства, являющиеся объектами (например, перезаписанные прототипы встроенных элементов), перечислены в отдельном разделе ниже.

`Window.caches` Только для чтения 

Возвращает объект `CacheStorage`, связанный с текущим контекстом. Этот объект добавляет такой функционал как хранение ресурсов для использования вне сети и генерирования встроенных ответов на запросы.

`Window.closed` 
Non-standard
Только для чтения 

Свойство, указывающее было ли текущее окно закрыто или нет.

`Window.Components` 
Non-standard

Точка доступа к богатой функциональности XPCOM. Некоторые свойства, т.к. classes, доступны только для достаточно привилегированного кода. **Web-код не должен использовать эти свойства.**

`Window.console` 
Non-standard
 Только для чтения 

Возвращает ссылку на объект консоли, обеспечивающего доступ к консоли браузера.

`Window.content` (en-US) and Window.content 
Non-standard
Только для чтения 

Возвращает ссылку на элемент содержимого в текущем окне. Устаревший вариант в нижним подчёркиванием более не доступен для Web-содержимого.

`Window.controllers`
Non-standard
Только для чтения 

Возвращает XUL контроллер объектов для текущего окна chrome.

`Window.crypto` Только для чтения 

Возвращает зашифрованный объект браузера.

`Window.defaultStatus`

Получает/устанавливает текст статус-бара для данного окна.

`Window.devicePixelRatio` 
Non-standard
Только для чтения 

Возвращает соотношение между физическими пикселями и пикселями на дисплее текущего устройства.

`Window.dialogArguments` Только для чтения 

Получает аргументы, переданные в окно (если это диалоговое окно) в момент вызова `window.showModalDialog()` (en-US). Это `nsIArray`.

`Window.directories`

Синоним `window.personalbar` (en-US)

`Window.document` Только для чтения 

Возвращает ссылку на содержащийся в окне документ.

`Window.frameElement` Только для чтения 

Возвращает элемент, в который встроено окно, или null, если оно не встроено.

`Window.frames` Только для чтения 

Возвращает массив дополнительных фреймов в текущем окне.

`Window.fullScreen` (en-US)

Это свойство указывает, отображается ли окно в полноэкранном режиме или нет.

`Window.globalStorage` 
Non-standard

Не поддерживает с Gecko 13 (Firefox 13). Использовать вместо него`Window.localStorage`. Было: Множественные объекты хранения, которые используются для хранения данных на нескольких страницах.

`Window.history` Только для чтения 

Возвращает ссылку на объект истории.

`Window.indexedDB` (en-US) Только для чтения 

Обеспечивает механизм для приложений для возможности асинхронного доступа индексированных баз данных; возвращает объект `IDBFactory` (en-US).

`Window.innerHeight`

Получает высоту области содержимого окна браузера, включая, если есть, горизонтальный скроллбар.

`window.innerWidth` (en-US)

Получает ширину области содержимого окна браузера, включая, если есть, вертикальный скроллбар.

`Window.isSecureContext` (en-US) Только для чтения 

Возвращает булевское значение, указывающее является ли текущий контент безопасным (`true`) или нет (`false`).

`Window.length` Только для чтения 

Возвращает число фреймов в окне. Смотрите также `window.frames`.

`Window.location` Только для чтения 

Получает/устанавливает расположение или текущий URL для текущего объекта окна.

`Window.locationbar` (en-US) Только для чтения 

Возвращает объект locationbar, который может быть добавлен и убран из окна.

`Window.localStorage` Только для чтения 

Возвращает ссылку на локальный объект хранилища, используемый для хранения данных, которые могут быть доступны только первоисточникам, создавшим их.

`Window.menubar` (en-US) Только для чтения 

Возвращает объект menubar, который может быть добавлен и убран из окна.

`Window.messageManager`

Возвращает объект message manager для окна.

`Window.mozAnimationStartTime` Только для чтения 

Время в миллисекундах с момента начала цикла данной анимации.

`Window.mozInnerScreenX` (en-US) Только для чтения 
Non-standard

Возвращает горизонтальную (X) координату верхнего левого угла окна просмотра в экранных координатах. Значение возвращается в CSS-пикселях. Смотри `mozScreenPixelsPerCSSPixel` в `nsIDOMWindowUtils` для конвертирования и адаптирования к экранным пикселям, если необходимо.

`Window.mozInnerScreenY` (en-US) Только для чтения  
Non-standard

Возвращает вертикальные (Y) координаты верхнего левого угла окна просмотра в экранных координатах. Значение возвращается в CSS-пикселях. Смотри `mozScreenPixelsPerCSSPixel` для конвертирования и адаптирования к экранным пикселям, если необходимо.

`Window.mozPaintCount` (en-US) 
Non-standard
Только для чтения 

Возвращает количество раз, за которые текущий документ был отрендерен для текущего экрана в этом окне. Может быть использовано для подсчёта скорости преобразования.

`Window.name`

Получает/устанавливает имя для окна.

`Window.navigator` Только для чтения 

Возвращает ссылку на объект навигатора.

`Window.opener` (en-US)

Возвращает ссылку на окно, открывшее текущее окно.

`Window.origin` Только для чтения 

Возвращает источник глобального объекта в виде строки.

`Window.orientation` (en-US)
Non-standard

Устарело
Только для чтения 

Возвращает ориентировку в градусах (с увеличением на 90 градусов) окна просмотра относительно настоящей ориентировки устройства.

`Window.outerHeight` (en-US) Только для чтения 

Получает высоту вместе с внешней частью браузерного окна.

`Window.outerWidth` (en-US) Только для чтения 

Получает ширину вместе с внешней частью браузерного окна.

`Window.pageXOffset` Только для чтения 

Псевдоним для `window.scrollX`.

`Window.pageYOffset`Только для чтения 

Псевдоним для `window.scrollY`

`Window.sessionStorage` Только для чтения 

Возвращает ссылку на объект хранения сессии, используемый для хранения данных, которые могут быть получены только источником, создавшим их.

`Window.parent` Только для чтения 

Возвращает ссылку на родителя текущего окна или встроенного фрейма.

`Window.performance` Только для чтения 

Обеспечивает главенствующее пространство для атрибутов, относящихся к производительности (en-US).

`Window.personalbar` (en-US) Только для чтения 

Возвращает объект personalbar, который может быть добавлен и убран из окна.

`Window.pkcs11`

Раньше предоставлял доступ к установке и удалению PKCS11 модуля.

`Window.returnValue`

Возвращаемое значение, которое будет передано в функцию, которая вызвала `window.showModalDialog()` (en-US) для отображения окна как модального диалога.

`Window.screen` Только для чтения 

Возвращает ссылку на объект экрана, ассоциируемый с окном.

`Window.screenX` Только для чтения 

Возвращает горизонтальный размер левой рамки браузера пользователя с левой стороны экрана.

`Window.screenY` (en-US) Только для чтения 

Возвращает вертикальный размер верхней рамки браузера пользователя с верхней стороны экрана.

`Window.scrollbars` (en-US) Только для чтения 

Возвращает объект scrollbars, который может быть добавлен и убран из окна.

`Window.scrollMaxX`
Non-standard
Только для чтения 

Максимальный отступ, на который может быть проскроллено окно по горизонтали, состоящее из разницы ширины документа и ширины области просмотра.

`Window.scrollMaxY`
Non-standard
Только для чтения 

Максимальный отступ, на который может быть проскроллено окно по вертикали, (т.е., разница высоты документа и высоты области просмотра).

`Window.scrollX` Только для чтения 

Возвращает число пикселей, на которое документ уже был проскроллен по горизонтали.

`Window.scrollY` Только для чтения 

Возвращает число пикселей, на которое документ уже был проскроллен по вертикали.

`Window.self` Только для чтения 

Возвращает ссылку на самого себя.

`Window.sessionStorage`

Возвращает объект хранилища для данных в пределах сессии одной страницы.

`Window.sidebar` (en-US) 
Non-standard
Только для чтения 

Возвращает ссылку на объект окна sidebar.

`Window.speechSynthesis` (en-US) Только для чтения 

Возвращает объект `SpeechSynthesis` (en-US), который является точкой входа для использования Web Speech API, функциональности для речевого синтеза.

`Window.status` (en-US)

Получает/устанавливает текст в statusbar внизу браузера.

`Window.statusbar` (en-US) Только для чтения 

Возвращает объект statusbar, который может быть добавлен и убран из окна.

`Window.toolbar` (en-US) Только для чтения 

Возвращает объект toolbar, который может быть добавлен и убран из окна.

`Window.top` Только для чтения 

Возвращает ссылку на самое первое окно в иерархии текущих окон. Только для чтения.

`Window.window` (en-US) Только для чтения 

Возвращает ссылку на текущее окно.

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

Возвращает ссылку на объект окна во фреймах. Смотри `Window.frames`.

Методы
------

*Этот интерфейс наследует методы от интерфейса `EventTarget`.*

`Window.atob()`

Декодирует строку данных, которая была закодирована, используя кодировку base-64.

`Window.alert()`

Отображает предупреждающее диалоговое окно.

`Window.back()` (en-US) 
Non-standard

Возвращается на один шаг назад в истории окна.

`Window.blur()`

Убирает фокус с окна.

`Window.btoa()`

Создать закодированную base-64 ASCII строку из строки бинарных данных.

`Window.cancelIdleCallback()` (en-US) 
Экспериментальная возможность

Позволяет отменить колбэк-функцию прежде чем определить расписание её вызова с `Window.requestIdleCallback`.

`Window.clearInterval()` (en-US)

Отменяет повторяющееся исполнение, установленного с помощью `setInterval()`.

`Window.clearTimeout()`

Отменяет отложенное исполнение, установленного с `setTimeout()`.

`Window.captureEvents()` (en-US) 
Устарело

Регистрирует окно, которое будет перехватывать все события определённого типа.

`Window.clearImmediate()`

Отменяет повторяющееся исполнение, установленное с помощью `setImmediate`.

`WindowTimers.clearInterval()` (en-US)

Отменяет повторяющееся исполнение, установленное с помощью `WindowTimers.setInterval()` (en-US).

`WindowTimers.clearTimeout()` (en-US)

Отменяет повторяющееся исполнение, установленное с помощью `WindowTimers.setTimeout()`.

`Window.close()`

Закрывает текущее окно.

`Window.confirm()`

Отображает диалог с сообщением, на которое пользователь должен ответить.

`Window.createImageBitmap()` (en-US)

Принимает множество различных изображений и возвращает `Promise` (en-US), который возвращает `ImageBitmap`. Опционально ресурс может быть обрезан до прямоугольника, заданного в пикселях *(sx, sy)* с шириной sw и высотой sh.

`Window.disableExternalCapture()`
{{todo("NeedsContents")}}
`Window.dispatchEvent()`

Используется для вызова события.

`Window.dump()` (en-US)

Отправляет сообщение в консоль.

`Window.fetch()`

Начинает процесс загрузки ресурса из сети.

`Window.enableExternalCapture()`
{{todo("NeedsContents")}}
`Window.find()` (en-US)

Ищет необходимую строку в окне window.

`Window.focus()` (en-US)

Устанавливает фокус на текущем окне.

`Window.forward()` (en-US) 
Non-standard

Переходит на один документ вперёд в текущей истории окна.

`Window.getAttention()`

Заставляет мигать иконку приложения.

`Window.getAttentionWithCycleCount()`
{{todo("NeedsContents")}}
`Window.getComputedStyle()`

Получает подсчитанные стили для определённого элемента. Подсчитанные стили включают подсчитанные значения всех CSS-свойств элемента.

`Window.getDefaulComputedStyle()`

Получает подсчитанные стили по умолчанию для определённого элемента, игнорируя авторские стили.

`Window.getSelection()`

Возвращает выбранный объект, представляющий выбранный элемент(ы).

`Window.home()` 
Non-standard

Возвращает браузер на домашнюю страницу.

`Window.matchMedia()`

Возвращает объект `MediaQueryList` (en-US), представляющий указанную строку медиавыражения.

`Window.maximize()`
{{todo("NeedsContents")}}
`Window.minimize()` (en-US) (top-level XUL windows only)

Минимизирует окно.

`Window.moveBy()`

Сдвигает текущее окно на определённое значение.

`Window.moveTo()`

Сдвигает окно до определённых координат.

`Window.mozRequestAnimationFrame()` (en-US)

Сообщает браузеру, что анимация находится в прогрессе, требуя, чтобы браузер определил время перерисовки окна для следующего анимационного фрейма. Это вызовет событие `MozBeforePaint,` прежде чем произойдёт перерисовка .

`Window.open()` (en-US)

Открывает новое окно.

`Window.openDialog()` (en-US)

Opens a new dialog window.

`Window.postMessage()`

Предоставляет безопасный способ для одного окна передать строку с данными в другое окно, которое должно находиться в пределах того же домена, что и первое.

`Window.print()`

Открывает Print Dialog для распечатки текущего документа.

`Window.prompt()`

Возвращает текст, введённый пользователем в диалоге подсказки.

`Window.releaseEvents()` (en-US) 
Устарело

Возвращает окно с захваченных событий определённого типа.

`Window.removeEventListener()`

Удаляет обработчик события из окна.

`Window.requestIdleCallback()` 
Экспериментальная возможность

Позволяет назначить расписание задачи во время периода простоя браузера.

`Window.resizeBy()` (en-US)

Меняет размер текущего окна на определённое число.

`Window.resizeTo()` (en-US)

Динамически меняет размер окна.

`Window.restore()` (en-US)
{{todo("NeedsContents")}}
`Window.routeEvent()`
{{todo("NeedsContents")}}
`Window.scroll()`

Scrolls the window to a particular place in the document.

`Window.scrollBy()`

Прокручивает документ в окна на данное число.

`Window.scrollByLines()`

Прокручивает документ на данное число строк.

`Window.scrollByPages()` (en-US)

Прокручивает документ на данное число страниц.

`Window.scrollTo()`

Прокручивает до заданных координат в документе.

`Window.setInterval()`

Устанавливает расписание для исполнения функции каждый раз через заданное число миллисекунд.

`Window.setTimeout()`

Устанавливает расписание для исполнения функции в назначенное время.

`Window.setCursor()`

Меняет курсор для текущего окна.

`Window.setImmediate()` (en-US)

Исполняет функцию после того, как браузер некую тяжёлую задачу.

`WindowTimers.setInterval()` (en-US)

Назначает выполнение функции каждые X миллисекунд.

`Window.setResizable` (en-US)
{{todo("NeedsContents")}}
`WindowTimers.setTimeout()`

Устанавливает отложенное выполнение функции.

`Window.showModalDialog()` (en-US)

Отображает модальный диалог.

`Window.sizeToContent()` (en-US)

Подгоняет размер окна под его содержимое.

`Window.stop()`

Останавливает загрузку страницы.

`Window.updateCommands()` (en-US)

Обновляет состояние команд текущего окна chrome (UI).

Обработчики событий
-------------------

Подписываться на события можно с помощью `addEventListener()` или присваивая обработчик события свойству `oneventname`. В дополнение к событиям, перечисленным ниже, события могут всплывать из `Document` глобального объекта.

`GlobalEventHandlers.onabort` (en-US)

Обработчик события для отмены событий в окне.

`WindowEventHandlers.onafterprint`

Вызывается, когда закрывается диалоговое окно распечатки. Смотри событие `afterprint (en-US)`.

`WindowEventHandlers.onbeforeprint` (en-US)

Вызывается, когда открывается диалоговое окно распечатки. Смотри событие `beforeprint (en-US)`.

`Window.onbeforeinstallprompt` (en-US)

Событие вызывается прежде чем пользователь согласится сохранить сайт на домашний экран на мобильном устройстве.

`WindowEventHandlers.onbeforeunload` (en-US)

Событие вызывается перед удалением события из окна.

`GlobalEventHandlers.onblur`

Свойство обработчика событий для исчезновение фокуса на окне.

`GlobalEventHandlers.onchange`

Свойство обработчика событий для изменения в окне.

`GlobalEventHandlers.onclick`

Свойство обработчика событий для клика в окне.

`GlobalEventHandlers.ondblclick` (en-US)

Вызывается, когда был сделан двойной клик ЛЮБОЙ кнопкой мыши.

`GlobalEventHandlers.onclose`

Свойство обработчика событий для обработки закрытия окна.

`GlobalEventHandlers.oncontextmenu`

Свойство обработчика событий для правого клика в окне.

`Window.ondevicelight`

Свойство обработчика событий для отслеживания изменения уровня света.

`Window.ondevicemotion` (en-US)

Вызывается, если было определено изменение акселерометра (для мобильных устройств).

`Window.ondeviceorientation` (en-US)

Вызывается, когда была изменена ориентация (для мобильных устройств).

`Window.ondeviceorientation` (en-US)

Свойство обработчика событий для смены ориентации любого устройства.

`Window.ondeviceproximity`

Свойство обработчика событий для определения близости устройства.

`GlobalEventHandlers.onerror`

Свойство обработчика событий для события `error (en-US)`, возникшего в окне.

`GlobalEventHandlers.onfocus`

Свойство обработчика событий для события `focus (en-US)` в окне.

`WindowEventHandlers.onhashchange` (en-US)

Свойство обработчика событий для отлова изменения хэша в окне; вызывается, когда часть URL после ("#") была изменена.

`Window.onappinstalled` (en-US)

Вызывается, когда страница установлена, как приложение. Смотри `appinstalled` событие.

`Window.oninput` (en-US)

Вызывается, когда значение элемента <input> было изменено.

`GlobalEventHandlers.onkeydown` (en-US)

Свойство обработчика событий для события `keydown (en-US)` в окне.

`GlobalEventHandlers.onkeypress` (en-US)

Свойство обработчика событий для события `keypress (en-US)` в окне.

`GlobalEventHandlers.onkeyup` (en-US)

Свойство обработчика событий для события `keyup (en-US)` в окне.

`WindowEventHandlers.onlanguagechange` (en-US)

Свойство обработчика событий для события `languagechange (en-US)` в окне.

`GlobalEventHandlers.onload` (en-US)

Свойство обработчика событий для загрузки окна.

`WindowEventHandlers.onmessage` (en-US)

`event handler`, представляющий собой код, который будет вызван, когда произойдёт событие `message`.

`GlobalEventHandlers.onmousedown` (en-US)

Свойство обработчика событий для события mousedown в окне.

`GlobalEventHandlers.onmousemove` (en-US)

Свойство обработчика событий для события mousemove в окне.

`GlobalEventHandlers.onmouseout` (en-US)

Свойство обработчика событий для события mouseout в окне.

`GlobalEventHandlers.onmouseover` (en-US)

Свойство обработчика событий для события mouseover в окне.

`GlobalEventHandlers.onmouseup` (en-US)

Свойство обработчика событий для события mouseup в окне.

`Window.onmozbeforepaint`

Свойство обработчика событий для события `MozBeforePaint`, которое присылается прежде чем окно будет перерисовано, если событие необходимо из-за вызова метода `Window.mozRequestAnimationFrame()` (en-US).

`WindowEventHandlers.onoffline`

Вызывается, когда было потеряно соединение с сетью. Смотри событие `offline (en-US)`.

`WindowEventHandlers.ononline`

Вызывается, когда соединение с сетью было установлено. Смотри событие `online (en-US)`.

`WindowEventHandlers.onpageshow`

Свойство обработчика событий для события pageshow в окне.

`WindowEventHandlers.onpagehide`

Свойство обработчика событий для события pagehide в окне.

`Window.onpaint`

Свойство обработчика событий для события paint в окне.

`WindowEventHandlers.onpopstate` (en-US)

Вызывается, когда была нажата кнопка назад.

`Window.onrejectionhandled` (en-US) 
Экспериментальная возможность

Свойство обработчика событий для обработки отказа события `Promise`.

`GlobalEventHandlers.onreset` (en-US)

Свойство обработчика событий для события reset в окне.

`GlobalEventHandlers.onresize` (en-US)

Свойство обработчика событий для изменения размера окна.

`GlobalEventHandlers.onscroll`

Свойство обработчика событий для прокрутки окна.

`GlobalEventHandlers.onwheel` (en-US)

Вызывается, когда было прокручено колёсико мыши в любую сторону.

`GlobalEventHandlers.onselect`

Свойство обработчика событий для события выбора в окне.

`GlobalEventHandlers.onselectionchange` (en-US)

`event handler`, представляющий собой код, который будет вызван, когда произойдёт событие `selectionchange`.

`GlobalEventHandlers.onsubmit`

Свойство обработчика событий для события submits в окне формы.

`WindowEventHandlers.onunhandledrejection` (en-US) 
Экспериментальная возможность

Свойство обработчика событий для отвязки обработчика отказа события `Promise`.

`Window.onunload` (en-US)

Свойство обработчика событий для события unload в окне.

`Window.onuserproximity`

Свойство обработчика событий для события изменения близости пользователя к устройству.

`Window.onvrdisplayconnected` (en-US) 
Экспериментальная возможность

Представляет обработчик события, который будет запущен, когда подходящее устройство виртуальной реальности было присоединено к компьютеру (когда запускается событие `vrdisplayconnected`).

`Window.onvrdisplaydisconnected` (en-US) 
Экспериментальная возможность

Представляет обработчик события, который будет запущен, когда подходящее устройство виртуальной реальности было отсоединено от компьютера (когда запускается событие `vrdisplaydisconnected`).

`Window.onvrdisplaypresentchange` (en-US) 
Экспериментальная возможность

Представляет обработчик события, который будет запущен, когда изменится состояние устройства виртуальной реальности — т.е. перейдёт от представленного к непредставленному или наоборот (когда будет запущено событие `onvrdisplaypresentchange`).

Конструкторы
------------

Смотрите также DOM Interfaces.

`Window.ConstantSourceNode`

Создаёт экземпляр `ConstantSourceNode` (en-US)


`Window.DOMParser`
{{todo("NeedsContents")}}
`Window.GeckoActiveXObject`
{{todo("NeedsContents")}}
`Image` (en-US)

Создаёт `HTMLImageElement`.

`Option` (en-US)

Создаёт `HTMLOptionElement` (en-US)

`Window.QueryInterface`
{{todo("NeedsContents")}}
`Window.XMLSerializer`
{{todo("NeedsContents")}}
`Worker`

Используется для создания Web worker

`Window.XPCNativeWrapper`
{{todo("NeedsContents")}}
`Window.XPCSafeJSObjectWrapper`
{{todo("NeedsContents")}}
Интерфейс
---------

Смотри DOM Reference

Смотрите также
--------------

* Working with windows in chrome code