Web/API/Notification/close

Note: This feature is available in Web Workers.

Secure contextThis feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

The close() method of the Notification interface is used to close/remove a previously displayed notification.

Note: This API shouldn't be used just to have the notification removed from the screen after a fixed delay since this method will also remove the notification from any notification tray, preventing users from interacting with it after it was initially shown. A valid use for this API would be to remove a notification that is no longer relevant (e.g. the user already read the notification on the webpage in the case of a messaging app or the following song is already playing in a music app).

Syntax

Notification.close();

Parameters

None.

Returns

Void.

Examples

In the following snippet, we have a simple function that when called creates an options object and then a new notification. At the end of the function, it also calls close() inside a addEventListener() function to remove the notification when the relevant content has been read on the webpage.

function spawnNotification(theBody, theIcon, theTitle) {
  var options = {
    body: theBody,
    icon: theIcon
  };

  var n = new Notification(theTitle,options);
  document.addEventListener('visibilitychange', function() {
    if (document.visibilityState === 'visible') {
      // The tab has become visible so clear the now-stale Notification.
      n.close();
    }
  });
}

Specifications

Specification	Status	Comment
Notifications API	Living Standard	Living standard

Browser compatibility

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`close`	Chrome Full support Yes	Edge Full support 14	Firefox Full support Yes	IE No support No	Opera Full support Yes	Safari Full support Yes	WebView Android No support No	Chrome Android Full support Yes	Firefox Android Full support Yes	Opera Android Full support Yes	Safari iOS No support No	Samsung Internet Android Full support Yes

Legend

Full support: Full support
No support: No support