Socket
Socket
Sign inDemoInstall

events

Package Overview
Dependencies
0
Maintainers
3
Versions
17
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

    events

Node's event emitter for all engines.


Version published
Weekly downloads
35M
decreased by-0.98%
Maintainers
3
Install size
81.7 kB
Created
Weekly downloads
 

Package description

What is events?

The 'events' npm package provides a way to implement the Observer pattern, which is a software design pattern that allows an object (known as a 'subject') to maintain a list of its dependents (known as 'observers') and automatically notify them of any state changes, usually by calling one of their methods. It is the same EventEmitters API as used by Node.js core.

What are events's main functionalities?

EventEmitter creation

This code sample shows how to import the 'events' package and create a new instance of an EventEmitter.

const EventEmitter = require('events');
const myEmitter = new EventEmitter();

Event listening

This code sample demonstrates how to listen for an 'event' and execute a callback function when the event is emitted.

myEmitter.on('event', () => {
  console.log('an event occurred!');
});

Event emitting

This code sample shows how to emit an 'event', which will trigger any associated event listeners.

myEmitter.emit('event');

Once listener

This code sample demonstrates how to set up a listener that will only be called once for the next time the event is emitted.

myEmitter.once('event', () => {
  console.log('this event will be logged only once');
});

Removing listeners

This code sample shows how to remove a specific listener from an event.

const callback = () => console.log('event occurred');
myEmitter.on('event', callback);
// ...
myEmitter.removeListener('event', callback);

Other packages similar to events

Readme

Source

events Build Status

Node's event emitter for all engines.

This implements the Node.js events module for environments that do not have it, like browsers.

events currently matches the Node.js 11.13.0 API.

Note that the events module uses ES5 features. If you need to support very old browsers like IE8, use a shim like es5-shim. You need both the shim and the sham versions of es5-shim.

This module is maintained, but only by very few people. If you'd like to help, let us know in the Maintainer Needed issue!

Install

You usually do not have to install events yourself! If your code runs in Node.js, events is built in. If your code runs in the browser, bundlers like browserify or webpack also include the events module.

But if none of those apply, with npm do:

npm install events

Usage

var EventEmitter = require('events')

var ee = new EventEmitter()
ee.on('message', function (text) {
  console.log(text)
})
ee.emit('message', 'hello world')

API

See the Node.js EventEmitter docs. events currently matches the Node.js 11.13.0 API.

Contributing

PRs are very welcome! The main way to contribute to events is by porting features, bugfixes and tests from Node.js. Ideally, code contributions to this module are copy-pasted from Node.js and transpiled to ES5, rather than reimplemented from scratch. Matching the Node.js code as closely as possible makes maintenance simpler when new changes land in Node.js. This module intends to provide exactly the same API as Node.js, so features that are not available in the core events module will not be accepted. Feature requests should instead be directed at nodejs/node and will be added to this module once they are implemented in Node.js.

If there is a difference in behaviour between Node.js's events module and this module, please open an issue!

License

MIT

Keywords

FAQs

Last updated on 27 Feb 2021

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc