Action Flow

📖 Description

The flow in a script is a sequence of actions executed for each target from the context.

It defines what must be done, in which order, and how to handle the results. Each action is an independent step: navigation, extracting text, waiting, checking conditions, logging, and other atomic operations.

🧩 Flow Structure

The flow property in the script is an array of action objects (NavaAction).
Actions are executed sequentially for each target. You can combine any actions to automate your scenario.

📋 Example

{
  "flow": [
    {
      "action": "log",
      "message": "Starting Google test!",
      "style": "italic yellow"
    },
    {
      "action": "navigate"
    },
    {
      "action": "log",
      "message": "Navigation done!"
    },
    {
      "action": "js",
      "resultName": "PageTitle",
      "script": "return document.title;"
    },
    {
      "action": "saveToFile",
      "includeLog": true
    }
  ]
}
        

This sample flow performs the following:
1. Logs: "Starting Google test!".
2. Opens the Google page (URL comes from the context).
3. Logs: "Navigation done!".
4. Executes JS to get the title (`document.title`) and stores it as "PageTitle".
5. Saves results and logs into results.jsonl.

🧩 Base Action Fields

Each action inherits from the base structure (NavaAction).
It defines shared fields. Specific types may extend it with their own parameters and logic.

📖️ Execution Stores

Three separate stores are used during execution:

Script — global variables available throughout the script.
Flow — values relevant to the current flow (action chain).
Page — variables and results for the current page or tab.

These stores allow data exchange between actions and reuse of intermediate results.

Within actions, blocks like JsCodeSpec can read/write from these stores, enabling result preservation and flow continuity.

Action Types

Multiple action types are supported (e.g., navigate, log, js, saveToFile, etc.). Each has its own parameters and use case.

📖 JsCodeSpec

JsCodeSpec is an object that defines JavaScript code to be executed in the browser or host at specific stages of the action.
The code can be provided in one of the following forms:

▪️ inline — JavaScript code written directly in the script
▪️ file — path to an external JS file (relative to the script directory)