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).