tau-callbacks

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