Window

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨июль 2015 г.⁩.

* Some parts of this feature may have varying levels of support.

Объект 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.

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

Window.caches Только для чтения: Возвращает объект CacheStorage, связанный с текущим контекстом. Этот объект добавляет такой функционал как хранение ресурсов для использования вне сети и генерирования встроенных ответов на запросы.
Window.closed Не стандартно Только для чтения: Свойство, указывающее было ли текущее окно закрыто или нет.
Window.Components Не стандартно: Точка доступа к богатой функциональности XPCOM. Некоторые свойства, т.к. classes, доступны только для достаточно привилегированного кода. Web-код не должен использовать эти свойства.
Window.console Не стандартно Только для чтения: Возвращает ссылку на объект консоли, обеспечивающего доступ к консоли браузера.
Window.content and Window.content Не стандартно Только для чтения: Возвращает ссылку на элемент содержимого в текущем окне. Устаревший вариант в нижним подчёркиванием более не доступен для Web-содержимого.
Window.controllers Не стандартно Только для чтения: Возвращает XUL контроллер объектов для текущего окна chrome.
Window.crypto Только для чтения: Возвращает зашифрованный объект браузера.
Window.defaultStatus: Получает/устанавливает текст статус-бара для данного окна.
Window.devicePixelRatio Не стандартно Только для чтения: Возвращает соотношение между физическими пикселями и пикселями на дисплее текущего устройства.
Window.dialogArguments Только для чтения: Получает аргументы, переданные в окно (если это диалоговое окно) в момент вызова window.showModalDialog(). Это nsIArray.
Window.directories: Синоним window.personalbar
Window.document Только для чтения: Возвращает ссылку на содержащийся в окне документ.
Window.frameElement Только для чтения: Возвращает элемент, в который встроено окно, или null, если оно не встроено.
Window.frames Только для чтения: Возвращает массив дополнительных фреймов в текущем окне.
Window.fullScreen: Это свойство указывает, отображается ли окно в полноэкранном режиме или нет.
Window.globalStorage Не стандартно: Не поддерживает с Gecko 13 (Firefox 13). Использовать вместо негоWindow.localStorage. Было: Множественные объекты хранения, которые используются для хранения данных на нескольких страницах.
Window.history Только для чтения: Возвращает ссылку на объект истории.
Window.indexedDB Только для чтения: Обеспечивает механизм для приложений для возможности асинхронного доступа индексированных баз данных; возвращает объект IDBFactory.
Window.innerHeight: Получает высоту области содержимого окна браузера, включая, если есть, горизонтальный скроллбар.
window.innerWidth: Получает ширину области содержимого окна браузера, включая, если есть, вертикальный скроллбар.
Window.isSecureContext Только для чтения: Возвращает булевское значение, указывающее является ли текущий контент безопасным (true) или нет (false).
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.origin Только для чтения: Возвращает источник глобального объекта в виде строки.
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: Раньше предоставлял доступ к установке и удалению 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.

Методы

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

