jQuery jQuery.isWindow() Method

What You’ll Learn

The jQuery.isWindow() utility returns true when a value is a browser window object — the global page context or an iframe’s contentWindow. This tutorial covers syntax, five worked examples, comparisons with $.type(), the jQuery 3.3 deprecation, and the official one-line replacement.

Introduction

In browser JavaScript, the global window object is special. It represents the browsing context — the tab or iframe that holds your page. Many values are technically “objects,” but only a true window has the window self-reference property that jQuery checks.

jQuery provides jQuery.isWindow() (also written $.isWindow()) to answer one question: “Is this value a browser window?” jQuery uses that answer internally when working with documents, iframes, and cross-context DOM operations. In jQuery 3.3 the method was deprecated; in jQuery 4.0 it was removed — but legacy plugins still rely on it, so understanding the pattern matters.

Understanding the jQuery.isWindow() Method

jQuery.isWindow(obj) returns true when obj is a window object — typically the page’s global window or an iframe’s contentWindow.

It returns false for null, primitives, plain objects, arrays, DOM elements, and document. The check is narrow by design: only window objects pass.

📝 Syntax

General form of jQuery.isWindow:

jQuery.isWindow( obj )

// or

$.isWindow( obj )

Parameters

• obj — any JavaScript value to test.

Return value

• true if obj is a window object.
• false for all other values.

Official replacement (jQuery 3.3+)

function isWindow(obj) {

  return obj != null && obj === obj.window;

}



// Same result as $.isWindow(obj) in jQuery 3.x

console.log(isWindow(window)); // true

Examples Gallery

Each example uses $.isWindow() (jQuery 3.7.1). Open DevTools or use the Try-it links to run them interactively.

console.log($.isWindow(window)); // true



// window references itself — the key identity check

console.log(window === window.window); // true

true

true

console.log($.isWindow({}));            // false

console.log($.isWindow(document));       // false

console.log($.isWindow(document.body));  // false

console.log($.isWindow(null));           // false

false (×4)

var frame = document.createElement("iframe");

document.body.appendChild(frame);



var childWin = frame.contentWindow;

console.log($.isWindow(childWin));       // true

console.log(childWin === childWin.window); // true

true

true

function getDocumentRoot(context) {

  if ($.isWindow(context)) {

    return context.document;

  }

  if (context && context.nodeType === 9) {

    return context; // already a document

  }

  if (context && context.ownerDocument) {

    return context.ownerDocument;

  }

  return document;

}



console.log(getDocumentRoot(window) === document);     // true

console.log(getDocumentRoot(document.body) === document); // true

true

true

function isWindow(obj) {

  return obj != null && obj === obj.window;

}



console.log(isWindow(window));        // true

console.log(isWindow({}));            // false

console.log(isWindow(null));          // false



// Matches $.isWindow() in jQuery 3.x

console.log(isWindow(window) === $.isWindow(window)); // true

true

false

false

true

🚀 Common Use Cases

• Context resolution — distinguish window from element arguments.
• iframe plugins — detect contentWindow before DOM queries.
• Cross-frame utilities — verify you received a browsing context.
• Legacy plugin maintenance — read existing $.isWindow checks.
• Migration to jQuery 4 — swap in the obj === obj.window helper.
• Reject mistaken inputs — block plain objects passed as “context.”

📝 Notes

• Added in jQuery 1.4.3 — used internally across DOM and traversal code.
• Deprecated in jQuery 3.3 — removed in jQuery 4.0.
• Official replacement: obj != null && obj === obj.window.
• $.type(window) returns "object" — not specific enough for window detection.
• $.isPlainObject(window) returns false — window is never a plain map.
• Works for iframe contentWindow objects the same as the top-level page.

💡 Best Practices