DEV Community

Cover image for Notification API: Show notifications from your web app πŸ””

Notification API: Show notifications from your web app πŸ””

Mohd Shahid
Web Developer | ReactJS | Content Creator Code enthusiast. Always happy to help
・2 min read

Hey guys.

Notifications are vital if you want to drive traffic to your web applications.

Notifications can be shown even if the user is not active on your website/webapp.

Whether you are building an e-commerce website and want to show offers to your user or you are building a chatting application and want to show the notification about new messages.

Many top web applications like Slack, Facebook, WhatsApp and a lot more are using the same technology to show notifications.

Using Notifications API is lot more simpler than you might think.


The Notifications API allow developers to show notifications from their website or web application.

Notifications API is compatible with existing notifications system in your OS (Windows, Mac or Linux).

How to use Notifications API πŸ’­

Notifications can be initialised using the class Notification which is available globally.

Asking for permission ⬇️

// asking user to grant the permission on page load
// to show notifications
window.addEventListener('load', () => {
// permission cannot be asked again if the user chose
// to grant or deny the permission.
// once granted or denied, then user have to change the
// permission manually.
Enter fullscreen mode Exit fullscreen mode

Checking if the user has granted the permission ⬇️

Enter fullscreen mode Exit fullscreen mode

Result of the above console can be:

default: Permission is not asked yet, notifications will not be shown.

granted: User has granted the permission to show notifications.

denied: User has declined the permission.

Alternatively, you can also use Permission API to check for the permission. More about it here.

Showing notifications πŸ””

const newMsgNotification = new Notification('A new message', {
  body: 'You have got a new message, check it out!',
  icon: '',
Enter fullscreen mode Exit fullscreen mode

Above code shows the notification in my ubuntu something like this πŸ‘‡

And that is it, this is as much that you need to know to get started, continue to know more.

In the above example you see Notification class accepts 2 arguments.

  1. Title of the notification.
  2. Options object in which you can set settings for notifications.

Interacting with the notifications:

Users can also interact with the notification (like click on the notification).

EventListener can be added to notification instance.

// navigate the user to you website when
// user click on a notification
newMsgNotification.addEventListener('click', (e) => {
  e.preventDefault();'', '_blank');
Enter fullscreen mode Exit fullscreen mode

In addition to click listener, notification can listen to 3 more events:

close: Fired when the notification is closed.

error: Fired when the notification could not be shown for some reason.

show: Fired when the notification in displayed.

That is it for this article guys, I hope you found it useful.

If you did please leave a like and share the article.

This is the basics of the Notification API, I wanted this post to be short and simple.

If you want to know more about it, please leave a comment below.

Thank you for giving it a read. ❀️
Follow me on twitter

Discussion (11)

akchauhan2 profile image
Ajay Chauhan

But what if we want to send notification sometime after a user closes the page.

evanburg profile image
Evan Burgess

You would have to implement the Push API to send notifications when the web app is in the background or closed.

akchauhan2 profile image
Ajay Chauhan

Yeah, it will work!!

Sloan, the sloth mascot
Comment deleted
akchauhan2 profile image
Ajay Chauhan

Bro Service workers will work, but I wanted to hear anything other than Service worker.

tochimclaren profile image

Nice, will make sure to add this to my Web app.

sidmirza4 profile image
Mohd Shahid Author

Thanks buddy.
Reach me to twitter if you need any help.

tochimclaren profile image


schizox10 profile image
Azim Anuar

Hey Mohd Shahid. Thanks a lot for this. Im sorry just land on my bad just overlook for the real place for the startup in the learning the new tech. thanks to the community..namaste..:)

langfordquarshie21 profile image
Langford Kwabena

Perfect. Just what I needed✌

sidmirza4 profile image
Mohd Shahid Author

Glad you found it useful