Method performAction

lib/thing.ts:451–488

* Perform an action on the thing. * * @param {String} actionName Name of the action * @param {Object} input Any action inputs * @returns {Object} The action that was created.

(
    actionName: string,
    input: InputType | null
  )

   * @returns {Object} The action that was created.
   */
  performAction<InputType = any>(
    actionName: string,
    input: InputType | null
  ): Action<InputType>|undefined {
    input = input || null;

    if (!this.availableActions.hasOwnProperty(actionName)) {
      return;
    }

    const actionType = this.availableActions[actionName];

    if (actionType.metadata.hasOwnProperty('input')) {
      const schema = JSON.parse(JSON.stringify(actionType.metadata.input));

      if (schema.hasOwnProperty('properties')) {
        const props: { [propertyName: string]: any }[] =
          Object.values(schema.properties);

        for (const prop of props) {
          delete prop.title;
          delete prop.unit;
          delete prop['@type'];
        }
      }

      const valid = ajv.validate(schema, input);
      if (!valid) {
        return;
      }
    }

    const action: Action<InputType> = new actionType.class(this, input);
    action.setHrefPrefix(this.hrefPrefix);
    this.actionNotify(action);
    this.actions[actionName].push(action);
    return action;
  }

  /**
   * Remove an existing action.