Класс Window

Контейнер верхнего уровня для текущей вкладки или окна браузера.

В веб-браузере у каждого окна есть объект Window, но в контексте скрипта этот объект представляет только текущее окно. У каждого другого окна, вкладки и iframe есть собственный объект Window.

Каждое окно содержит объект Document, который включает всё содержимое окна.

Для доступа к текущему окну используйте объект верхнего уровня window. Например:

// Draw a scene when the window repaints.
drawScene(num delta) {...}
window.animationFrame.then(drawScene);.

// Write to the console.
window.console.log('Jinkies!');
window.console.error('Jeepers!');

Примечание: Этот класс представляет только текущее окно, тогда как WindowBase представляет любое окно, включая другие вкладки, окна и фреймы.

См. также

WindowBase

Другие ресурсы

Окно DOM на MDN.
Window на сайте W3C.

Наследование

Реализованные типы

Аннотации

@Native("Window,DOMWindow")

Свойства

animationFrame → Future<num> только для чтения: Возвращает Future, который завершается непосредственно перед перерисовкой окна, чтобы пользователь мог нарисовать кадр анимации.
animationWorklet → _Worklet? только для чтения
applicationCache → ApplicationCache? только для чтения: Кэш приложения для этого окна.
audioWorklet → _Worklet? только для чтения
caches → CacheStorage? только для чтения
closed → bool? только для чтения переопределение: Указывает, было ли закрыто это окно.
console → Console только для чтения: Консоль отладки для этого окна.
cookieStore → CookieStore? только для чтения
crypto → Crypto? только для чтения: Точка входа для криптографических функций браузера.
customElements → CustomElementRegistry? только для чтения
defaultStatus ↔ String? чтение / запись: Устарело.
defaultstatus ↔ String? чтение / запись: Устарело.
devicePixelRatio → num только для чтения: Соотношение между физическими пикселями и логическими пикселями CSS.
document → Document только для чтения: Последний документ в этом окне.
external → External? только для чтения
hashCode → int только для чтения унаследовано: Хеш-код этого объекта.
history → History только для чтения переопределение: Текущая история сеанса для последнего документа этого окна.
indexedDB → IdbFactory? только для чтения: Получает экземпляр фабрики Indexed DB для работы с Indexed DB.
innerHeight → int? только для чтения: Высота области просмотра, включая полосы прокрутки.
innerWidth → int? только для чтения: Ширина области просмотра, включая полосы прокрутки.
isSecureContext → bool? только для чтения
localStorage → Storage только для чтения: Хранилище этого окна, сохраняющее данные между сеансами.
location ↔ Location чтение / запись переопределение метода доступа: Текущее местоположение этого окна.
locationbar → BarProp? только для чтения: Панель адреса этого окна, отображающая URL.
menubar → BarProp? только для чтения: Строка меню этого окна, отображающая команды меню.
name ↔ String? чтение / запись: Имя этого окна.
navigator → Navigator только для чтения: Пользовательский агент, обращающийся к этому окну.
offscreenBuffering → bool? только для чтения: Рисуются ли объекты вне экрана до отображения.
on → Events только для чтения унаследовано: Это удобный способ доступа к потокам событий, который следует использовать только в том случае, если явный способ доступа недоступен.
onAbort → Stream<Event> только для чтения переопределение: Поток событий abort, обрабатываемых этим Window.
onAnimationEnd → Stream<AnimationEvent> только для чтения: Поток событий animationend, обрабатываемых этим Window.
onAnimationIteration → Stream<AnimationEvent> только для чтения: Поток событий animationiteration, обрабатываемых этим Window.
onAnimationStart → Stream<AnimationEvent> только для чтения: Поток событий animationstart, обрабатываемых этим Window.
onBeforeUnload → Stream<Event> только для чтения: Поток событий beforeunload, обрабатываемых этим Window.
onBlur → Stream<Event> только для чтения переопределение: Поток событий blur, обрабатываемых этим Window.
onCanPlay → Stream<Event> только для чтения переопределение
onCanPlayThrough → Stream<Event> только для чтения переопределение
onChange → Stream<Event> только для чтения переопределение: Поток событий change, обрабатываемых этим Window.
onClick → Stream<MouseEvent> только для чтения переопределение: Поток событий click, обрабатываемых этим Window.
onContentLoaded → Stream<Event> только для чтения: Поток событий contentloaded, обрабатываемых этим Window.
onContextMenu → Stream<MouseEvent> только для чтения переопределение: Поток событий contextmenu, обрабатываемых этим Window.
onDeviceMotion → Stream<DeviceMotionEvent> только для чтения: Поток событий devicemotion, обрабатываемых этим Window.
onDeviceOrientation → Stream<DeviceOrientationEvent> только для чтения: Поток событий deviceorientation, обрабатываемых этим Window.
onDoubleClick → Stream<Event> только для чтения переопределение: Поток событий doubleclick, обрабатываемых этим Window.
onDrag → Stream<MouseEvent> только для чтения переопределение: Поток событий drag, обрабатываемых этим Window.
onDragEnd → Stream<MouseEvent> только для чтения переопределение: Поток событий dragend, обрабатываемых этим Window.
onDragEnter → Stream<MouseEvent> только для чтения переопределение: Поток событий dragenter, обрабатываемых этим Window.
onDragLeave → Stream<MouseEvent> только для чтения переопределение: Поток событий dragleave, обрабатываемых этим Window.
onDragOver → Stream<MouseEvent> только для чтения переопределение: Поток событий dragover, обрабатываемых этим Window.
onDragStart → Stream<MouseEvent> только для чтения переопределение: Поток событий dragstart, обрабатываемых этим Window.
onDrop → Stream<MouseEvent> только для чтения переопределение: Поток событий drop, обрабатываемых этим Window.
onDurationChange → Stream<Event> только для чтения переопределение
onEmptied → Stream<Event> только для чтения переопределение
onEnded → Stream<Event> только для чтения переопределение
onError → Stream<Event> только для чтения переопределение: Поток событий error, обрабатываемых этим Window.
onFocus → Stream<Event> только для чтения переопределение: Поток событий focus, обрабатываемых этим Window.
onHashChange → Stream<Event> только для чтения переопределение: Поток событий hashchange, обрабатываемых этим Window.
onInput → Stream<Event> только для чтения переопределение: Поток событий input, обрабатываемых этим Window.
onInvalid → Stream<Event> только для чтения переопределение: Поток событий invalid, обрабатываемых этим Window.
onKeyDown → Stream<KeyboardEvent> только для чтения переопределение: Поток событий keydown, обрабатываемых этим Window.
onKeyPress → Stream<KeyboardEvent> только для чтения переопределение: Поток событий keypress, обрабатываемых этим Window.
onKeyUp → Stream<KeyboardEvent> только для чтения переопределение: Поток событий keyup, обрабатываемых этим Window.
onLoad → Stream<Event> только для чтения переопределение: Поток событий load, обрабатываемых этим Window.
onLoadedData → Stream<Event> только для чтения переопределение
onLoadedMetadata → Stream<Event> только для чтения переопределение
onLoadStart → Stream<Event> только для чтения
onMessage → Stream<MessageEvent> только для чтения переопределение: Поток событий message, обрабатываемых этим Window.
onMouseDown → Stream<MouseEvent> только для чтения переопределение: Поток событий mousedown, обрабатываемых этим Window.
onMouseEnter → Stream<MouseEvent> только для чтения переопределение: Поток событий mouseenter, обрабатываемых этим Window.
onMouseLeave → Stream<MouseEvent> только для чтения переопределение: Поток событий mouseleave, обрабатываемых этим Window.
onMouseMove → Stream<MouseEvent> только для чтения переопределение: Поток событий mousemove, обрабатываемых этим Window.
onMouseOut → Stream<MouseEvent> только для чтения переопределение: Поток событий mouseout, обрабатываемых этим Window.
onMouseOver → Stream<MouseEvent> только для чтения переопределение: Поток событий mouseover, обрабатываемых этим Window.
onMouseUp → Stream<MouseEvent> только для чтения переопределение: Поток событий mouseup, обрабатываемых этим Window.
onMouseWheel → Stream<WheelEvent> только для чтения переопределение: Поток событий mousewheel, обрабатываемых этим Window.
onOffline → Stream<Event> только для чтения переопределение: Поток событий offline, обрабатываемых этим Window.
onOnline → Stream<Event> только для чтения переопределение: Поток событий online, обрабатываемых этим Window.
onPageHide → Stream<Event> только для чтения: Поток событий pagehide, обрабатываемых этим Window.
onPageShow → Stream<Event> только для чтения: Поток событий pageshow, обрабатываемых этим Window.
onPause → Stream<Event> только для чтения переопределение
onPlay → Stream<Event> только для чтения переопределение
onPlaying → Stream<Event> только для чтения переопределение
onPopState → Stream<PopStateEvent> только для чтения переопределение: Поток событий popstate, обрабатываемых этим Window.
onProgress → Stream<Event> только для чтения
onRateChange → Stream<Event> только для чтения переопределение
onReset → Stream<Event> только для чтения переопределение: Поток событий reset, обрабатываемых этим Window.
onResize → Stream<Event> только для чтения переопределение: Поток событий resize, обрабатываемых этим Window.
onScroll → Stream<Event> только для чтения переопределение: Поток событий scroll, обрабатываемых этим Window.
onSearch → Stream<Event> только для чтения: Поток событий search, обрабатываемых этим Window.
onSeeked → Stream<Event> только для чтения переопределение
onSeeking → Stream<Event> только для чтения переопределение
onSelect → Stream<Event> только для чтения переопределение: Поток событий select, обрабатываемых этим Window.
onStalled → Stream<Event> только для чтения переопределение
onStorage → Stream<StorageEvent> только для чтения переопределение: Поток событий storage, обрабатываемых этим Window.
onSubmit → Stream<Event> только для чтения переопределение: Поток событий submit, обрабатываемых этим Window.
onSuspend → Stream<Event> только для чтения переопределение
onTimeUpdate → Stream<Event> только для чтения переопределение
onTouchCancel → Stream<TouchEvent> только для чтения переопределение: Поток событий touchcancel, обрабатываемых этим Window.
onTouchEnd → Stream<TouchEvent> только для чтения переопределение: Поток событий touchend, обрабатываемых этим Window.
onTouchMove → Stream<TouchEvent> только для чтения переопределение: Поток событий touchmove, обрабатываемых этим Window.
onTouchStart → Stream<TouchEvent> только для чтения переопределение: Поток событий touchstart, обрабатываемых этим Window.
onTransitionEnd → Stream<TransitionEvent> только для чтения: Поток событий transitionend, обрабатываемых этим Window.
onUnload → Stream<Event> только для чтения переопределение: Поток событий unload, обрабатываемых этим Window.
onVolumeChange → Stream<Event> только для чтения переопределение
onWaiting → Stream<Event> только для чтения переопределение
onWheel → Stream<WheelEvent> только для чтения переопределение: Поток событий wheel, обрабатываемых этим Window.
opener ↔ WindowBase? чтение / запись переопределение метода доступа: Ссылка на окно, открывшее это окно.
orientation → int? только для чтения
origin → String? только для чтения
outerHeight → int только для чтения: Высота этого окна, включая все элементы пользовательского интерфейса.
outerWidth → int только для чтения: Ширина этого окна, включая все элементы пользовательского интерфейса.
pageXOffset → int только для чтения
pageYOffset → int только для чтения
parent → WindowBase? только для чтения переопределение: Ссылка на родительское окно.
performance → Performance только для чтения: Данные о времени и навигации для этого окна.
runtimeType → Type только для чтения унаследовано: Представление типа объекта во время выполнения.
screen → Screen? только для чтения: Информация об экране, на котором отображается это окно.
screenLeft → int? только для чтения: Расстояние от левого края экрана до левого края этого окна.
screenTop → int? только для чтения: Расстояние от верхнего края экрана до верхнего края этого окна.
screenX → int? только для чтения: Расстояние от левого края экрана до указателя мыши.
screenY → int? только для чтения: Расстояние от верхнего края экрана до указателя мыши.
scrollbars → BarProp? только для чтения: Полосы прокрутки этого окна.

