Окно

Интерфейс Window представляет собой окно, содержащее документ DOM; свойство document указывает на документ DOM, загруженный в этом окне.

Окно для данного документа можно получить, используя свойство document.defaultView.

Глобальная переменная window, представляющая окно, в котором выполняется сценарий, доступна для кода JavaScript.

Интерфейс Window содержит множество функций, пространств имен, объектов и конструкторов, которые не обязательно напрямую связаны с понятием окна пользовательского интерфейса. Однако интерфейс Window — подходящее место для включения этих элементов, которые должны быть доступны глобально. Многие из них документированы в Справочнике JavaScript и Справочнике DOM.

В браузере с вкладками каждая вкладка представлена своим собственным объектом Window; глобальная переменная window, видимая кодом JavaScript, выполняющимся в данной вкладке, всегда представляет вкладку, в которой выполняется код. Тем не менее, даже в браузере с вкладками некоторые свойства и методы все еще относятся к общему окну, содержащему вкладку, например, resizeTo() и innerHeight. Как правило, все, что не может быть разумно отнесено к вкладке, относится к окну.

Window.event Устаревшее Только для чтения

Возвращает текущее событие, которое в данный момент обрабатывает контекст кода JavaScript, или undefined если в данный момент не обрабатывается ни одно событие. Вместо этого следует использовать объект Event, передаваемый непосредственно обработчикам событий, где это возможно.

Window.external Устаревшее Только для чтения

Возвращает объект с функциями для добавления внешних поисковых поставщиков в браузер.

Window.orientation Устаревшее Только для чтения

Возвращает ориентацию в градусах (с шагом 90 градусов) области просмотра относительно естественной ориентации устройства.

Window.status Устаревшее

Получает/устанавливает текст в строке состояния в нижней части браузера.

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

Window.atob()

Декодирует строку данных, закодированную с использованием кодирования base-64.

Window.alert()

Отображает диалоговое окно с предупреждением.

Window.blur() Deprecated

Убирает фокус с окна.

Window.btoa()

Создаёт строку ASCII, закодированную в base-64, из строки двоичных данных.

Window.cancelAnimationFrame()

Позволяет отменить обратный вызов, ранее запланированный с помощью Window.requestAnimationFrame.

Window.cancelIdleCallback()

Позволяет отменить обратный вызов, ранее запланированный с помощью Window.requestIdleCallback.

Window.clearInterval()

Отменяет повторяющееся выполнение, заданное с помощью Window.setInterval().

Window.clearTimeout()

Отменяет отложенное выполнение, заданное с помощью Window.setTimeout().

Window.close()

Закрывает текущее окно.

Window.confirm()

Отображает диалог с сообщением, на которое пользователь должен ответить.

Window.createImageBitmap()

Принимает различные источники изображений и возвращает Promise, который разрешается в ImageBitmap. При необходимости источник обрезается до прямоугольника пикселей, начинающегося в точке (sx, sy) с шириной sw и высотой sh.

Window.dump() Non-standard

Записывает сообщение в консоль.

Window.fetch()

Инициализирует процесс получения ресурса из сети.

Window.find() Non-standard

Ищет заданную строку в окне.

Window.focus()

Устанавливает фокус на текущем окне.

Window.getComputedStyle()

Получает вычисленный стиль для указанного элемента. Вычисленный стиль указывает вычисленные значения всех свойств CSS элемента.

Window.getDefaultComputedStyle() Non-standard

Получает стандартный вычисленный стиль для указанного элемента, игнорируя пользовательские таблицы стилей.

Window.getScreenDetails() Experimental Безопасный контекст

Возвращает Promise, который выполняется с объектом ScreenDetails, представляющим сведения о всех доступных экранах устройства пользователя.

Window.getSelection()

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

Window.matchMedia()

Возвращает объект MediaQueryList, представляющий указанную строку запроса к медиа.

Window.moveBy()

Перемещает текущее окно на указанное количество.

Window.moveTo()

Перемещает окно в указанные координаты.

Window.open()

Открывает новое окно.

Window.postMessage()

Обеспечивает безопасный способ отправки строки данных из одного окна в другое окно, которое необязательно находится в том же домене, что и первое.

Window.print()

Открывает диалоговое окно печати для печати текущего документа.

Window.prompt()

