Window class

Top-level container for the current browser tab or window.

In a web browser, each window has a Window object, but within the context of a script, this object represents only the current window. Each other window, tab, and iframe has its own Window object.

Each window contains a Document object, which contains all of the window's content.

Use the top-level window object to access the current window. For example:

// 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!');

Note: This class represents only the current window, while WindowBase is a representation of any window, including other tabs, windows, and frames.

See also

Other resources

Inheritance
Implements
Annotations
  • @Native("Window,DOMWindow")

Properties

animationFrame Future<num>
Returns a Future that completes just before the window is about to repaint so the user can draw an animation frame. [...]
read-only
animationWorklet → _Worklet
final
applicationCache ApplicationCache
The application cache for this window. [...]
final
audioWorklet → _Worklet
final
caches CacheStorage
final
closed bool
final
console Console
The debugging console for this window.
read-only
cookieStore CookieStore
final
crypto Crypto
Entrypoint for the browser's cryptographic functions. [...]
final
customElements CustomElementRegistry
final
defaultStatus String
Deprecated*.
read / write
defaultstatus String
Deprecated*.
read / write
devicePixelRatio num
The ratio between physical pixels and logical CSS pixels. [...]
final
document Document
The newest document in this window. [...]
read-only
external External
final
history History
The current session history for this window's newest document. [...]
final
indexedDB IdbFactory
Gets an instance of the Indexed DB factory to being using Indexed DB. [...]
@SupportedBrowser(SupportedBrowser.CHROME, '23.0'), @SupportedBrowser(SupportedBrowser.FIREFOX, '15.0'), @SupportedBrowser(SupportedBrowser.IE, '10.0'), read-only
innerHeight int
The height of the viewport including scrollbars. [...]
final
innerWidth int
The width of the viewport including scrollbars. [...]
final
isSecureContext bool
final
localStorage Storage
Storage for this window that persists across sessions. [...]
final
location Location
The current location of this window. [...]
read / write
locationbar BarProp
This window's location bar, which displays the URL. [...]
final
This window's menu bar, which displays menu commands. [...]
final
name String
The name of this window. [...]
read / write
The user agent accessing this window. [...]
final
offscreenBuffering bool
Whether objects are drawn offscreen before being displayed. [...]
final
onAbort Stream<Event>
Stream of abort events handled by this Window.
read-only
onAnimationEnd Stream<AnimationEvent>
Stream of animationend events handled by this Window.
read-only
onAnimationIteration Stream<AnimationEvent>
Stream of animationiteration events handled by this Window.
read-only
onAnimationStart Stream<AnimationEvent>
Stream of animationstart events handled by this Window.
read-only
onBeforeUnload Stream<Event>
Stream of beforeunload events handled by this Window.
read-only
onBlur Stream<Event>
Stream of blur events handled by this Window.
read-only
onCanPlay Stream<Event>
read-only
onCanPlayThrough Stream<Event>
read-only
onChange Stream<Event>
Stream of change events handled by this Window.
read-only
onClick Stream<MouseEvent>
Stream of click events handled by this Window.
read-only
onContentLoaded Stream<Event>
Stream of contentloaded events handled by this Window.
read-only
onContextMenu Stream<MouseEvent>
Stream of contextmenu events handled by this Window.
read-only
onDeviceMotion Stream<DeviceMotionEvent>
Stream of devicemotion events handled by this Window.
read-only
onDeviceOrientation Stream<DeviceOrientationEvent>
Stream of deviceorientation events handled by this Window.
read-only
onDoubleClick Stream<Event>
Stream of doubleclick events handled by this Window.
read-only
onDrag Stream<MouseEvent>
Stream of drag events handled by this Window.
read-only
onDragEnd Stream<MouseEvent>
Stream of dragend events handled by this Window.
read-only
onDragEnter Stream<MouseEvent>
Stream of dragenter events handled by this Window.
read-only
onDragLeave Stream<MouseEvent>
Stream of dragleave events handled by this Window.
read-only
onDragOver Stream<MouseEvent>
Stream of dragover events handled by this Window.
read-only
onDragStart Stream<MouseEvent>
Stream of dragstart events handled by this Window.
read-only
onDrop Stream<MouseEvent>
Stream of drop events handled by this Window.
read-only
onDurationChange Stream<Event>
read-only
onEmptied Stream<Event>
read-only
onEnded Stream<Event>
read-only
onError Stream<Event>
Stream of error events handled by this Window.
read-only
onFocus Stream<Event>
Stream of focus events handled by this Window.
read-only
onHashChange Stream<Event>
Stream of hashchange events handled by this Window.
read-only
onInput Stream<Event>
Stream of input events handled by this Window.
read-only
onInvalid Stream<Event>
Stream of invalid events handled by this Window.
read-only
onKeyDown Stream<KeyboardEvent>
Stream of keydown events handled by this Window.
read-only
onKeyPress Stream<KeyboardEvent>
Stream of keypress events handled by this Window.
read-only
onKeyUp Stream<KeyboardEvent>
Stream of keyup events handled by this Window.
read-only
onLoad Stream<Event>
Stream of load events handled by this Window.
read-only
onLoadedData Stream<Event>
read-only
onLoadedMetadata Stream<Event>
read-only
onLoadStart Stream<Event>
read-only
onMessage Stream<MessageEvent>
Stream of message events handled by this Window.
read-only
onMouseDown Stream<MouseEvent>
Stream of mousedown events handled by this Window.
read-only
onMouseEnter Stream<MouseEvent>
Stream of mouseenter events handled by this Window.
read-only
onMouseLeave Stream<MouseEvent>
Stream of mouseleave events handled by this Window.
read-only
onMouseMove Stream<MouseEvent>
Stream of mousemove events handled by this Window.
read-only
onMouseOut Stream<MouseEvent>
Stream of mouseout events handled by this Window.
read-only
onMouseOver Stream<MouseEvent>
Stream of mouseover events handled by this Window.
read-only
onMouseUp Stream<MouseEvent>
Stream of mouseup events handled by this Window.
read-only
onMouseWheel Stream<WheelEvent>
Stream of mousewheel events handled by this Window.
read-only
onOffline Stream<Event>
Stream of offline events handled by this Window.
read-only
onOnline Stream<Event>
Stream of online events handled by this Window.
read-only
onPageHide Stream<Event>
Stream of pagehide events handled by this Window.
read-only
onPageShow Stream<Event>
Stream of pageshow events handled by this Window.
read-only
onPause Stream<Event>
read-only
onPlay Stream<Event>
read-only
onPlaying Stream<Event>
read-only
onPopState Stream<PopStateEvent>
Stream of popstate events handled by this Window.
read-only
onProgress Stream<Event>
read-only
onRateChange Stream<Event>
read-only
onReset Stream<Event>
Stream of reset events handled by this Window.
read-only
onResize Stream<Event>
Stream of resize events handled by this Window.
read-only
onScroll Stream<Event>
Stream of scroll events handled by this Window.
read-only
onSearch Stream<Event>
Stream of search events handled by this Window.
read-only
onSeeked Stream<Event>
read-only
onSeeking Stream<Event>
read-only
onSelect Stream<Event>
Stream of select events handled by this Window.
read-only
onStalled Stream<Event>
read-only
onStorage Stream<StorageEvent>
Stream of storage events handled by this Window.
read-only
onSubmit Stream<Event>
Stream of submit events handled by this Window.
read-only
onSuspend Stream<Event>
read-only
onTimeUpdate Stream<Event>
read-only
onTouchCancel Stream<TouchEvent>
Stream of touchcancel events handled by this Window.
read-only
onTouchEnd Stream<TouchEvent>
Stream of touchend events handled by this Window.
read-only
onTouchMove Stream<TouchEvent>
Stream of touchmove events handled by this Window.
read-only
onTouchStart Stream<TouchEvent>
Stream of touchstart events handled by this Window.
read-only
onTransitionEnd Stream<TransitionEvent>
Stream of transitionend events handled by this Window.
read-only
onUnload Stream<Event>
Stream of unload events handled by this Window.
read-only
onVolumeChange Stream<Event>
read-only
onWaiting Stream<Event>
read-only
onWheel Stream<WheelEvent>
Stream of wheel events handled by this Window.
read-only
opener WindowBase
A reference to the window that opened this one. [...]
read / write
orientation int
final
origin String
final
outerHeight int
The height of this window including all user interface elements. [...]
final
outerWidth int
The width of the window including all user interface elements. [...]
final
pageXOffset int
read-only
pageYOffset int
read-only
parent WindowBase
A reference to the parent of this window. [...]
read-only
performance Performance
Timing and navigation data for this window. [...]
@SupportedBrowser(SupportedBrowser.CHROME), @SupportedBrowser(SupportedBrowser.FIREFOX), @SupportedBrowser(SupportedBrowser.IE), final
screen Screen
Information about the screen displaying this window. [...]
final
screenLeft int
The distance from the left side of the screen to the left side of this window. [...]
final
screenTop int
The distance from the top of the screen to the top of this window. [...]
final
screenX int
The distance from the left side of the screen to the mouse pointer. [...]
final
screenY int
The distance from the top of the screen to the mouse pointer. [...]
final
scrollbars BarProp
This window's scroll bars. [...]
final
scrollX int
The distance this window has been scrolled horizontally. [...]
read-only
scrollY int
The distance this window has been scrolled vertically. [...]
read-only
self WindowBase
The current window. [...]
read-only
sessionStorage Storage
Storage for this window that is cleared when this session ends. [...]
final
speechSynthesis SpeechSynthesis
Access to speech synthesis in the browser. [...]
final
status String
Deprecated*.
read / write
statusbar BarProp
This window's status bar. [...]
final
styleMedia StyleMedia
Access to CSS media queries. [...]
final
toolbar BarProp
This window's tool bar. [...]
final
top WindowBase
A reference to the topmost window in the window hierarchy. [...]
read-only
visualViewport VisualViewport
final
window WindowBase
The current window. [...]
read-only
hashCode int
The hash code for this object. [...]
read-only, inherited
on Events
This is an ease-of-use accessor for event streams which should only be used when an explicit accessor is not available.
read-only, inherited
runtimeType Type
A representation of the runtime type of the object.
read-only, inherited

