FlowCardTrigger

The FlowCardTrigger class is a programmatic representation of a Flow Card with type trigger, as defined in an app's app.json.

Table of Contents

Constructor

new Homey.FlowCardTrigger(id)

Parameters:
Name Type Description
id string

The ID of the card as defined in the app's app.json.

Extends

Methods

getArgument() → {FlowArgument}

Get an FlowArgument instance.

Inherited From:
Returns:
Type:
FlowArgument

getArgumentValues(callbackopt) → {Promise}

Get the current argument values of this card, as filled in by the user.

Inherited From:
Parameters:
Name Type Attributes Description
callback function <optional>
Name Type Description
err Error
values Array

An array of key-value objects with the argument's name as key. Every array entry represents one Flow card.

Returns:
Type:
Promise

register() → {FlowCard}

Register the Card. This is a shorthand method for ManagerFlow#registerCard.

Inherited From:
Returns:
Type:
FlowCard

registerRunListener(fn) → {FlowCard}

Register a listener for a run event. Return a Promise, or run the callback.

Inherited From:
Parameters:
Name Type Description
fn function
Name Type Description
args Object

The arguments of the Flow Card, with keys as defined in the /app.json and values as specified by the user

state Object

The state of the Flow

callback genericCallbackFunction
Returns:
Type:
FlowCard

trigger(tokens, state, callbackopt) → {Promise}

Trigger this card to start a Flow

Parameters:
Name Type Attributes Description
tokens Object

An object with tokens and their typed values, as defined in an app's app.json

state Object

An object with properties which are accessible throughout the Flow

callback genericCallbackFunction <optional>
Returns:
Type:
Promise

Returns a promise when callback is omitted

unregister()

Unregister the Card. This is a shorthand method for ManagerFlow#unregisterCard.

Inherited From:

Events

update

This event is fired when the card is updated by the user (e.g. a Flow has been saved).

Inherited From: