Interface ActionService

The ActionService provides access to map-actions.Action instances.

An instance of this class can be referenced using the service name map-actions.ActionService. The service can be used in different workflows to trigger the same functionality.

The action service will emit events action-added and action-removed when a new action is registered or an existing action is unregistered. In both cases, an object {id: "action-id"} is passed to the event handler.

interface ActionService {
    getActionIds(): string[];
    hasAction(actionId: string): boolean;
    on<Name extends EventNames<ActionServiceEvents>>(
        eventName: Name,
        callback: EventCallback<ActionServiceEvents[Name]>,
    ): EventHandle;
    on(
        eventName: "*",
        callback: EventCallback<{ id: string } | { id: string }>,
    ): EventHandle;
    on(
        eventName: string | string[],
        callback: EventCallback<unknown>,
    ): EventHandle;
    trigger(
        actionIds: readonly string[],
        options?: ActionOptions,
    ): Promise<unknown>[];
}

Hierarchy (View Summary)

Methods

getActionIds hasAction on trigger

Methods

getActionIds

  • getActionIds(): string[]

  • Get currently available action ids.

    Returns string[]

hasAction

  • hasAction(actionId: string): boolean

  • Checks if an action with the given ID exists.

    Parameters

    • actionId: string

      ID of the action.

    Returns boolean

on

  • on<Name extends EventNames<ActionServiceEvents>>(
        eventName: Name,
        callback: EventCallback<ActionServiceEvents[Name]>,
    ): EventHandle

  • Register event listener for specific events.

    Type Parameters

    Parameters

    • eventName: Name

      name of the event

    • callback: EventCallback<ActionServiceEvents[Name]>

      the event handler callback will be invoked when the event has been emitted

    Returns EventHandle

    a handle to unregister from the event

  • on(
        eventName: "*",
        callback: EventCallback<{ id: string } | { id: string }>,
    ): EventHandle

  • Register event listener for any event.

    Parameters

    • eventName: "*"

      must be "*" for this overload

    • callback: EventCallback<{ id: string } | { id: string }>

      the event handler callback will be invoked when any event has been emitted

    Returns EventHandle

    a handle to unregister from the events

  • on(eventName: string | string[], callback: EventCallback<unknown>): EventHandle

  • Register event listener for the events listed in eventName. Comma separated event names are possible, for example "eventA,eventB".

    Parameters

    • eventName: string | string[]

      the event name or list of names

    • callback: EventCallback<unknown>

      the event handler callback

    Returns EventHandle

    a handle to unregister from the event(s)

trigger

  • trigger(
        actionIds: readonly string[],
        options?: ActionOptions,
    ): Promise<unknown>[]

  • Trigger the actions and return their response as a list of Promises.

    Parameters

    • actionIds: readonly string[]

      List of action IDs to trigger. To trigger all available actions pass a list with only one entry: ["*"].

    • Optionaloptions: ActionOptions

      Options to be passed to the actions. This can, for example, include the items of a search result.

    Returns Promise<unknown>[]

    List of Promises with the actions' result of their trigger methods.

Settings

Member Visibility

On This Page

Methods