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.

Other resources

DOM Window from MDN.
Window from the W3C.

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
menubar → BarProp: This window's menu bar, which displays menu commands. [...]
final
name ↔ String: The name of this window. [...]
read / write
navigator → Navigator: 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')

dart:html library