Script Flow in Bruno

In Bruno, we provide two types of script flows: Sandwich and Sequential. These flows control the order in which pre-request scripts, post-response scripts, and test scripts at various levels of your API test collections are executed, allowing for flexibility and control over your automation.

Flow Types

Sandwich Flow
Sequential Flow

1. Sandwich Flow

In the Sandwich Flow, scripts are executed in the following order:

sandwich-flow/
├── Collection Pre Script
│   └── Folder Pre Script
│       └── Request Pre Script
├── Request Post Script
│   └── Folder Post Script
│       └── Collection Post Script
└── Request Test Script
    └── Folder Test Script
        └── Collection Test Script

Execution order:

Collection Pre Script
Folder Pre Script
Request Pre Script
Request Post Script
Folder Post Script
Collection Post Script
Request Test Script
Folder Test Script
Collection Test Script

This order nests pre-scripts inward and post-scripts / test scripts outward. It is useful when you need to set up state at broader scopes first, then tear down or assert from the request level back out to the collection.

2. Sequential (Natural) Flow

In the Sequential Flow, scripts are executed in this order:

sequential-flow/
├── Collection Pre Script
│   └── Folder Pre Script
│       └── Request Pre Script
├── Collection Post Script
│   └── Folder Post Script
│       └── Request Post Script
└── Collection Test Script
    └── Folder Test Script
        └── Request Test Script

Execution order:

Collection Pre Script
Folder Pre Script
Request Pre Script
Collection Post Script
Folder Post Script
Request Post Script
Collection Test Script
Folder Test Script
Request Test Script

This flow runs each phase (pre, post, test) from collection → folder → request. It may be better suited when you want a clean top-to-bottom execution at every stage.

Setting the Flow Type

If the flow property is not specified, Sandwich is used by default.

You can set the flow type (either sandwich or sequential) in your collection configuration file:

YAML Collections
Bru Collections

opencollection.yml

extensions:
  bruno:
    scripts:
      flow: sequential  # Or "sandwich"

bruno.json

{
  "scripts": {
    "moduleWhitelist": ["crypto", "buffer", "form-data"],
    "filesystemAccess": {
      "allow": true
    },
    "flow": "sequential"
  }
}

Resources

Blog - Script Flow in Bruno

Getting Started

Core Features

API Tools

Developer Tools

License Management

Advanced Guides

Script Flow in Bruno

Flow Types

1. Sandwich Flow

2. Sequential (Natural) Flow

Setting the Flow Type

Resources

​Flow Types

​1. Sandwich Flow

​2. Sequential (Natural) Flow

​Setting the Flow Type

​Resources

Flow Types

1. Sandwich Flow

2. Sequential (Natural) Flow

Setting the Flow Type

Resources