The Window interface represents a window containing a DOM document; the document property points to the DOM document loaded in that window.

Documentation Window by Mozilla Contributors, licensed under CC-BY-SA 2.5.

See also:

Variables

read onlyclosed:Bool

This property indicates whether the current window is closed or not.

read onlyconsole:ConsoleInstance

Returns a reference to the console object which provides access to the browser's debugging console.

read onlycontent:Dynamic

Returns a reference to the content element in the current window. Since Firefox 57 (initially Nightly-only), both versions are only available from chrome (privileged) code, and not available to the web anymore.

read onlycrypto:Crypto

Returns the browser crypto object.

read onlydevicePixelRatio:Float

Returns the ratio between physical pixels and device independent pixels in the current display.

read onlydocument:HTMLDocument

Returns a reference to the document that the window contains.

read onlyevent:Dynamic

Returns the current event, which is the event currently being handled by the JavaScript code's context, or undefined if no event is currently being handled. The Event object passed directly to event handlers should be used instead whenever possible.

read onlyframeElement:Element

Returns the element in which the window is embedded, or null if the window is not embedded.

read onlyframes:Window

Returns an array of the subframes in the current window.

fullScreen:Bool

This property indicates whether the window is displayed in full screen or not.

read onlyhistory:History

Returns a reference to the history object.

innerHeight:Dynamic

Gets the height of the content area of the browser window including, if rendered, the horizontal scrollbar.

innerWidth:Dynamic

Gets the width of the content area of the browser window including, if rendered, the vertical scrollbar.

read onlyisSecureContext:Bool

Indicates whether a context is capable of using features that require secure contexts.

read onlylength:Int

Returns the number of frames in the window. See also window.frames.

read onlylocalStorage:Storage

Returns a reference to the local storage object used to store data that may only be accessed by the origin that created it.

read onlylocation:Location

Gets/sets the location, or current URL, of the window object.

read onlylocationbar:BarProp

Returns the locationbar object, whose visibility can be toggled in the window.

read onlymenubar:BarProp

Returns the menubar object, whose visibility can be toggled in the window.

name:String

Gets/sets the name of the window.

read onlynavigator:Navigator

Returns a reference to the navigator object.

opener:Dynamic

Returns a reference to the window that opened this current window.

read onlyorientation:Int

Returns the orientation in degrees (in 90 degree increments) of the viewport relative to the device's natural orientation.

read onlyorigin:String

outerHeight:Dynamic

Gets the height of the outside of the browser window.

outerWidth:Dynamic

Gets the width of the outside of the browser window.

read onlypageXOffset:Float

An alias for window.scrollX.

read onlypageYOffset:Float

An alias for window.scrollY

read onlyparent:Window

Returns a reference to the parent of the current window or subframe.

read onlyperformance:Performance

Returns a Performance object, which includes the Performance.timing and Performance.navigation attributes, each of which is an object providing performance-related data. See also Using Navigation Timing for additional information and examples.

read onlypersonalbar:BarProp

Returns the personalbar object, whose visibility can be toggled in the window.

read onlyscreen:Screen

Returns a reference to the screen object associated with the window.

screenX:Dynamic

Returns the horizontal distance of the left border of the user's browser from the left side of the screen.

screenY:Dynamic

Returns the vertical distance of the top border of the user's browser from the top side of the screen.

read onlyscrollMaxX:Int

The maximum offset that the window can be scrolled to horizontally, that is the document width minus the viewport width.

read onlyscrollMaxY:Int

The maximum offset that the window can be scrolled to vertically (i.e., the document height minus the viewport height).

read onlyscrollX:Float

Returns the number of pixels that the document has already been scrolled horizontally.

read onlyscrollY:Float

Returns the number of pixels that the document has already been scrolled vertically.

read onlyscrollbars:BarProp

Returns the scrollbars object, whose visibility can be toggled in the window.

read onlyself:Window

Returns an object reference to the window object itself.

read onlysessionStorage:Storage

Returns a reference to the session storage object used to store data that may only be accessed by the origin that created it.

read onlyspeechSynthesis:SpeechSynthesis

Returns a SpeechSynthesis object, which is the entry point into using Web Speech API speech synthesis functionality.

status:String

Gets/sets the text in the statusbar at the bottom of the browser.

read onlystatusbar:BarProp

Returns the statusbar object, whose visibility can be toggled in the window.

read onlytoolbar:BarProp

Returns the toolbar object, whose visibility can be toggled in the window.

read onlytop:Window

Returns a reference to the topmost window in the window hierarchy. This property is read only.

read onlywindow:Window

Returns a reference to the current window.

Methods

alert(message:String):Void

alert():Void

Displays an alert dialog.

Throws:

null

DOMError

atob(atob:String):String

Throws:

null

DOMError

blur():Void

Sets focus away from the window.

Throws:

null

DOMError

btoa(btoa:String):String

Throws:

null

DOMError

