Learn more about Russian war crimes in Ukraine.

What is the web Notification API?

The web Notification API lets web apps on your browser display system-level notifications, outside of any webpage viewport. The Notification API can be demonstrated in one LOC:

Notification.requestPermission(perm => new Notification('HEY!!'));

Click this button to see what it does:

The Notification API has two important pieces. The first is Notification.requestPermission(...), which prompts the user (you) to allow this website to display notifications. It accepts a callback, which will be called once the user has made a decision. The callback is passed a string, either "granted" or "denied". The above example assumes it was granted. This status is also available as Notification.permission, which is "default" if the user has not said either way.

The second piece of the Notification API is new Notification(...). This displays a notification, if Notification.permission == "granted".

The permission is per-origin, and persistent. Here, the origin is https://jameshfisher.com:443. This means any other webpage on this origin you notifications, and any “shared workers” for this origin can send you notifications.

Yes, the example above was just to trick you into accepting notifications from me! If you want to change your settings, this varies per browser. Try here if you’re using Chrome.

The Notification API is different from the Push API. The Push API allows remote servers to send data to your local browser. Together, these two APIs enable “web push notifications”. I’ll cover the Push API in future.

What can computers do? What are the limits of mathematics? And just how busy can a busy beaver be? This year, I’m writing Busy Beavers, a unique interactive book on computability theory. You and I will take a practical and modern approach to answering these questions — or at least learning why some questions are unanswerable!

It’s only $19, and you can get 50% off if you find the discount code ... Not quite. Hackers use the console!

After months of secret toil, I and Andrew Carr released Everyday Data Science, a unique interactive online course! You’ll make the perfect glass of lemonade using Thompson sampling. You’ll lose weight with differential equations. And you might just qualify for the Olympics with a bit of statistics!

It’s $29, but you can get 50% off if you find the discount code ... Not quite. Hackers use the console!

More by Jim

Tagged . All content copyright James Fisher 2017. This post is not associated with my employer. Found an error? Edit this page.