Window: close() method

Baseline Widely available

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

The Window.close() method closes the current window, or the window on which it was called.

This method can only be successfully called on windows that are considered script-closable. This generally includes:

  • Windows opened using Window.open()
  • Windows opened via web content, such as links (<a target="_blank">) or forms (<form target="_blank">), without user modifier actions

Windows opened by browser UI actions — such as right-click → Open in new tab, Ctrl+Click, Shift+Click, or middle-click — are not script-closable. Calling close() on such windows will result in an error message like: Scripts may not close windows that were not opened by script.

Note also that close() has no effect when called on Window objects returned by HTMLIFrameElement.contentWindow.

Syntax

js
close()

Parameters

None.

Return value

None (undefined).

Examples

Closing a window opened with window.open()

This example shows a method which opens a window and a second one which closes the window; this demonstrates how to use Window.close() to close a window opened by calling window.open().

js
// Global variable to store a reference to the opened window
let openedWindow;

function openWindow() {
  openedWindow = window.open("more-info.htm");
}

function closeOpenedWindow() {
  openedWindow.close();
}

Specifications

Specification
HTML
# dom-window-close-dev