added support to disable automatic permission request

Author: sagiegurari

README.md

@@ -64,10 +64,11 @@ bower install angular-web-notification --save
 ## Limitations
 The web notifications API is not fully supported in all browsers.
 
-Please see [HTML5-Desktop-Notifications](https://github.com/ttsvetko/HTML5-Desktop-Notifications) for more information.
+Please see http://caniuse.com/#feat=notifications for more information on the official spec support and at [HTML5-Desktop-Notifications](https://github.com/ttsvetko/HTML5-Desktop-Notifications) for more browser specific API support.
 
 ## Release History
 
+ * 2014-12-09   v0.0.3   API now enables/disables the capability to automatically request for permissions needed to display the notification.
  * 2014-12-08   v0.0.2   Initial release.
 
 ## License

angular-web-notification.js

@@ -1,4 +1,5 @@
 /*global notify: false, angular: false */
+
 (function (notifyLib) {
     'use strict';
 
@@ -39,7 +40,14 @@
             };
         };
 
-        return {
+        var service = {
+            /**
+             * True to enable automatic requesting of permissions if needed.
+             *
+             * @memberof! webNotification
+             * @public
+             */
+            allowRequest: true,//true to enable automatic requesting of permissions if needed
             /**
              * Shows the notification based on the provided input.<br>
              * The callback invoked will get an error object (in case of an error, null in
@@ -48,8 +56,8 @@
              * @function
              * @memberof! webNotification
              * @public
-             * @param {string} title - The notification title text
-             * @param {object} options - Holds the notification data (see https://github.com/ttsvetko/HTML5-Desktop-Notifications.git for more info)
+             * @param {string} [title] - The notification title text (defaulted to empty string if null is provided)
+             * @param {object} [options] - Holds the notification data (web notification API spec for more info)
              * @param {function} callback - Called after the show is handled.
              * @example
              * webNotification.showNotification('Example Notification', {
@@ -65,22 +73,50 @@
              *  }
              * });
              */
-            showNotification: function (title, options, callback) {
-                var hideNotification = null;
-                if (isEnabled()) {
-                    hideNotification = createAndDisplayNotification(title, options);
-                    callback(null, hideNotification);
-                } else {
-                    notifyLib.requestPermission(function onRequestDone() {
-                        if (isEnabled()) {
-                            hideNotification = createAndDisplayNotification(title, options);
-                            callback(null, hideNotification);
+            showNotification: function () {
+                //convert to array to enable modifications
+                var argumentsArray = Array.prototype.slice.call(arguments, 0);
+
+                if ((argumentsArray.length >= 1) && (argumentsArray.length <= 3)) {
+                    //callback is always the last argument
+                    var callback = argumentsArray.pop();
+
+                    var title = null;
+                    var options = null;
+                    if (argumentsArray.length === 2) {
+                        title = argumentsArray[0];
+                        options = argumentsArray[1];
+                    } else if (argumentsArray.length === 1) {
+                        var value = argumentsArray.pop();
+                        if (typeof value === 'string') {
+                            title = value || '';
+                            options = {};
                         } else {
-                            callback(new Error('Notification is not enabled.'), null);
+                            title = '';
+                            options = value;
                         }
-                    });
+                    }
+
+                    var hideNotification = null;
+                    if (isEnabled()) {
+                        hideNotification = createAndDisplayNotification(title, options);
+                        callback(null, hideNotification);
+                    } else if (service.allowRequest) {
+                        notifyLib.requestPermission(function onRequestDone() {
+                            if (isEnabled()) {
+                                hideNotification = createAndDisplayNotification(title, options);
+                                callback(null, hideNotification);
+                            } else {
+                                callback(new Error('Notifications are not enabled.'), null);
+                            }
+                        });
+                    } else {
+                        callback(new Error('Notifications are not enabled.'), null);
+                    }
                 }
             }
         };
+
+        return service;
     });
 }(notify));

bower.json

@@ -1,6 +1,6 @@
 {
   "name": "angular-web-notification",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "authors": [
     "Sagie Gur-Ari <[email protected]>"
   ],