Notification.close()

Note: This feature is available in Web Workers.

Secure context

This 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

BCD tables only load in the browser

See also