The most important and only required property is the
handler function, which does all the work. Handlers are designed to be stateless. They take some input information, do some work and send back some output information. They are executed sequentially, in the order of declaration. They may themselves call other actions to achieve their purpose. Thus, despite being executed sequentially, actions are organized as hierarchical trees.
The handler receives all the properties of the action as an argument. We call those properties configuration. They are available as
config property and can define default values when declaring the action. Also, the user may overwrite any of the configuration properties. Thus, they are used to contextualize the handler.
handler, and some configuration properties. Some properties are common to all Nikita actions, such as the
shy or the
relax metadata properties, or they can be specific to an action, such as the
target configuration property of the
nikita.file action indicating the path where the content is written.
- Arguments (array)
Original arguments passed on an action call.
- Children (array)
Actions executed in the handler of a parent action.
- Config (object)
Configuration properties are used to contextualize the handler function.
- Context (function)
When action handlers are defined as traditional function expressions, they are executed with an action context. This context is useful to call child actions.
- Handler (function, required)
Define the function that an action implements to get things done.
- Metadata (object)
Contextualize or modify the execution of Nikita's action.
- Output (object)
Action output is the result returned by Nikita's actions.
- Parent action (object)
An action of the higher level in the session tree.
- Sibling action (object)
An action with the same parent and which was executed just before the current action.
- Siblings (array)
Actions at the same hierarchical level executed before the current action.
- Tools (object)
Provide additional functionalities to Nikita's actions.