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.