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
  • DocsEditable()
  • DomName('Window')

Constants

animationEndEvent EventStreamProvider<AnimationEvent>

Static factory designed to expose animationend events to event handlers that are not necessarily instances of Window.

const EventStreamProvider<AnimationEvent>('webkitAnimationEnd')
animationIterationEvent EventStreamProvider<AnimationEvent>

Static factory designed to expose animationiteration events to event handlers that are not necessarily instances of Window.

const EventStreamProvider<AnimationEvent>('webkitAnimationIteration')
animationStartEvent EventStreamProvider<AnimationEvent>

Static factory designed to expose animationstart events to event handlers that are not necessarily instances of Window.

const EventStreamProvider<AnimationEvent>('webkitAnimationStart')
beforeUnloadEvent EventStreamProvider<BeforeUnloadEvent>

Static factory designed to expose beforeunload events to event handlers that are not necessarily instances of Window.

const _BeforeUnloadEventStreamProvider<BeforeUnloadEvent>('beforeunload')
contentLoadedEvent EventStreamProvider<Event>

Static factory designed to expose contentloaded events to event handlers that are not necessarily instances of Window.

const EventStreamProvider<Event>('DOMContentLoaded')
deviceMotionEvent EventStreamProvider<DeviceMotionEvent>

Static factory designed to expose devicemotion events to event handlers that are not necessarily instances of Window.

const EventStreamProvider<DeviceMotionEvent>('devicemotion')
deviceOrientationEvent EventStreamProvider<DeviceOrientationEvent>

Static factory designed to expose deviceorientation events to event handlers that are not necessarily instances of Window.

const EventStreamProvider<DeviceOrientationEvent>('deviceorientation')
hashChangeEvent EventStreamProvider<Event>

Static factory designed to expose hashchange events to event handlers that are not necessarily instances of Window.

const EventStreamProvider<Event>('hashchange')
loadStartEvent EventStreamProvider<Event>

const EventStreamProvider<Event>('loadstart')
messageEvent EventStreamProvider<MessageEvent>

Static factory designed to expose message events to event handlers that are not necessarily instances of Window.

const EventStreamProvider<MessageEvent>('message')
offlineEvent EventStreamProvider<Event>

Static factory designed to expose offline events to event handlers that are not necessarily instances of Window.

const EventStreamProvider<Event>('offline')
onlineEvent EventStreamProvider<Event>

Static factory designed to expose online events to event handlers that are not necessarily instances of Window.

const EventStreamProvider<Event>('online')
pageHideEvent EventStreamProvider<Event>

Static factory designed to expose pagehide events to event handlers that are not necessarily instances of Window.

const EventStreamProvider<Event>('pagehide')
pageShowEvent EventStreamProvider<Event>

Static factory designed to expose pageshow events to event handlers that are not necessarily instances of Window.

const EventStreamProvider<Event>('pageshow')
PERSISTENT int

Indicates that file system data cannot be cleared unless given user permission.

1
popStateEvent EventStreamProvider<PopStateEvent>

Static factory designed to expose popstate events to event handlers that are not necessarily instances of Window.

const EventStreamProvider<PopStateEvent>('popstate')
progressEvent EventStreamProvider<Event>

const EventStreamProvider<Event>('progress')
storageEvent EventStreamProvider<StorageEvent>

Static factory designed to expose storage events to event handlers that are not necessarily instances of Window.

const EventStreamProvider<StorageEvent>('storage')
TEMPORARY int

Indicates that file system data can be cleared at any time.

0
unloadEvent EventStreamProvider<Event>

Static factory designed to expose unload events to event handlers that are not necessarily instances of Window.

const EventStreamProvider<Event>('unload')

Static Properties

instanceRuntimeType Type

read-only
supportsPointConversions bool

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

read-only

Constructors

Window.internal_()

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
applicationCache ApplicationCache

The application cache for this window.

read-only
caches CacheStorage

