Skip to main content

Signals

Host.Signals provides pub/sub messaging between scripts and observers.

Methods

MethodReturnsParametersDescription
Host.Signals.advise(channel, observer)channel — channel name string, observer — object with notify()Subscribe an observer to a signal channel
Host.Signals.unadvise(channel, observer)channel — channel name string, observer — previously subscribed objectUnsubscribe an observer from a signal channel
Host.Signals.signal(channel, eventName, payload)channel — channel name string, eventName — event identifier, payload — Attributes object or stringEmit a signal to subscribed observers
Host.Signals.flush()noneFlush pending host signals
Host.Signals.postMessage(subject, delay, eventName)subject — target object, delay — delay in ms, eventName — event identifierPosts a message to the subject

Observer Callback

Subscribers must implement Host.Interfaces.IObserver with a notify(subject, msg) method:

this.interfaces = [Host.Interfaces.IObserver];

this.notify = function(subject, msg) {
if (msg.id === "someEvent") {
var payload = msg.getArg(0);
}
};

See Interfaces - IObserver for full IObserver surface.