Note: This feature is available in . Web Workers This feature is available only in (HTTPS), in some or all . Secure context secure contexts supporting browsers The Notifications API allows web pages to control the display of system notifications to the end user. These are outside the top-level browsing context viewport, so therefore can be displayed even when the user has switched tabs or moved to a different app. The API is designed to be compatible with existing notification systems, across different platforms. Concepts and usage On supported platforms, showing a system notification generally involves two things. First, the user needs to grant the current origin permission to display system notifications, which is generally done when the app or site initialises, using the method. This should be done in response to a user gesture, such as clicking a button, for example: Notification.requestPermission() btn.addEventListener( , { promise = Notification.requestPermission(); }) 'click' ( ) function let // wait for permission This is not only best practice — you should not be spamming users with notifications they didn't agree to — but going forward browsers will explicitly disallow notifications not triggered in response to a user gesture. Firefox is already doing this from version 72, for example. This will spawn a request dialog, along the following lines: From here the user can choose to allow notifications from this origin, or block them. Once a choice has been made, the setting will generally persist for the current session. : As of Firefox 44, the permissions for Notifications and have been merged. If permission is granted for notifications, push will also be enabled. Note Push Next, a new notification is created using the constructor. This must be passed a title argument, and can optionally be passed an options object to specify options, such as text direction, body text, icon to display, notification sound to play, and more. Notification() In addition, the Notifications API spec specifies a number of additions to the , to allow service workers to fire notifications. ServiceWorker API : To find out more about using notifications in your own app, read . Note Using the Notifications API Notifications interfaces Notification Defines a notification object. Service worker additions ServiceWorkerRegistration Includes the and method, for controlling the display of notifications. ServiceWorkerRegistration.showNotification() ServiceWorkerRegistration.getNotifications() ServiceWorkerGlobalScope Includes the handler, for firing custom functions when a notification is clicked. ServiceWorkerGlobalScope.onnotificationclick NotificationEvent A specific type of event object, based on , which represents a notification that has fired. ExtendableEvent Specifications Browser compatibility See also Using the Notifications API Credits Source: https://developer.mozilla.org/en-US/docs/Web/API/Notifications_API Published under licence Open CC Attribution ShareAlike 3.0

Mozilla

Read My Stories

Too Long; Didn't Read

In your car, at home, or at work — Bosch technology shapes many areas of life.

Introduction to the Web Notifications API Standard

Too Long; Didn't Read

Company Mentioned

Mozilla Contributors

About Author

TOPICS

THIS ARTICLE WAS FEATURED IN...

Introduction to the Web Notifications API Standard

Too Long; Didn't Read

Company Mentioned

Mozilla Contributors

About Author

TOPICS

THIS ARTICLE WAS FEATURED IN...

RELATED STORIES