scrollX → int только для чтения: Расстояние, на которое это окно прокручено по горизонтали.
scrollY → int только для чтения: Расстояние, на которое это окно прокручено по вертикали.
self → WindowBase? только для чтения: Текущее окно.
sessionStorage → Storage только для чтения: Хранилище этого окна, которое очищается по завершении сеанса.
speechSynthesis → SpeechSynthesis? только для чтения: Доступ к синтезу речи в браузере.
status ↔ String? чтение / запись: Устарело.
statusbar → BarProp? только для чтения: Строка состояния этого окна.
styleMedia → StyleMedia? только для чтения: Доступ к медиазапросам CSS.
toolbar → BarProp? только для чтения: Панель инструментов этого окна.
top → WindowBase? только для чтения переопределено: Ссылка на самое верхнее окно в иерархии окон.
visualViewport → VisualViewport? только для чтения
window → WindowBase? только для чтения: Текущее окно.

Методы

addEventListener(String type, EventListener? listener, [bool? useCapture]) → void унаследовано
alert([String? message]) → void: Отображает пользователю модальное предупреждение.
atob(String atob) → String переопределено
btoa(String btoa) → String переопределено
cancelAnimationFrame(int id) → void: Отменяет запрос кадра анимации.
cancelIdleCallback(int handle) → void
close() → void переопределено: Закрывает окно.
confirm([String? message]) → bool: Отображает пользователю модальный запрос с вариантами «ОК» и «Отмена».
dispatchEvent(Event event) → bool унаследовано
fetch(dynamic input, [Map? init]) → Future
find(String? string, bool? caseSensitive, bool? backwards, bool? wrap, bool? wholeWord, bool? searchInFrames, bool? showDialog) → bool: Ищет текст в этом окне.
getComputedStyleMap(Element element, String? pseudoElement) → StylePropertyMapReadonly
getMatchedCssRules(Element? element, String? pseudoElement) → List<CssRule>: Возвращает все правила CSS, применяемые к псевдоэлементу элемента.
getSelection() → Selection?: Возвращает текущий выделенный текст.
matchMedia(String query) → MediaQueryList: Возвращает список медиазапросов для указанной строки запроса.
moveBy(int x, int y) → void: Перемещает это окно.
moveTo(Point<num> p) → void: Перемещает это окно в указанное положение.
noSuchMethod(Invocation invocation) → dynamic унаследовано: Вызывается при обращении к несуществующему методу или свойству.
open(String url, String name, [String? options]) → WindowBase: Открывает новое окно.
postMessage(dynamic message, String targetOrigin, [List<Object>? transfer]) → void переопределено: Отправляет междоменное сообщение.
print() → void: Открывает диалог печати для этого окна.
removeEventListener(String type, EventListener? listener, [bool? useCapture]) → void унаследовано
requestAnimationFrame(FrameRequestCallback callback) → int: Вызывается для отрисовки кадра анимации, а затем запрашивает перерисовку окна после завершения callback (создания анимации).
requestFileSystem(int size, {bool persistent = false}) → Future<FileSystem>: Предоставляет доступ к изолированной файловой системе размером size байт.
requestIdleCallback(IdleRequestCallback callback, [Map? options]) → int
resizeBy(int x, int y) → void: Изменяет размер этого окна на указанную величину.
resizeTo(int x, int y) → void: Изменяет размер этого окна, задавая определённые ширину и высоту.
resolveLocalFileSystemUrl(String url) → Future<Entry>: Асинхронно получает запись локальной файловой системы.
scroll([dynamic options_OR_x, dynamic y, Map? scrollOptions]) → void: Прокручивает страницу по горизонтали и вертикали до указанной точки.
scrollBy([dynamic options_OR_x, dynamic y, Map? scrollOptions]) → void: Прокручивает страницу по горизонтали и вертикали на указанную величину.
scrollTo([dynamic options_OR_x, dynamic y, Map? scrollOptions]) → void: Прокручивает страницу по горизонтали и вертикали до указанной точки.
stop() → void: Останавливает загрузку окна.
toString() → String унаследовано: Строковое представление этого объекта.