cancelAnimationFrame(handle:Int):Void

Enables you to cancel a callback previously scheduled with Window.requestAnimationFrame.

Throws:

null

DOMError

captureEvents():Void

Registers the window to capture all events of the specified type.

@:value({ handle : 0 })clearInterval(handle:Int = 0):Void

@:value({ handle : 0 })clearTimeout(handle:Int = 0):Void

close():Void

Closes the current window.

Throws:

null

DOMError

@:value({ message : "" })confirm(message:String = ""):Bool

Displays a dialog with a message that the user needs to respond to.

Throws:

null

DOMError

createImageBitmap(aImage:ImageElement, aOffset:Int, aLength:Int, aFormat:ImageBitmapFormat, aLayout:Array<ChannelPixelLayout>):Promise<ImageBitmap>

createImageBitmap(aImage:VideoElement):Promise<ImageBitmap>

createImageBitmap(aImage:CanvasElement):Promise<ImageBitmap>

createImageBitmap(aImage:Blob):Promise<ImageBitmap>

createImageBitmap(aImage:ImageData):Promise<ImageBitmap>

createImageBitmap(aImage:CanvasRenderingContext2D):Promise<ImageBitmap>

createImageBitmap(aImage:ImageBitmap):Promise<ImageBitmap>

createImageBitmap(aImage:ArrayBufferView):Promise<ImageBitmap>

createImageBitmap(aImage:ArrayBuffer):Promise<ImageBitmap>

createImageBitmap(aImage:VideoElement, aSx:Int, aSy:Int, aSw:Int, aSh:Int):Promise<ImageBitmap>

createImageBitmap(aImage:CanvasElement, aSx:Int, aSy:Int, aSw:Int, aSh:Int):Promise<ImageBitmap>

createImageBitmap(aImage:Blob, aSx:Int, aSy:Int, aSw:Int, aSh:Int):Promise<ImageBitmap>

createImageBitmap(aImage:ImageData, aSx:Int, aSy:Int, aSw:Int, aSh:Int):Promise<ImageBitmap>

createImageBitmap(aImage:CanvasRenderingContext2D, aSx:Int, aSy:Int, aSw:Int, aSh:Int):Promise<ImageBitmap>

createImageBitmap(aImage:ImageBitmap, aSx:Int, aSy:Int, aSw:Int, aSh:Int):Promise<ImageBitmap>

createImageBitmap(aImage:ArrayBufferView, aSx:Int, aSy:Int, aSw:Int, aSh:Int):Promise<ImageBitmap>

createImageBitmap(aImage:ArrayBuffer, aSx:Int, aSy:Int, aSw:Int, aSh:Int):Promise<ImageBitmap>

createImageBitmap(aImage:VideoElement, aOffset:Int, aLength:Int, aFormat:ImageBitmapFormat, aLayout:Array<ChannelPixelLayout>):Promise<ImageBitmap>

createImageBitmap(aImage:CanvasElement, aOffset:Int, aLength:Int, aFormat:ImageBitmapFormat, aLayout:Array<ChannelPixelLayout>):Promise<ImageBitmap>

createImageBitmap(aImage:Blob, aOffset:Int, aLength:Int, aFormat:ImageBitmapFormat, aLayout:Array<ChannelPixelLayout>):Promise<ImageBitmap>

createImageBitmap(aImage:ImageData, aOffset:Int, aLength:Int, aFormat:ImageBitmapFormat, aLayout:Array<ChannelPixelLayout>):Promise<ImageBitmap>

createImageBitmap(aImage:CanvasRenderingContext2D, aOffset:Int, aLength:Int, aFormat:ImageBitmapFormat, aLayout:Array<ChannelPixelLayout>):Promise<ImageBitmap>

createImageBitmap(aImage:ImageBitmap, aOffset:Int, aLength:Int, aFormat:ImageBitmapFormat, aLayout:Array<ChannelPixelLayout>):Promise<ImageBitmap>

createImageBitmap(aImage:ArrayBufferView, aOffset:Int, aLength:Int, aFormat:ImageBitmapFormat, aLayout:Array<ChannelPixelLayout>):Promise<ImageBitmap>

createImageBitmap(aImage:ArrayBuffer, aOffset:Int, aLength:Int, aFormat:ImageBitmapFormat, aLayout:Array<ChannelPixelLayout>):Promise<ImageBitmap>

createImageBitmap(aImage:ImageElement):Promise<ImageBitmap>

createImageBitmap(aImage:ImageElement, aSx:Int, aSy:Int, aSw:Int, aSh:Int):Promise<ImageBitmap>

Throws:

null

DOMError

dump(str:String):Void

Writes a message to the console.

@:value({ showDialog : false, searchInFrames : false, wholeWord : false, wrapAround : false, backwards : false, caseSensitive : false, str : "" })find(str:String = "", caseSensitive:Bool = false, backwards:Bool = false, wrapAround:Bool = false, wholeWord:Bool = false, searchInFrames:Bool = false, showDialog:Bool = false):Bool

