Tau-callbacks NPM

tauCallbacks

A multi-purpose callbacks list object that provides a powerful way to manage callback lists. API is very close to jQuery's $.Callbacks to allow easy migration and adoption.

Quick API reference

callbacks.add(handler, [scope]), callbacks.on(handler, [scope])
Add a callback to a callback list, and optionally set its execution context to scope. The same callback function could be added multiple times with different scopes to allow adding the same class method with different class instances.
callbacks.one(handler, [scope]), callbacks.once(handler, [scope])
Add an one-time callback to a callback list. Callback will be removed from list after first fire().
callbacks.fire(args), callbacks.trigger(args)
Call all of the callbacks with the given arguments.
callbacks.remove(handler, [scope]), callbacks.off(handler, [scope])
Remove specified callback with the given scope from a list.
callbacks.remove(scope), callbacks.off(scope)
Remove all of the callbacks with the given scope from a list.
callbacks.removeAll(), callbacks.empty()
Remove all of the callbacks from a list.
callbacks.buffer(f, scope)
Perform operation f which calls fire() multiple times, and then call fire() only once. Sort of debounce.

Differences from jQuery's Callbacks

Method	Diff	jQuery Callbacks	tauCallbacks
`add`	!==	Add a callback or a collection of callbacks to a callback list	Add only one callback, optionally with the given context
`disable`	!==	Disable a callback list from doing anything more	-
`disabled`	!==	Determine if the callbacks list has been disabled	-
`empty`	===	Remove all of the callbacks	Remove all of the callbacks
`fire`	===	Call all of the callbacks with the given arguments	Call all of the callbacks with the given arguments
`fired`	!==	Determine if the callbacks have already been called at least once	-
`fireWith`	!==	Call all callbacks in a list with the given context and arguments	-
`has`	!==	Determine whether or not the list has any callbacks attached	-
`lock`	!==	Lock a callback list in its current state	-
`locked`	!==	Determine if the callbacks list has been locked	-
`remove`	!==	Remove a callback or a collection of callbacks from a callback list	Remove a callback or a collection of callbacks with the same scope from a callback list
`on`	!==	-	Synonym to `add`
`one`, `once`	!==	-	Add an one-time callback to a callback list
`off`	!==	-	Synonym to `remove`
`trigger`	!==	-	Synonym to `fire`
`removeAll`	!==	-	Synonym to `empty`
`buffer`	!==	-	Debounce `fire` while performing some operation

emitter callbacks

underscore

@infinitebrahmanuniverse/nolb-tau @everything-registry/sub-chunk-2880

0.2.0

2 years ago

0.1.1

9 years ago

0.1.0

11 years ago