Window: self property

BaselineWidely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

TheWindow.self read-only property returns the window itself, as aWindowProxy. It can be used with dot notation on awindow object (that is,window.self) or standalone (self). The advantage of the standalone notation is that a similar notation exists for non-window contexts, such as inWeb Workers. By usingself, you can refer to the global scope in a way that will work not only in a window context (self will resolve towindow.self) but also in a worker context (self will then resolve toWorkerGlobalScope.self).

Value

AWindowProxy object.

Examples

Uses ofwindow.self like the following could just as well be replaced bywindow.

if (window.parent.frames[0] !== window.self) {  // this window is not the first frame in the list}

Furthermore, when executing in the active document of a browsing context,window is a reference to the current global object and thus all of the following are equivalent:

const w1 = window;const w2 = self;const w3 = window.window;const w4 = window.self;// w1, w2, w3, w4 all strictly equal, but only w2 will function in workers