Window

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

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

Интерфейс

Смотри DOM Reference

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