Window.atob(): Декодирует строку данных, которая была закодирована, используя кодировку base-64.
Window.alert(): Отображает предупреждающее диалоговое окно.
Window.back() Не стандартно: Возвращается на один шаг назад в истории окна.
Window.blur(): Убирает фокус с окна.
Window.btoa(): Создать закодированную base-64 ASCII строку из строки бинарных данных.
Window.cancelIdleCallback() Экспериментальная возможность: Позволяет отменить колбэк-функцию прежде чем определить расписание её вызова с Window.requestIdleCallback.
Window.clearInterval(): Отменяет повторяющееся исполнение, установленного с помощью setInterval().
Window.clearTimeout(): Отменяет отложенное исполнение, установленного с setTimeout().
Window.captureEvents() Устарело: Регистрирует окно, которое будет перехватывать все события определённого типа.
Window.clearImmediate(): Отменяет повторяющееся исполнение, установленное с помощью setImmediate.
WindowTimers.clearInterval(): Отменяет повторяющееся исполнение, установленное с помощью WindowTimers.setInterval().
WindowTimers.clearTimeout(): Отменяет повторяющееся исполнение, установленное с помощью WindowTimers.setTimeout().
Window.close(): Закрывает текущее окно.
Window.confirm(): Отображает диалог с сообщением, на которое пользователь должен ответить.
Window.createImageBitmap(): Принимает множество различных изображений и возвращает Promise, который возвращает ImageBitmap. Опционально ресурс может быть обрезан до прямоугольника, заданного в пикселях (sx, sy) с шириной sw и высотой sh.
Window.disableExternalCapture()
Window.dispatchEvent(): Используется для вызова события.
Window.dump(): Отправляет сообщение в консоль.
Window.fetch(): Начинает процесс загрузки ресурса из сети.
Window.enableExternalCapture()
Window.find(): Ищет необходимую строку в окне window.
Window.focus(): Устанавливает фокус на текущем окне.
Window.forward() Не стандартно: Переходит на один документ вперёд в текущей истории окна.
Window.getAttention(): Заставляет мигать иконку приложения.
Window.getAttentionWithCycleCount()
Window.getComputedStyle(): Получает подсчитанные стили для определённого элемента. Подсчитанные стили включают подсчитанные значения всех CSS-свойств элемента.
Window.getDefaulComputedStyle(): Получает подсчитанные стили по умолчанию для определённого элемента, игнорируя авторские стили.
Window.getSelection(): Возвращает выбранный объект, представляющий выбранный элемент(ы).
Window.home() Не стандартно: Возвращает браузер на домашнюю страницу.
Window.matchMedia(): Возвращает объект MediaQueryList, представляющий указанную строку медиавыражения.
Window.maximize()
Window.minimize() (top-level XUL windows only): Минимизирует окно.
Window.moveBy(): Сдвигает текущее окно на определённое значение.
Window.moveTo(): Сдвигает окно до определённых координат.
Window.mozRequestAnimationFrame(): Сообщает браузеру, что анимация находится в прогрессе, требуя, чтобы браузер определил время перерисовки окна для следующего анимационного фрейма. Это вызовет событие 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()
Window.routeEvent()
Window.scroll(): Scrolls the window to a particular place in the document.
Window.scrollBy(): Прокручивает документ в окна на данное число.
Window.scrollByLines(): Прокручивает документ на данное число строк.
Window.scrollByPages(): Прокручивает документ на данное число страниц.
Window.scrollTo(): Прокручивает до заданных координат в документе.
Window.setInterval(): Устанавливает расписание для исполнения функции каждый раз через заданное число миллисекунд.
Window.setTimeout(): Устанавливает расписание для исполнения функции в назначенное время.
Window.setCursor(): Меняет курсор для текущего окна.
Window.setImmediate(): Исполняет функцию после того, как браузер некую тяжёлую задачу.
WindowTimers.setInterval(): Назначает выполнение функции каждые X миллисекунд.
Window.setResizable
WindowTimers.setTimeout(): Устанавливает отложенное выполнение функции.
Window.showModalDialog(): Отображает модальный диалог.
Window.sizeToContent(): Подгоняет размер окна под его содержимое.
Window.stop(): Останавливает загрузку страницы.
Window.updateCommands(): Обновляет состояние команд текущего окна chrome (UI).

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

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

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: Свойство обработчика событий для отслеживания изменения уровня света.
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: event handler, представляющий собой код, который будет вызван, когда произойдёт событие 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: event handler, представляющий собой код, который будет вызван, когда произойдёт событие selectionchange.
GlobalEventHandlers.onsubmit: Свойство обработчика событий для события submits в окне формы.
WindowEventHandlers.onunhandledrejection Экспериментальная возможность: Свойство обработчика событий для отвязки обработчика отказа события Promise.
Window.onunload: Свойство обработчика событий для события unload в окне.
Window.onuserproximity: Свойство обработчика событий для события изменения близости пользователя к устройству.
Window.onvrdisplayconnected Экспериментальная возможность: Представляет обработчик события, который будет запущен, когда подходящее устройство виртуальной реальности было присоединено к компьютеру (когда запускается событие vrdisplayconnected).
Window.onvrdisplaydisconnected Экспериментальная возможность: Представляет обработчик события, который будет запущен, когда подходящее устройство виртуальной реальности было отсоединено от компьютера (когда запускается событие vrdisplaydisconnected).
Window.onvrdisplaypresentchange Экспериментальная возможность: Представляет обработчик события, который будет запущен, когда изменится состояние устройства виртуальной реальности — т.е. перейдёт от представленного к непредставленному или наоборот (когда будет запущено событие onvrdisplaypresentchange).