Searches for a given string in a window.

Throws:

null

DOMError

focus():Void

Sets focus on the current window.

Throws:

null

DOMError

@:value({ pseudoElt : "" })getComputedStyle(elt:Element, pseudoElt:String = ""):CSSStyleDeclaration

Gets computed style for the specified element. Computed style indicates the computed values of all CSS properties of the element.

Throws:

null

DOMError

@:value({ pseudoElt : "" })getDefaultComputedStyle(elt:Element, pseudoElt:String = ""):CSSStyleDeclaration

Gets default computed style for the specified element, ignoring author stylesheets.

Throws:

null

DOMError

getSelection():Selection

Returns the selection object representing the selected item(s).

Throws:

null

DOMError

matchMedia(query:String):MediaQueryList

Returns a MediaQueryList object representing the specified media query string.

Throws:

null

DOMError

moveBy(x:Int, y:Int):Void

Moves the current window by a specified amount.

Throws:

null

DOMError

moveTo(x:Int, y:Int):Void

Moves the window to the specified coordinates.

Throws:

null

DOMError

@:value({ features : "", target : "", url : "" })open(url:String = "", target:String = "", features:String = ""):Window

Opens a new window.

Throws:

null

DOMError

postMessage(message:Dynamic, targetOrigin:String, ?transfer:Array<Dynamic>):Void

Provides a secure means for one window to send a string of data to another window, which need not be within the same domain as the first.

Throws:

null

DOMError

print():Void

Opens the Print Dialog to print the current document.

Throws:

null

DOMError

@:value({ default_ : "", message : "" })prompt(message:String = "", default_:String = ""):String

Returns the text entered by the user in a prompt dialog.

Throws:

null

DOMError

releaseEvents():Void

Releases the window from trapping events of a specific type.

requestAnimationFrame(callback:Float ‑> Void):Int

Tells the browser that an animation is in progress, requesting that the browser schedule a repaint of the window for the next animation frame.

Throws:

null

DOMError

resizeBy(x:Int, y:Int):Void

Resizes the current window by a certain amount.

Throws:

null

DOMError

resizeTo(x:Int, y:Int):Void

Dynamically resizes window.

Throws:

null

DOMError

scroll(?options:ScrollToOptions):Void

scroll(x:Float, y:Float):Void

Scrolls the window to a particular place in the document.

scrollBy(?options:ScrollToOptions):Void

scrollBy(x:Float, y:Float):Void

Scrolls the document in the window by the given amount.

scrollByLines(numLines:Int, ?options:ScrollOptions):Void

Scrolls the document by the given number of lines.

scrollByPages(numPages:Int, ?options:ScrollOptions):Void

Scrolls the current document by the specified number of pages.

scrollTo(?options:ScrollToOptions):Void

scrollTo(x:Float, y:Float):Void

Scrolls to a particular set of coordinates in the document.

@:value({ timeout : 0 })setInterval(handler:String, timeout:Float = 0, unused:Rest<Dynamic>):Int

@:value({ timeout : 0 })setInterval(handler:Function, timeout:Float = 0, arguments:Rest<Dynamic>):Int

Throws:

null

DOMError

setResizable(resizable:Bool):Void

Toggles a user's ability to resize a window.

@:value({ timeout : 0 })setTimeout(handler:String, timeout:Float = 0, unused:Rest<Dynamic>):Int

@:value({ timeout : 0 })setTimeout(handler:Function, timeout:Float = 0, arguments:Rest<Dynamic>):Int

Throws:

null

DOMError

sizeToContent():Void

Sizes the window according to its content.

Throws:

null

DOMError

stop():Void

This method stops window loading.

Throws:

null

DOMError

structuredClone<T>(value:T, ?options:{transfer:Array<Any>}):T

Creates a deep clone of a given value using the structured clone algorithm.

@:value({ reason : 0 })updateCommands(action:String, ?sel:Selection, reason:Int = 0):Void

Updates the state of commands of the current chrome window (UI).

Inherited Variables

Inherited Methods

Defined by EventTarget

addEventListener(type:String, listener:Function, ?options:EitherType<AddEventListenerOptions, Bool>, ?wantsUntrusted:Bool):Void

addEventListener(type:String, listener:EventListener, ?options:EitherType<AddEventListenerOptions, Bool>, ?wantsUntrusted:Bool):Void

Register an event handler of a specific event type on the EventTarget.

Throws:

null

DOMError

dispatchEvent(event:Event):Bool

Dispatch an event to this EventTarget.

Throws:

null

DOMError

removeEventListener(type:String, listener:Function, ?options:EitherType<EventListenerOptions, Bool>):Void

removeEventListener(type:String, listener:EventListener, ?options:EitherType<EventListenerOptions, Bool>):Void

Removes an event listener from the EventTarget.

Throws:

null

DOMError