1.1.4 • Published 10 years ago

web-notifications v1.1.4

Weekly downloads
2
License
-
Repository
github
Last release
10 years ago

web-notifications (QBNotification)

Overview

A wrapper for using the Web Notifications API.

See it in action in folder test

Browsers support see on caniuse

Install

Install the package via CDN

https://cdn.rawgit.com/QuickBlox/web-notifications/master/qbNotification.js

or as NPM package

npm i web-notifications --save-dev

or as Bower component

bower i web-notifications --save-dev

Usage

Module is written like Universal Module Definition, so use everywhere.

Before show a notification you need to get permission from a user by

QBNotification.requestPermission(function(state) {
    console.log('State is changed: ' + state);
});

Then you should create instance of QBNotification.

/**
 * @param {[string]} title [Title of notification. Required.]
 * @param {[type]} options [Additional options: standard params + timeout]
 */
var notify = new QBNotification(title, options);

Example options

var options = {
    body: 'Body of notification',
    tag: 'chatQB',
    icons: 'image/icons.png',
    timeout: 7,
    closeOnClick: true
}

Then you can show notification via

notify.show()

Also you have:

/**
 * [isSupported - check whether Notification API available in environment or not]
 * @return {Boolean} [flag]
 */
QBNotification.isSupported()
/**
 * [needsPermission - check whether a user provided his permission to show notifications or not]
 * @return {Boolean} [flag]
 */
QBNotification.needsPermission()

Contribution

For test we use JSHint, so do

npm install -g jshint
npm test

before push yours changes.

Helpful links

W3, whatwg group, MDN

License

BSD

1.1.4

10 years ago

1.0.3

10 years ago

1.0.2

10 years ago

1.0.1

10 years ago