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 |
|---|---|---|
| WHATWG 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
| Feature | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
| Basic support | (Yes) | (Yes) | (Yes)[1] | (Yes) | (Yes) | (Yes) |
| Feature | Android | Edge | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| Basic support | ? | (Yes) | ? | ? | ? | ? |
[1] Starting in Gecko 6.0 (Firefox 6.0 / Thunderbird 6.0 / SeaMonkey 2.3), this property is read only, as defined by the standard.
Document Tags and Contributors
Tags:
Contributors to this page:
erikadoyle,
cvrebert,
Sebastianz,
fscholz,
trevorh,
teoli,
kscarfone,
iamanupmenon,
Sheppy,
Mgjbot,
Nickolay,
Jabez,
Dria,
JesseW
Last updated by:
erikadoyle,