JavaScript Window close() Method

What You’ll Learn

The close() method shuts a browser window. This tutorial covers syntax, which windows can actually be closed, pairing with open(), five examples, and browser security rules beginners must know.

Introduction

Sometimes a web app opens a helper window—a login popup, a print preview, or a small tool panel. When the job finishes, JavaScript should shut that window cleanly. The window.close() method requests exactly that.

Important caveat: browsers protect users from scripts that try to close tabs they opened themselves. close() works best on windows your code created with window.open(), especially when triggered by a user action like a button click.

Understanding the close() Method

window.close() takes no arguments and returns undefined. Called on the global window, it targets the current browsing context. Called on a reference returned from window.open(), it targets that popup instead: popupWindow.close().

After closing, the reference’s closed property becomes true. Always check before reusing a popup object—calling methods on a closed window throws errors in some browsers.

📝 Syntax

General form of Window.close():

window.close();
// close a popup reference:
popupWindow.close();

Parameters

• None.

Return value

• undefined.

Related APIs

• window.open() — create a window your script may close later.
• window.opener — inside a popup, reference the page that opened it.
• popupWindow.closed — boolean indicating whether the popup is gone.

Examples Gallery

Use the Try-it links to open small popups and close them. Popups opened by your script are the reliable way to see close() in action.

document.getElementById("closeBtn").addEventListener("click", function () {
  window.close();
  console.log("close() called — may be blocked on main tabs.");
});

close() called — may be blocked on main tabs.

let popupWindow = null;

document.getElementById("openBtn").onclick = function () {
  popupWindow = window.open("", "DemoPopup", "width=320,height=200");
  popupWindow.document.write("<p>Hello from the popup!</p>");
};

document.getElementById("closePopupBtn").onclick = function () {
  if (popupWindow && !popupWindow.closed) {
    popupWindow.close();
    console.log("Popup closed from opener.");
  }
};

Popup closed from opener.

<!-- Content written into a popup -->
<p>Thanks! You may close this window.</p>
<button type="button" onclick="window.close()">Close</button>

Click Close inside the popup → popup window disappears.

const popup = window.open("", "AutoClose", "width=300,height=160");
popup.document.write("<p>Closing in 3 seconds…</p>");

setTimeout(function () {
  popup.close();
  console.log("Popup auto-closed.");
}, 3000);

Popup auto-closed.

let popup = window.open("", "CheckClosed", "width=280,height=140");

function showStatus() {
  if (!popup || popup.closed) {
    console.log("Popup is closed.");
    return;
  }
  console.log("Popup is still open.");
}

popup.close();
showStatus();  // "Popup is closed."

Popup is closed.

🚀 Common Use Cases

• OAuth / login popups — close after redirect back with a token.
• Print preview windows — shut helper window after printing.
• Wizard steps — child window closes when flow completes.
• Payment confirmation — popup closes itself on success.
• Multi-window tools — opener closes outdated popups before opening new ones.
• Cleanup on logout — close auxiliary windows the app opened.

📝 Notes

• Pop-up blockers may prevent open(); without a popup there is nothing to close().
• Cross-origin popups limit what the opener can read— but same-origin close() still works.
• Do not use close() as a substitute for hiding modal UI—prefer in-page dialogs for main tabs.
• Mobile browsers may treat popups as new tabs with different close behavior.
• Closing a window stops its timers and scripts immediately.
• Modern apps often use iframe modals instead of popups to avoid blocker issues.

💡 Best Practices