Methods

alert([String message ]) → void
Displays a modal alert to the user. [...]
atob(String atob) String
btoa(String btoa) String
cancelAnimationFrame(int id) → void
Cancels an animation frame request. [...]
cancelIdleCallback(int handle) → void
close() → void
Closes the window. [...]
confirm([String message ]) bool
Displays a modal OK/Cancel prompt to the user. [...]
fetch(dynamic input, [ Map init ]) Future
find(String string, bool caseSensitive, bool backwards, bool wrap, bool wholeWord, bool searchInFrames, bool showDialog) bool
Finds text in this window. [...]
getComputedStyleMap(Element element, String pseudoElement) StylePropertyMapReadonly
getMatchedCssRules(Element element, String pseudoElement) List<CssRule>
Returns all CSS rules that apply to the element's pseudo-element.
@Creates('_CssRuleList'), @JSName('getMatchedCSSRules'), @Returns('_CssRuleList|Null')
getSelection() Selection
Returns the currently selected text. [...]
matchMedia(String query) MediaQueryList
Returns a list of media queries for the given query string. [...]
moveBy(int x, int y) → void
Moves this window. [...]
moveTo(Point<num> p) → void
Moves this window to a specific position. [...]
open(String url, String name, [ String options ]) WindowBase
Opens a new window. [...]
openDatabase(String name, String version, String displayName, int estimatedSize, [ DatabaseCallback creationCallback ]) SqlDatabase
@Creates('SqlDatabase'), @JSName('openDatabase'), @SupportedBrowser(SupportedBrowser.CHROME), @SupportedBrowser(SupportedBrowser.SAFARI)
postMessage(dynamic message, String targetOrigin, [ List<Object> transfer ]) → void
Sends a cross-origin message. [...]
print() → void
Opens the print dialog for this window. [...]
requestAnimationFrame(FrameRequestCallback callback) int
Called to draw an animation frame and then request the window to repaint after callback has finished (creating the animation). [...]
requestFileSystem(int size, { bool persistent: false }) Future<FileSystem>
Access a sandboxed file system of the specified size. If persistent is true, the application will request permission from the user to create lasting storage. This storage cannot be freed without the user's permission. Returns a Future whose value stores a reference to the sandboxed file system for use. Because the file system is sandboxed, applications cannot access file systems created in other web pages.
requestIdleCallback(IdleRequestCallback callback, [ Map options ]) int
resizeBy(int x, int y) → void
Resizes this window by an offset. [...]
resizeTo(int x, int y) → void
Resizes this window to a specific width and height. [...]
resolveLocalFileSystemUrl(String url) Future<Entry>
Asynchronously retrieves a local filesystem entry. [...]
@JSName('webkitResolveLocalFileSystemURL'), @SupportedBrowser(SupportedBrowser.CHROME)
scroll([dynamic options_OR_x, dynamic y, Map scrollOptions ]) → void
Scrolls the page horizontally and vertically to a specific point. [...]
scrollBy([dynamic options_OR_x, dynamic y, Map scrollOptions ]) → void
Scrolls the page horizontally and vertically by an offset. [...]
scrollTo([dynamic options_OR_x, dynamic y, Map scrollOptions ]) → void
Scrolls the page horizontally and vertically to a specific point. [...]
stop() → void
Stops the window from loading. [...]
addEventListener(String type, EventListener listener, [ bool useCapture ]) → void
inherited
dispatchEvent(Event event) bool
inherited
noSuchMethod(Invocation invocation) → dynamic
Invoked when a non-existent method or property is accessed. [...]
inherited
removeEventListener(String type, EventListener listener, [ bool useCapture ]) → void
inherited
toString() String
Returns a string representation of this object.
inherited

