\n\n## Install\n\n### Module\n\n#### Download\n\n```bash\nnpm i radarjs\n```\n\n#### Import\n\n```js\nimport { Radar } from '@dannyfranca/radarjs'\n\nconst radar = new Radar()\n```\n\n### CDN\n\n```html\n\n\n\n\n```\n\n## Usage\n\n### Listen for Events\n\n```js\nconst state = {\n count: 0,\n lastNotificationType: ''\n}\n\nradar.on('notify', () => state.count++)\n\n// receive any number off values as arguments\nradar.on('notify', ({ type }, ...data) => {\n state.lastNotificationType = type)\n console.log(data)\n}\n\n// can use namespaces\nradar.on('notify.namespace1.namespace2', (...data) => {/*...*/})\n```\n\n### Unsubscribe from Events\n\n```js\n// by event name\nradar.off('notify')\n\n// by namespace\nradar.off('.namespace1')\n\n// by Subscription\nconst subscribeThenUnsubscribe = async () => {\n const subscription = await radar.on('event', (...data) => {/*...*/})\n subscription.unsubscribe()\n}\n\nsubscribeThenUnsubscribe()\n\n// by Subscription (sync)\nconst subscription = await radar.onSync('event', (...data) => {/*...*/})\nsubscription.unsubscribe()\n```\n\n### Trigger Events\n\n```js\n// pass any data to an event trigger\nradar.trigger('notify', {\n type: 'info',\n message: 'Just an ordinary notification'\n})\n\n// pass any number of data\nradar.trigger('notify', notification, ...data)\n```\n\n### MultiLevel Events\n\n```js\n// set child event\nradar.link('grandparent', 'parent')\nradar.link('parent', 'child')\n\n// destroy link\nradar.unlink('parent', 'child')\n\n// broadcast events down to the whole tree just like trigger\n// will trigger grandparent, parent and child\nradar.broadcast('grandparent', ...data)\n\n// will trigger parent and child\nradar.broadcast('parent', ...data)\n\n// emit events up to the whole tree just like trigger\n// will trigger child, parent and grandparent\nradar.emit('child', ...data)\n\n// will trigger only grandparent\nradar.emit('grandparent', ...data)\n```\n\n### Sync Variants\n\nEvery public methods returns Promises, but each one has a sync variant, with same syntax.\n\n```js\nradar.on('event', ...data) // returns Promise\nradar.onSync('event', ...data) // returns Subscription\nradar.trigger('event', ...data) // returns Promise\nradar.triggerSync('event', ...data) // returns void\n// and so on...\n```\n\n### MultiTriggering\n\nTo trigger/emit/broadcast many events with same data, you can use arrays of strings or a single string with event names separated by dots. Each event name is resolved by a glob pattern (powered by [micromatch](https://github.com/micromatch/micromatch))!\n\n```js\n// will trigger \"foo\" and \"bar\", sending same datas\nradar.trigger('foo.bar', ...data)\n// same as\nradar.trigger(['foo', 'bar'], ...data)\n\n\n// with micromatch\nradar.on('foo', () => {/*...*/})\nradar.on('bar', () => {/*...*/})\nradar.on('baz', () => {/*...*/})\nradar.on('boom', () => {/*...*/})\n\n// will trigger \"bar\" and \"baz\"\nradar.trigger('ba*', ...data) \n// will trigger \"boom\"\nradar.trigger('b*m', ...data)\n\n// many micromatches allowed!\n// will trigger \"bar\", \"baz\" and \"boom\"\nradar.triggerMany('ba*.bo*', ...data)\nradar.triggerMany(['ba*', 'bo*'], ...data)\n```\n\nSee all glob possibilities in [micromatch](https://github.com/micromatch/micromatch)\n\n#### Auto Link\n\nYou can autolink with \":\" character\n\n```js\nradar.on('event:frag1:frag2', () => {/*...*/})\n\n// will fire \"event\", \"event:frag1\" and \"event:frag1:frag2\" events\nradar.broadcast('event', ...data)\n\n// will fire \"event:frag1\" and \"event\" events\nradar.emit('event:frag1', ...data)\n\n// ATTENTION: will fire just frag1.\n// frag1 and frag2 is not supposed to be events,\n// just words appended to eventNames\nradar.broadcast('frag1', ...data)\n```\n\n### Native Events\n\nNative events has reserved names starting with $. Until now, the only native event available is $error.\n\n#### $error event\n\n```typescript\n// listening to $error\nradar.on('$error', (error: Error) => {/*...*/})\n```\n\nRadarjs default error handler is:\n\n```typescript\n(error: Error) => { throw error }\n```\n\nYou can set yout own:\n\n```typescript\n// set your error handler\nradar.setErrorHandler((error: Error) => {/*...*/})\n```\n\n## License\n\n[MIT](./LICENSE)\n\nCopyright (c) Danny França \n","readmeFilename":"README.md"}
![](\"https://img.shields.io/npm/dt/@dannyfranca/radarjs.svg?style=flat-square&logo=npm\")
\n\n\n\n ![](\"https://img.shields.io/npm/v/@dannyfranca/radarjs/latest.svg?style=flat-square&logo=npm\")
\n\n\n\n ![](\"https://img.shields.io/travis/dannyfranca/radarjs?style=flat-square&logo=travis\")
\n\n\n\n ![](\"https://img.shields.io/codecov/c/github/dannyfranca/radarjs?style=flat-square&logo=codecov\")
\n\n\n\n ![](\"https://david-dm.org/dannyfranca/radarjs/status.svg?style=flat-square\")
\n\n\n