Возвращает текст, введённый пользователем в диалоговом окне запроса.

Window.queryLocalFonts() Experimental Безопасный контекст

Возвращает Promise, который выполняется с массивом объектов FontData, представляющих доступные локальные шрифты.

Window.queueMicrotask()

Вставляет микрозадачу для выполнения в безопасное время до возврата управления циклу событий браузера.

Window.reportError()

Сообщает об ошибке в скрипте, эмулируя необработанное исключение.

Window.requestAnimationFrame()

Уведомляет браузер о том, что анимация выполняется, запрашивая перерисовку окна для следующего кадра анимации.

Window.requestIdleCallback()

Позволяет планировать задачи во время простоя браузера.

Window.resizeBy()

Изменяет размер текущего окна на определённую величину.

Window.resizeTo()

Динамически изменяет размер окна.

Window.scroll()

Прокручивает окно до определённого места в документе.

Window.scrollBy()

Прокручивает документ в окне на заданное количество.

Window.scrollByLines() Non-standard

Прокручивает документ на заданное количество строк.

Window.scrollByPages() Non-standard

Прокручивает текущий документ на заданное количество страниц.

Window.scrollTo()

Прокручивает до определённых координат в документе.

Window.setInterval()

Планирует выполнение функции каждые заданные миллисекунды.

Window.setTimeout()

Планирует выполнение функции через заданный промежуток времени.

Window.showDirectoryPicker() Experimental Безопасный контекст

Отображает диалог выбора директории, позволяющий пользователю выбрать директорию.

Window.showOpenFilePicker() Experimental Безопасный контекст

Отображает диалог выбора файла, позволяющий пользователю выбрать один или несколько файлов.

Window.showSaveFilePicker() Experimental Безопасный контекст

Отображает диалог сохранения файла, позволяющий пользователю сохранить файл.

Window.sizeToContent() Non-standard

Изменяет размер окна в соответствии с его содержимым.

Window.stop()

Этот метод останавливает загрузку окна.

Window.structuredClone()

Создаёт полную копию заданного значения с помощью алгоритма структурированного клонирования.

Window.back() Нестандартный Устаревший

Перемещает назад на один шаг в истории браузера. Этот метод устарел; используйте вместо него history.back().

Window.captureEvents() Устаревший

Регистрирует окно для захвата всех событий указанного типа.

Window.clearImmediate() Нестандартный Устаревший

Отменяет повторное выполнение, заданное с помощью setImmediate().

Window.forward() Нестандартный Устаревший

Перемещает окно вперед на одну страницу в истории. Этот метод устарел; используйте вместо него history.forward().

Window.releaseEvents() Устаревший

Освобождает окно от захвата событий определенного типа.

Window.requestFileSystem() Нестандартный Устаревший

Позволяет веб-сайту или приложению получить доступ к защищенной файловой системе для собственного использования.

Window.setImmediate() Нестандартный Устаревший

Выполняет функцию после того, как браузер завершит другие тяжелые задачи.

Window.setResizable() Нестандартный Устаревший

Не делает ничего (no-op). Сохранено для обратной совместимости с Netscape 4.x.

Window.showModalDialog() Нестандартный Устаревший

Отображает модальное диалоговое окно.

Window.webkitConvertPointFromNodeToPage() Нестандартный Устаревший

Преобразует WebKitPoint из системы координат узла в систему координат страницы.

Window.webkitConvertPointFromPageToNode() Нестандартный Устаревший

Преобразует WebKitPoint из системы координат страницы в систему координат узла.

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

error

Вызывается, когда ресурс не удалось загрузить или он не может быть использован. Например, если у скрипта есть ошибка выполнения или изображение не найдено или некорректно.

languagechange

Вызывается в глобальном объекте области видимости, когда изменяется предпочитаемый язык пользователя.

resize

Вызывается, когда окно было измененно.

storage

Вызывается, когда область хранилища (localStorage или sessionStorage ) была изменена в контексте другого документа.

copy

Вызывается, когда пользователь инициирует копирование через интерфейс пользователя браузера. Также доступно через свойство oncopy.

cut

Вызывается, когда пользователь инициирует вырезку через интерфейс пользователя браузера. Также доступно через свойство oncut.

paste

Вызывается, когда пользователь инициирует вставку через интерфейс пользователя браузера. Также доступно через свойство onpaste.