Operators

operator ==(dynamic other) bool
The equality operator. [...]
inherited

Static Properties

supportsPointConversions bool
convertPointFromNodeToPage and convertPointFromPageToNode are removed. see http://dev.w3.org/csswg/cssom-view/#geometry
read-only

Constants

animationEndEvent → const EventStreamProvider<AnimationEvent>
Static factory designed to expose animationend events to event handlers that are not necessarily instances of Window. [...]
@SupportedBrowser(SupportedBrowser.CHROME), @SupportedBrowser(SupportedBrowser.SAFARI)
const EventStreamProvider<AnimationEvent>('webkitAnimationEnd')
animationIterationEvent → const EventStreamProvider<AnimationEvent>
Static factory designed to expose animationiteration events to event handlers that are not necessarily instances of Window. [...]
@SupportedBrowser(SupportedBrowser.CHROME), @SupportedBrowser(SupportedBrowser.SAFARI)
const EventStreamProvider<AnimationEvent>('webkitAnimationIteration')
animationStartEvent → const EventStreamProvider<AnimationEvent>
Static factory designed to expose animationstart events to event handlers that are not necessarily instances of Window. [...]
@SupportedBrowser(SupportedBrowser.CHROME), @SupportedBrowser(SupportedBrowser.SAFARI)
const EventStreamProvider<AnimationEvent>('webkitAnimationStart')
beforeUnloadEvent → const EventStreamProvider<BeforeUnloadEvent>
Static factory designed to expose beforeunload events to event handlers that are not necessarily instances of Window. [...]
const _BeforeUnloadEventStreamProvider('beforeunload')
contentLoadedEvent → const EventStreamProvider<Event>
Static factory designed to expose contentloaded events to event handlers that are not necessarily instances of Window. [...]
const EventStreamProvider<Event>('DOMContentLoaded')
deviceMotionEvent → const EventStreamProvider<DeviceMotionEvent>
Static factory designed to expose devicemotion events to event handlers that are not necessarily instances of Window. [...]
const EventStreamProvider<DeviceMotionEvent>('devicemotion')
deviceOrientationEvent → const EventStreamProvider<DeviceOrientationEvent>
Static factory designed to expose deviceorientation events to event handlers that are not necessarily instances of Window. [...]
const EventStreamProvider<DeviceOrientationEvent>('deviceorientation')
hashChangeEvent → const EventStreamProvider<Event>
Static factory designed to expose hashchange events to event handlers that are not necessarily instances of Window. [...]
const EventStreamProvider<Event>('hashchange')
loadStartEvent → const EventStreamProvider<Event>
const EventStreamProvider<Event>('loadstart')
messageEvent → const EventStreamProvider<MessageEvent>
Static factory designed to expose message events to event handlers that are not necessarily instances of Window. [...]
const EventStreamProvider<MessageEvent>('message')
offlineEvent → const EventStreamProvider<Event>
Static factory designed to expose offline events to event handlers that are not necessarily instances of Window. [...]
const EventStreamProvider<Event>('offline')
onlineEvent → const EventStreamProvider<Event>
Static factory designed to expose online events to event handlers that are not necessarily instances of Window. [...]
const EventStreamProvider<Event>('online')
pageHideEvent → const EventStreamProvider<Event>
Static factory designed to expose pagehide events to event handlers that are not necessarily instances of Window. [...]
const EventStreamProvider<Event>('pagehide')
pageShowEvent → const EventStreamProvider<Event>
Static factory designed to expose pageshow events to event handlers that are not necessarily instances of Window. [...]
const EventStreamProvider<Event>('pageshow')
PERSISTENT → const int
Indicates that file system data cannot be cleared unless given user permission. [...]
1
popStateEvent → const EventStreamProvider<PopStateEvent>
Static factory designed to expose popstate events to event handlers that are not necessarily instances of Window. [...]
const EventStreamProvider<PopStateEvent>('popstate')
progressEvent → const EventStreamProvider<Event>
const EventStreamProvider<Event>('progress')
storageEvent → const EventStreamProvider<StorageEvent>
Static factory designed to expose storage events to event handlers that are not necessarily instances of Window. [...]
const EventStreamProvider<StorageEvent>('storage')
TEMPORARY → const int
Indicates that file system data can be cleared at any time. [...]
0
unloadEvent → const EventStreamProvider<Event>
Static factory designed to expose unload events to event handlers that are not necessarily instances of Window. [...]
const EventStreamProvider<Event>('unload')