Операторы

operator ==(Object other) → bool унаследовано: Оператор равенства.

Статические свойства

supportsPointConversions → bool только для чтения: convertPointFromNodeToPage и convertPointFromPageToNode удалены. См. http://dev.w3.org/csswg/cssom-view/#geometry

Константы

animationEndEvent → const EventStreamProvider<AnimationEvent>: Статическая фабрика, предназначенная для предоставления событий animationend обработчикам событий, которые не обязательно являются экземплярами Window.
const EventStreamProvider<AnimationEvent>('webkitAnimationEnd')
animationIterationEvent → const EventStreamProvider<AnimationEvent>: Статическая фабрика, предназначенная для предоставления событий animationiteration обработчикам событий, которые не обязательно являются экземплярами Window.
const EventStreamProvider<AnimationEvent>('webkitAnimationIteration')
animationStartEvent → const EventStreamProvider<AnimationEvent>: Статическая фабрика, предназначенная для предоставления событий animationstart обработчикам событий, которые не обязательно являются экземплярами Window.
const EventStreamProvider<AnimationEvent>('webkitAnimationStart')
beforeUnloadEvent → const EventStreamProvider<BeforeUnloadEvent>: Статическая фабрика, предназначенная для предоставления событий beforeunload обработчикам событий, которые не обязательно являются экземплярами Window.
const EventStreamProvider('beforeunload')
contentLoadedEvent → const EventStreamProvider<Event>: Статическая фабрика, предназначенная для предоставления событий contentloaded обработчикам событий, которые не обязательно являются экземплярами Window.
const EventStreamProvider<Event>('DOMContentLoaded')
deviceMotionEvent → const EventStreamProvider<DeviceMotionEvent>: Статическая фабрика, предназначенная для предоставления событий devicemotion обработчикам событий, которые не обязательно являются экземплярами Window.
const EventStreamProvider<DeviceMotionEvent>('devicemotion')
deviceOrientationEvent → const EventStreamProvider<DeviceOrientationEvent>: Статическая фабрика, предназначенная для предоставления событий deviceorientation обработчикам событий, которые не обязательно являются экземплярами Window.
const EventStreamProvider<DeviceOrientationEvent>('deviceorientation')
hashChangeEvent → const EventStreamProvider<Event>: Статическая фабрика, предназначенная для предоставления событий hashchange обработчикам событий, которые не обязательно являются экземплярами Window.
const EventStreamProvider<Event>('hashchange')
loadStartEvent → const EventStreamProvider<Event>: const EventStreamProvider<Event>('loadstart')
messageEvent → const EventStreamProvider<MessageEvent>: Статическая фабрика, предназначенная для предоставления событий message обработчикам событий, которые не обязательно являются экземплярами Window.
const EventStreamProvider<MessageEvent>('message')
offlineEvent → const EventStreamProvider<Event>: Статическая фабрика, предназначенная для предоставления событий offline обработчикам событий, которые не обязательно являются экземплярами Window.
const EventStreamProvider<Event>('offline')
onlineEvent → const EventStreamProvider<Event>: Статическая фабрика, предназначенная для предоставления событий online обработчикам событий, которые не обязательно являются экземплярами Window.
const EventStreamProvider<Event>('online')
pageHideEvent → const EventStreamProvider<Event>: Статическая фабрика, предназначенная для предоставления событий pagehide обработчикам событий, которые не обязательно являются экземплярами Window.
const EventStreamProvider<Event>('pagehide')
pageShowEvent → const EventStreamProvider<Event>: Статическая фабрика, предназначенная для предоставления событий pageshow обработчикам событий, которые не обязательно являются экземплярами Window.
const EventStreamProvider<Event>('pageshow')
PERSISTENT → const int: Указывает, что данные файловой системы нельзя удалить без разрешения пользователя.
1
popStateEvent → const EventStreamProvider<PopStateEvent>: Статическая фабрика, предназначенная для предоставления событий popstate обработчикам событий, которые не обязательно являются экземплярами Window.
const EventStreamProvider<PopStateEvent>('popstate')
progressEvent → const EventStreamProvider<Event>: const EventStreamProvider<Event>('progress')
storageEvent → const EventStreamProvider<StorageEvent>: Статическая фабрика, предназначенная для предоставления событий storage обработчикам событий, которые не обязательно являются экземплярами Window.
const EventStreamProvider<StorageEvent>('storage')
TEMPORARY → const int: Указывает, что данные файловой системы могут быть удалены в любое время.
0
unloadEvent → const EventStreamProvider<Event>: Статическая фабрика, предназначенная для предоставления событий unload обработчикам событий, которые не обязательно являются экземплярами Window.
const EventStreamProvider<Event>('unload')

© 2012 the Dart project authors
Licensed under the BSD 3-Clause "New" or "Revised" License.
https://api.dart.dev/stable/2.19.6/dart-html/Window-class.html