В процессе перевода.

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

Смотри так же

Метки документа и участники

 Внесли вклад в эту страницу: mr-aleksey, dameerv, curdwithraisins, MikitaDu, redishko, surrsoft, fscholz, Roman_Pizhlakov
 Обновлялась последний раз: mr-aleksey,