• About the JavaScript API
  • AP
  • Cookie
  • Dialog
  • Events
  • History
  • Inline dialog
  • Flag
  • Messages (DEPRECATED)
  • Proxy request
  • Request

Events

The Events module provides a mechanism for emitting and receiving events.

Basic example

1
2
3
4
5
6
7
//The following will create an alert message every time the event `customEvent` is triggered.
AP.require('events', function(events){
  events.on('customEvent', function(){
      alert('event fired');
  });
  events.emit('customEvent');
});

Methods

emit (name, args)

Emits an event on this bus, firing listeners by name as well as all any listeners. Arguments following the name parameter are captured and passed to listeners.

Parameters

Name Type Description
name String The name of event to emit
args Array.<String> 0 or more additional data arguments to deliver with the event

off (name, listener)

Removes a particular listener for an event.

Parameters

Name Type Description
name String The event name to unsubscribe the listener from
listener function The listener callback to unsubscribe from the event name

offAll name

Removes all listeners from an event name, or unsubscribes all event-name-specific listeners if no name if given.

Parameters

Name Type Argument Description
name String <optional> The event name to unsubscribe all listeners from

offAny (listener)

Removes an any event listener.

Parameters

Name Type Description
listener function A listener callback to unsubscribe from any event name

on (name, listener)

Adds a listener for all occurrences of an event of a particular name. Listener arguments include any arguments passed to events.emit, followed by an object describing the complete event information.

Parameters

Name Type Description
name String

The event name to subscribe the listener to

listener function A listener callback to subscribe to the event name

onAny (listener)

Adds a listener for all occurrences of any event, regardless of name. Listener arguments begin with the event name, followed by any arguments passed to events.emit, followed by an object describing the complete event information.

Parameters

Name Type Description
listener function A listener callback to subscribe for any event name

once (name, listener)

Adds a listener for one occurrence of an event of a particular name. Listener arguments include any argument passed to events.emit, followed by an object describing the complete event information.

Parameters

Name Type Description
name String The event name to subscribe the listener to
listener function A listener callback to subscribe to the event name
  • System status
  • Privacy
  • Developer Terms
  • Trademark
  • Cookie Preferences
  • © 2019 Atlassian