Returns a reference to the topmost window in the window hierarchy.

Syntax

var topWindow = window.top;

Notes

Where the window.parent property returns the immediate parent of the current window, window.top returns the topmost window in the hierarchy of window objects.

This property is especially useful when you are dealing with a window that is in a subframe of a parent or parents, and you want to get to the top-level frameset.

Specifications

Specification Status Comment
HTML Living Standard
The definition of 'window.top' in that specification.
Living Standard  
HTML5
The definition of 'window.top' in that specification.
Recommendation Initial definition

Browser compatibility

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support Yes Yes Yes1 Yes Yes Yes
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Basic support ? ? Yes ? ? ? ?

1. Starting in Firefox 6, this property is read only, as defined by the standard.

Document Tags and Contributors

Last updated by: connorshea,