Security News
tea.xyz Spam Plagues npm and RubyGems Package Registries
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
eventcollector
Advanced tools
Readme
Node/JavaScript library for collecting multiple events into a single one.
Sometimes one needs to wait for various events to be emitted before doing something else. There are many solutions for this subject but most of them require passing the event callbacks to that library/module. While this is good in certain cases it is not so nice when one wants to code events within a prototype method of a custom class in a OO fashion.
eventcollector provides a different approach in which the user just needs to invoke a library method within his callback definitions.
$ npm install eventcollector
$ bower install eventcollector
Take the browserified file at build/eventcollector.bundle.js
and include it in your HTML:
<script src='js/eventcollector.bundle.js'></script>
The browserified file exports the window.eventcollector
function.
// We expect 2 events.
var ec = require('eventcollector')(2);
ec.on('done', function(fired, total, data) {
console.log('event %d of %d emitted', fired, total);
console.log('event description:', data);
});
ec.on('alldone', function(total) {
console.log('all the required %d events have been emitted', total);
// Continue your work here.
});
// Event #1.
process.nextTick(function() {
// Notify the eventcollector.
ec.done('event #1');
});
// Event #2.
setTimeout(function() {
// Notify the eventcollector.
ec.done('event #2');
}, 1000);
produces:
event 1 of 2 emitted
event description: event #1
... (1 second) ...
event 2 of 2 emitted
event description: event #2
all the required 2 events have been emitted
<script src='js/eventcollector.bundle.js'></script>
<script>
var ec = window.eventcollector(2);
ec.on('alldone', function(total) {
// ...
});
</script>
eventcollector(total, timeout)
In Node:
var eventcollector = require('eventcollector');
var ec = eventcollector(total, timeout);
In the Browser:
var ec = window.eventcollector(total, timeout);
Returns an instance of EventCollector
.
{Number}
total: Number of events expected.{Number}
timeout (optional): Emit 'timeout' if the required events have not fired before this value (in ms).EventCollector
The main class. It is an EventEmitter.
done(data)
Tell the EventCollector
instance that an event has been emitted.
{Object}
data (optional): Custom data about the emitted event.destroy()
Destroy the EventCollector
instance. No more events will be emitted.
Emitted for each fired event (this is, after each call to done()
).
{Number}
fired: Number of fired events.{Number}
total: Total number of required events to fire.{Object}
data: The same custom data as provided in the done()
method.Emitted when all the required events have fired.
{Number}
total: Total number of required events to fire.Emitted if the given timeout expires before all the required events have fired.
{Number}
fired: Number of fired events.{Number}
total: Total number of required events to fire.IMPORTANT: New 'done' events after the timeout will still be emitted unless the user calls destroy()
.
grunt-contrib-nodeunit
).done()
is ignored once all the required events have been emitted.Copyright (c) 2014 Iñaki Baz Castillo Licensed under the MIT license.
FAQs
Node/JavaScript library for collecting multiple events into a single one.
The npm package eventcollector receives a total of 8 weekly downloads. As such, eventcollector popularity was classified as not popular.
We found that eventcollector demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
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.
Security News
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
Security News
As cyber threats become more autonomous, AI-powered defenses are crucial for businesses to stay ahead of attackers who can exploit software vulnerabilities at scale.
Security News
UnitedHealth Group disclosed that the ransomware attack on Change Healthcare compromised protected health information for millions in the U.S., with estimated costs to the company expected to reach $1 billion.