read-only
closed bool

read-only
console Console

read-only
crypto Crypto

Entrypoint for the browser's cryptographic functions.

read-only
defaultStatus String

Deprecated*.

read / write
defaultstatus String

Deprecated*.

read / write
devicePixelRatio num

The ratio between physical pixels and logical CSS pixels.

read-only
document Document

read-only
hashCode int

read-only, inherited
history History

The current session history for this window's newest document.

read-only
indexedDB IdbFactory

read-only
innerHeight int

The height of the viewport including scrollbars.

read-only
innerWidth int

The width of the viewport including scrollbars.

read-only
localStorage Storage

Storage for this window that persists across sessions.

read-only
location Location

read-only
locationbar BarProp

This window's location bar, which displays the URL.

read-only

This window's menu bar, which displays menu commands.

read-only
name String

The name of this window.

read / write

The user agent accessing this window.

read-only
offscreenBuffering bool

Whether objects are drawn offscreen before being displayed.

read-only
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
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
opener WindowBase

read / write
orientation int

read-only
outerHeight int

The height of this window including all user interface elements.

read-only
outerWidth int

The width of the window including all user interface elements.

read-only
pageXOffset int

read-only
pageYOffset int

read-only
parent WindowBase

read-only
performance Performance

Timing and navigation data for this window.

read-only
runtimeType Type

A representation of the runtime type of the object.

read-only, inherited
screen Screen

Information about the screen displaying this window.

read-only
screenLeft int

The distance from the left side of the screen to the left side of this window.

read-only
screenTop int

The distance from the top of the screen to the top of this window.

read-only
screenX int

The distance from the left side of the screen to the mouse pointer.

read-only
screenY int

The distance from the top of the screen to the mouse pointer.

read-only
scrollbars BarProp

This window's scroll bars.

read-only
scrollX int

read-only
scrollY int

read-only
self WindowBase

The current window.

read-only
sessionStorage Storage

Storage for this window that is cleared when this session ends.

read-only
speechSynthesis SpeechSynthesis

Access to speech synthesis in the browser.

read-only
status String

Deprecated*.

read / write
statusbar BarProp

This window's status bar.

read-only
styleMedia StyleMedia

Access to CSS media queries.

read-only
toolbar BarProp

This window's tool bar.

read-only
top WindowBase

read-only
window WindowBase

The current window.

read-only

Operators

operator ==(other) bool

The equality operator.

inherited

Methods

addEventListener(String type, EventListener listener(Event event), [bool useCapture]) → void

inherited
alert([String message]) → void

atob(String atob) String

btoa(String btoa) String

cancelAnimationFrame(int handle) → void

close() → void

Closes the window.

confirm([String message]) bool

dispatchEvent(Event event) bool

inherited
fetch(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.

getMatchedCssRules(Element element, String pseudoElement) List<CssRule>

Returns all CSS rules that apply to the element's pseudo-element.

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 p) → void

Moves this window to a specific position.

noSuchMethod(Invocation invocation) → dynamic

Invoked when a non-existent method or property is accessed.

inherited
open(String url, String target, [String features]) WindowBase

openDatabase(String name, String version, String displayName, int estimatedSize, [DatabaseCallback creationCallback(SqlDatabase database)]) SqlDatabase

postMessage(Object message, String targetOrigin, [List<MessagePort> transfer]) → void

Sends a cross-origin message.

print() → void

Opens the print dialog for this window.

removeEventListener(String type, EventListener listener(Event event), [bool useCapture]) → void

inherited
requestAnimationFrame(FrameRequestCallback callback(num highResTime)) 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.

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>

scroll([options_OR_x, y, Map scrollOptions]) → void

scrollBy([options_OR_x, y, Map scrollOptions]) → void

scrollTo([options_OR_x, y, Map scrollOptions]) → void

stop() → void

Stops the window from loading.

toString() String

Returns the result of the JavaScript objects toString method.

inherited