Types
FDC3 API operations make use of several type declarations.
Context
interface Context {
id?: { [key: string]: string };
name?: string;
type: string;
}
The base interface that all contexts should extend: a context data object adhering to the Context Data Specification.
This means that it must at least have a type property that indicates what type of data it represents, e.g. 'fdc3.contact'. The type property of context objects is important for certain FDC3 operations, like Channel.getCurrentContext and DesktopAgent.addContextListener, which allows you to filter contexts by their type.
See also
ContextHandlerDesktopAgent.openDesktopAgent.broadcastDesktopAgent.addIntentListenerDesktopAgent.addContextListenerDesktopAgent.findIntentDesktopAgent.findIntentsByContextDesktopAgent.raiseIntentDesktopAgent.raiseIntentForContextChannel.broadcastChannel.getCurrentContextChannel.addContextListener
ContextHandler
type ContextHandler = (context: Context) => void;
Describes a callback that handles a context event.
Used when attaching listeners for context broadcasts and raised intents.
See also
Listener
A Listener object is returned when an application subscribes to intents or context broadcasts via the addIntentListener or addContextListener methods on the DesktopAgent object.
interface Listener {
unsubscribe(): void;
}
unsubscribe
unsubscribe(): void;
Allows an application to unsubscribe from listening to intents or context broadcasts.
See also
DesktopAgent.addIntentListenerDesktopAgent.addContextListenerChannel.addContextListenerContextHandler
TargetApp
type TargetApp = string | AppMetadata;
Operations that target apps (like open or raiseIntent) can identify an app just by by its name,
or pass full app metadata, giving the desktop agent more information about the targeted app.