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
Только для чтения-
Возвращает ссылку на локальный объект хранилища, используемый для хранения данных, которые могут быть доступны только первоисточникам, создавшим их.
-
Возвращает объект menubar, который может быть добавлен и убран из окна.
Window.messageManager
-
Возвращает объект message manager для окна.
Window.mozAnimationStartTime
Только для чтения-
Время в миллисекундах с момента начала цикла данной анимации.
Window.mozInnerScreenX
Только для чтения Не стандартно-
Возвращает горизонтальную (X) координату верхнего левого угла окна просмотра в экранных координатах. Значение возвращается в CSS-пикселях. Смотри
mozScreenPixelsPerCSSPixel
вnsIDOMWindowUtils
для конвертирования и адаптирования к экранным пикселям, если необходимо. Window.mozInnerScreenY
Только для чтения Не стандартно-
Возвращает вертикальные (Y) координаты верхнего левого угла окна просмотра в экранных координатах. Значение возвращается в CSS-пикселях. Смотри
mozScreenPixelsPerCSSPixel
для конвертирования и адаптирования к экранным пикселям, если необходимо. Window.mozPaintCount
Не стандартно Только для чтения-
Возвращает количество раз, за которые текущий документ был отрендерен для текущего экрана в этом окне. Может быть использовано для подсчёта скорости преобразования.
Window.name
-
Получает/устанавливает имя для окна.
-
Возвращает ссылку на объект навигатора.
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
-
Возвращает объект хранилища для данных в пределах сессии одной страницы.
-
Возвращает ссылку на объект окна 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()
unsupported templ: todoWindow.dispatchEvent()
-
Используется для вызова события.
Window.dump()
-
Отправляет сообщение в консоль.
Window.fetch()
-
Начинает процесс загрузки ресурса из сети.
Window.enableExternalCapture()
unsupported templ: todoWindow.find()
-
Ищет необходимую строку в окне window.
Window.focus()
-
Устанавливает фокус на текущем окне.
Window.forward()
Не стандартно-
Переходит на один документ вперёд в текущей истории окна.
Window.getAttention()
-
Заставляет мигать иконку приложения.
Window.getAttentionWithCycleCount()
unsupported templ: todoWindow.getComputedStyle()
-
Получает подсчитанные стили для определённого элемента. Подсчитанные стили включают подсчитанные значения всех CSS-свойств элемента.
Window.getDefaulComputedStyle()
-
Получает подсчитанные стили по умолчанию для определённого элемента, игнорируя авторские стили.
Window.getSelection()
-
Возвращает выбранный объект, представляющий выбранный элемент(ы).
Window.home()
Не стандартно-
Возвращает браузер на домашнюю страницу.
Window.matchMedia()
-
Возвращает объект
MediaQueryList
, представляющий указанную строку медиавыражения. Window.maximize()
unsupported templ: todoWindow.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()
unsupported templ: todoWindow.routeEvent()
unsupported templ: todoWindow.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
unsupported templ: todoWindowTimers.setTimeout()
-
Устанавливает отложенное выполнение функции.
Window.showModalDialog()
-
Отображает модальный диалог.
Window.sizeToContent()
-
Подгоняет размер окна под его содержимое.
Window.stop()
-
Останавливает загрузку страницы.
Window.updateCommands()
-
Обновляет состояние команд текущего окна chrome (UI).
Обработчики событий
Подписываться на события можно с помощью addEventListener()
или присваивая обработчик события свойству oneventname
. В дополнение к событиям, перечисленным ниже, события могут всплывать из Document
глобального объекта.
GlobalEventHandlers.onabort
-
Обработчик события для отмены событий в окне.
WindowEventHandlers.onafterprint
-
Вызывается, когда закрывается диалоговое окно распечатки. Смотри событие
unsupported templ: event. WindowEventHandlers.onbeforeprint
-
Вызывается, когда открывается диалоговое окно распечатки. Смотри событие
unsupported templ: event. Window.onbeforeinstallprompt
-
Событие вызывается прежде чем пользователь согласится сохранить сайт на домашний экран на мобильном устройстве.
WindowEventHandlers.onbeforeunload
-
Событие вызывается перед удалением события из окна.
GlobalEventHandlers.onblur
-
Свойство обработчика событий для исчезновение фокуса на окне.
GlobalEventHandlers.onchange
-
Свойство обработчика событий для изменения в окне.
GlobalEventHandlers.onclick
-
Свойство обработчика событий для клика в окне.
GlobalEventHandlers.ondblclick
-
Вызывается, когда был сделан двойной клик ЛЮБОЙ кнопкой мыши.
GlobalEventHandlers.onclose
-
Свойство обработчика событий для обработки закрытия окна.
-
Свойство обработчика событий для правого клика в окне.
Window.ondevicelight
-
Свойство обработчика событий для отслеживания изменения уровня света.
Window.ondevicemotion
-
Вызывается, если было определено изменение акселерометра (для мобильных устройств).
Window.ondeviceorientation
-
Вызывается, когда была изменена ориентация (для мобильных устройств).
Window.ondeviceorientation
-
Свойство обработчика событий для смены ориентации любого устройства.
Window.ondeviceproximity
-
Свойство обработчика событий для определения близости устройства.
GlobalEventHandlers.onerror
-
Свойство обработчика событий для события
unsupported templ: event, возникшего в окне. GlobalEventHandlers.onfocus
-
Свойство обработчика событий для события
unsupported templ: eventв окне. WindowEventHandlers.onhashchange
-
Свойство обработчика событий для отлова изменения хэша в окне; вызывается, когда часть URL после ("#") была изменена.
Window.onappinstalled
-
Вызывается, когда страница установлена, как приложение. Смотри
unsupported templ: eventсобытие. Window.oninput
-
Вызывается, когда значение элемента <input> было изменено.
GlobalEventHandlers.onkeydown
-
Свойство обработчика событий для события
unsupported templ: eventв окне. GlobalEventHandlers.onkeypress
-
Свойство обработчика событий для события
unsupported templ: eventв окне. GlobalEventHandlers.onkeyup
-
Свойство обработчика событий для события
unsupported templ: eventв окне. WindowEventHandlers.onlanguagechange
-
Свойство обработчика события
languagechange
в окне. GlobalEventHandlers.onload
-
Свойство обработчика событий для загрузки окна.
WindowEventHandlers.onmessage
-
unsupported templ: event, представляющий собой код, который будет вызван, когда произойдёт событиеunsupported templ: event. GlobalEventHandlers.onmousedown
-
Свойство обработчика событий для события mousedown в окне.
GlobalEventHandlers.onmousemove
-
Свойство обработчика событий для события mousemove в окне.
GlobalEventHandlers.onmouseout
-
Свойство обработчика событий для события mouseout в окне.
GlobalEventHandlers.onmouseover
-
Свойство обработчика событий для события mouseover в окне.
GlobalEventHandlers.onmouseup
-
Свойство обработчика событий для события mouseup в окне.
Window.onmozbeforepaint
-
Свойство обработчика событий для события
MozBeforePaint
, которое присылается прежде чем окно будет перерисовано, если событие необходимо из-за вызова методаWindow.mozRequestAnimationFrame()
. WindowEventHandlers.onoffline
-
Вызывается, когда было потеряно соединение с сетью. Смотри событие
unsupported templ: event. WindowEventHandlers.ononline
-
Вызывается, когда соединение с сетью было установлено. Смотри событие
unsupported templ: event. 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
-
unsupported templ: event, представляющий собой код, который будет вызван, когда произойдёт событиеunsupported templ: event. GlobalEventHandlers.onsubmit
-
Свойство обработчика событий для события submits в окне формы.
WindowEventHandlers.onunhandledrejection
Экспериментальная возможность-
Свойство обработчика событий для отвязки обработчика отказа события
Promise
. Window.onunload
-
Свойство обработчика событий для события unload в окне.
Window.onuserproximity
-
Свойство обработчика событий для события изменения близости пользователя к устройству.
Window.onvrdisplayconnected
Экспериментальная возможность-
Представляет обработчик события, который будет запущен, когда подходящее устройство виртуальной реальности было присоединено к компьютеру (когда запускается событие
unsupported templ: event). Window.onvrdisplaydisconnected
Экспериментальная возможность-
Представляет обработчик события, который будет запущен, когда подходящее устройство виртуальной реальности было отсоединено от компьютера (когда запускается событие
unsupported templ: event). Window.onvrdisplaypresentchange
Экспериментальная возможность-
Представляет обработчик события, который будет запущен, когда изменится состояние устройства виртуальной реальности — т.е. перейдёт от представленного к непредставленному или наоборот (когда будет запущено событие
unsupported templ: event).
Конструкторы
Смотрите также DOM Interfaces.
Window.ConstantSourceNode
-
Создаёт экземпляр
ConstantSourceNode
Window.DOMParser
unsupported templ: todoWindow.GeckoActiveXObject
unsupported templ: todoImage
-
Создаёт
HTMLImageElement
. Option
-
Создаёт
HTMLOptionElement
Window.QueryInterface
unsupported templ: todoWindow.XMLSerializer
unsupported templ: todoWorker
-
Используется для создания Web worker
Window.XPCNativeWrapper
unsupported templ: todoWindow.XPCSafeJSObjectWrapper
unsupported templ: todo
Интерфейс
Смотри DOM Reference