source: trip-planner-front/node_modules/events/Readme.md@ b738035

Last change on this file since b738035 was 6a3a178, checked in by Ema <ema_spirova@…>, 3 years ago

initial commit

  • Property mode set to 100644
File size: 2.3 KB
Line 
1# events [![Build Status](https://travis-ci.org/Gozala/events.png?branch=master)](https://travis-ci.org/Gozala/events)
2
3> Node's event emitter for all engines.
4
5This implements the Node.js [`events`][node.js docs] module for environments that do not have it, like browsers.
6
7> `events` currently matches the **Node.js 11.13.0** API.
8
9Note that the `events` module uses ES5 features. If you need to support very old browsers like IE8, use a shim like [`es5-shim`](https://www.npmjs.com/package/es5-shim). You need both the shim and the sham versions of `es5-shim`.
10
11This module is maintained, but only by very few people. If you'd like to help, let us know in the [Maintainer Needed](https://github.com/Gozala/events/issues/43) issue!
12
13## Install
14
15You 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](https://github.com/browserify/browserify) or [webpack](https://github.com/webpack/webpack) also include the `events` module.
16
17But if none of those apply, with npm do:
18
19```
20npm install events
21```
22
23## Usage
24
25```javascript
26var EventEmitter = require('events')
27
28var ee = new EventEmitter()
29ee.on('message', function (text) {
30 console.log(text)
31})
32ee.emit('message', 'hello world')
33```
34
35## API
36
37See the [Node.js EventEmitter docs][node.js docs]. `events` currently matches the Node.js 11.13.0 API.
38
39## Contributing
40
41PRs 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.
42This 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](https://github.com/nodejs/node) and will be added to this module once they are implemented in Node.js.
43
44If there is a difference in behaviour between Node.js's `events` module and this module, please open an issue!
45
46## License
47
48[MIT](./LICENSE)
49
50[node.js docs]: https://nodejs.org/dist/v11.13.0/docs/api/events.html
Note: See TracBrowser for help on using the repository browser.