offline

Вызывается, когда браузер потерял доступ к сети и значение navigator.onLine переключилось на false.

online

Вызывается, когда браузер получил доступ к сети и значение navigator.onLine переключилось на true.

devicemotion Безопасный контекст

Вызывается с регулярным интервалом, указывая величину физической силы ускорения, полученного устройством, и скорость вращения, если доступно.

deviceorientation Безопасный контекст

Вызывается, когда доступны свежие данные от датчика ориентации компаса о текущей ориентации устройства по отношению к системе координат Земли.

deviceorientationabsolute Безопасный контекст

Вызывается, когда доступны свежие данные от датчика ориентации компаса о текущей абсолютной ориентации устройства по отношению к системе координат Земли.

blur

Вызывается, когда элемент теряет фокус.

focus

Вызывается, когда элемент получает фокус.

gamepadconnected

Вызывается, когда браузер обнаруживает подключение джойстика или первый раз используется кнопка/ось джойстика.

gamepaddisconnected

Вызывается, когда браузер обнаруживает отключение джойстика.

hashchange

Вызывается, когда фрагмент идентификатора URL изменился (часть URL, начинающаяся с и следующая за символом #).

pagehide

Отправляется, когда браузер скрывает текущий документ во время переключения на отображение другого документа из истории сеанса. Это происходит, например, когда пользователь нажимает кнопку «Назад» или кнопку «Вперед» для перемещения вперед в истории сеанса.

pagereveal

Вызывается, когда документ впервые отрисовывается, либо при загрузке нового документа из сети, либо при активации документа (либо из кэша «назад/вперед» (bfcache), либо из предварительной загрузки).

pageshow

Отправляется, когда браузер делает документ видимым из-за навигационных задач, включая не только первую загрузку страницы, но также ситуации, такие как навигация пользователя обратно на страницу после перехода к другой в том же окне.

pageswap

Вызывается, когда документ должен быть загружен из-за навигации.

popstate

Вызывается, когда активная запись истории изменяется.

beforeunload

Вызывается, когда окно, документ и его ресурсы собираются выгрузить.

load

Вызывается, когда вся страница загружена, включая все зависимые ресурсы, такие как таблицы стилей и изображения.

unload Устаревшее

Вызывается, когда документ или дочерний ресурс выгружается.

appinstalled

Вызывается, когда браузер успешно установил страницу как приложение.

beforeinstallprompt

Вызывается, когда пользователя собираются попросить установить веб-приложение.

message

Вызывается, когда окно получает сообщение, например, в результате вызова Window.postMessage() из другого контекста просмотра.

messageerror

Вызывается, когда объект Window получает сообщение, которое нельзя десериализовать.

afterprint

Вызывается после того, как связанный документ начал печать или была закрыта предварительная визуализация печати.

beforeprint

Вызывается, когда связанный документ собирается распечатать или предварительно просмотреть для печати.

rejectionhandled

Отправляется каждый раз, когда JavaScript Promise отклоняется, независимо от того, есть ли обработчик для перехвата отклонения.

unhandledrejection

Отправляется, когда JavaScript Promise отклоняется, но нет обработчика для перехвата отклонения.

scrollsnapchange Экспериментально

Вызывается в контейнере прокрутки в конце операции прокрутки, когда выбран новый целевой элемент прокрутки.

scrollsnapchanging Экспериментально

Вызывается в контейнере прокрутки, когда браузер определяет, что новый целевой элемент прокрутки ожидает выбора, т.е. он будет выбран по завершении текущего жеста прокрутки.

orientationchange Устаревшее

Вызывается, когда ориентация устройства изменилась.

vrdisplayactivate Устаревшее Нестандартный

Вызывается, когда дисплей можно отображать.

vrdisplayconnect Устаревшее Нестандартный

Вызывается, когда совместимое VR-устройство подключено к компьютеру.

vrdisplaydisconnect Устаревшее Нестандартный

Вызывается, когда совместимое VR-устройство отключено от компьютера.

vrdisplaydeactivate Устаревшее Нестандартный

Вызывается, когда отображение больше не может быть представлено.

vrdisplaypresentchange Устаревшее Нестандартный

Вызывается, когда состояние представления VR-устройства меняется — например, переходит от представления к отсутствию представления или наоборот.

См. Справочник по DOM.