@peter.naydenov/notice 1.0.2 → 1.1.0

package/README.md

@@ -38,6 +38,7 @@ eBus.emit ( 'note' )
     , emit  : 'Trigger a event'
     , stop  : 'Ignore event for a while'
     , start : 'Remove event from ignore list'
+    , debug : 'Returns a console message on each triggered event'
 }
 ```
 
@@ -64,7 +65,7 @@ Register a single event.
 ```js
 const eBus = notice ();
 
-eBus.once ( 'start', name => console.log ( `Hey, ${name}!` )   )   // notice that data params from emit is coming as array
+eBus.once ( 'start', name => console.log ( `Hey, ${name}!` )   )
 eBus.emit ( 'start', 'Johny' )
 // ---> Hey, Johny!
 eBus.emit ( 'start', 'Vessy' )
@@ -171,8 +172,28 @@ const
 ```
 
 
+### Notice.debug ( state, label )
+Provide debug message on each event. By default is debug is 'off'.
+
+```js
+// Turn debug "on"
+eBus.debug ( true )
+
+// Turn debug "off"
+eBus.debug ( false )
+
+// Activate debugger and set a debug message prefix
+eBus.debug ( true, '[eBus]:' )
+eBus.emit ( 'dummy' )
+// --> [eBus]: Event "dummy" was triggered.
+```
+
+
 ## Release History
 
+### 1.1.0 ( 2022-10-21)
+- [x] Method 'debug' was added;
+
 ### 1.0.1 ( 2022-08-15)
 - [x] Fix: Event data is coming in Array;
 - [x] Fix: Multiple instances of notice;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@peter.naydenov/notice",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "description": "Event emmiter - NOTICE",
   "main": "src/main.js",
   "scripts": {

package/src/main.js

@@ -5,6 +5,8 @@ function notice () {
                           scroll     = {}  // General events with their subscribers
                         , scrollOnce = {}  // Single events with their subscribers
                         , ignore     = []  // Ignore event names ( general and single )
+                        , debugFlag  = false 
+                        , debugHeader = ''
                         ;
                     function on ( e, fn ) {
                             if ( !scroll[e] ) scroll[e] = []
@@ -15,7 +17,7 @@ function notice () {
                             scrollOnce[e].push ( fn )
                         } // once func.
                     function off ( e, fx ) {
-                            if ( fx ) {   // fx is optional
+                            if ( fx ) {   // fx is optional
                                     if ( scroll[e]     )  scroll[e]     = scroll[e].filter     ( fn => fn !== fx )
                                     if ( scrollOnce[e] )  scrollOnce[e] = scrollOnce[e].filter ( fn => fn !== fx )
                                     if ( scroll[e] && scroll[e].length         === 0 )   delete scroll[e]
@@ -25,8 +27,21 @@ function notice () {
                             if ( scrollOnce[e] )   delete scrollOnce[e]
                             if ( scroll[e]     )   delete scroll[e]
                         } // off func.
+                    function debug ( val, header ) {
+                            debugFlag =  val ? true : false
+                            if ( header && (typeof header === 'string') )   debugHeader = header
+                        } // debug func.
                     function emit () {
                             const [ e, ...args ] = arguments
+                            if ( debugFlag ) {  
+                                        console.log ( `${debugHeader} Event "${e}" was triggered.`)
+                                        if ( args.length > 0 ) {
+                                            console.log ( 'Arguments:')
+                                            console.log ( ...args )
+                                            console.log ( '^----' )
+                                        }
+                                        
+                                }
                             if ( e == '*' ) {   // The wildcard '*' doesn't work for 'once' events
                                     let evNames = Object.keys ( scroll )
                                     evNames.forEach ( name => {
@@ -70,6 +85,7 @@ function notice () {
                                 , emit  // Trigger a event
                                 , stop  // Ignore event for a while
                                 , start // Remove event from ignore list
+                                , debug
                         }
         } // notice fn.
     return new Notice ()