A handy wrapper for using the Web Notifications API. Notify.js aims to simplify requesting user permission and associated Web Notification API events, as well as providing a few extra callbacks and convenience methods.

• Download: zip
• Bower: bower install notify.js
• Git: git clone https://github.com/alexgibson/notify.js

This component can be used as an AMD module, or a global.

To initialize a web notification create a new Notify instance, passing the message title as well as any other options you wish to use.

var myNotification = new Notify('Yo dawg!', {
	body: 'This is an awesome notification',
	notifyShow: onNotifyShow
});

function onNotifyShow() {
	console.log('notification was shown!');
}

Then show the notification.

myNotification.show();

• title (string) - notification title

• body: (string) - notification message body
• icon: (string) - path for icon to display in notification
• tag: (string) - unique identifier to stop duplicate notifications
• notifyShow: (function) - callback when notification is shown
• notifyClose: (function) - callback when notification is closed
• notifyClick: (function) - callback when notification is clicked
• notifyError: (function) - callback when notification throws an error
• permissionGranted: (function) - callback when user has granted permission
• permissionDenied: (function) - callback when user has denied permission

• needsPermission() - (returns boolean) check is permission is needed for the user to receive notifications.
• requestPermission() - requests permission from the user if needed and handles permission callbacks.
• isSupported() - (returns boolean) test for Web Notifications API browser support

Unlike other browsers that implement the Web Notification API, Chrome does not permit requesting permission on page load (it must be as a result of user interaction, such as a click event). You can find out more in the Chromium bug for this issue.

Install Node. Testing relies on the Karma test-runner, which can be installed globally using the following command.

npm install -g karma

In the project root, to perform a single pass of the tests using Firefox run:

npm test

• Chrome (desktop)
• Safari
• Firefox
• Firefox OS (v1.2+)
• Firefox Mobile (Android)