Git Product home page Git Product logo

event-emitter's Introduction

What is this?

This is a function which returns a simple EventEmitter.
It is a simpler implementation of the EventEmitter class from NodeJS.
It is not meant to be a replacement for the NodeJS EventEmitter, but rather a simple alternative for those who don't want to use the NodeJS EventEmitter.
It is also a good way to learn how Event Emitting works as a concept.

How do I install it?

You can install it by using the following command:

npm install @cadienvan/event-emitter

How to use it?

Simply import the module and start using it as follows:

import { makeEE } from '@cadienvan/event-emitter';
const myObject = Object.assign({}, makeEE());
function listener(data) {
  console.log(data);
}
myObject.$on('event', listener);
myObject.$emit('event', {});

Why did I choose to call it makeEE?

I chose to call it makeEE because it is a function which returns an EventEmitter and I didn't want it to conflict with the NodeJS EventEmitter, allowing you to use both in the same project depending on the use case.

How does this work?

The makeEE function returns an object with the following properties:


$on

The $on function takes two arguments: the event name and the listener function.

myObject.$on('event', listener);

$off

The $off function takes two arguments: the event name and the listener function.

myObject.$off('event', listener);

$emit

The $emit function takes two arguments: the event name and the data to be passed to the listener function.

myObject.$emit('event', data);

$once

The $once function takes two arguments: the event name and the listener function.

myObject.$once('event', listener);

Tests

You can run the tests by using the following command:

npm test

Scaffolding

This project was generated using Cadienvan's own npm-package-ts-scaffolding so it has all the necessary tools to develop, test and publish a TypeScript package importable both via CommonJS and ES Modules.

event-emitter's People

Contributors

cadienvan avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.