Skip to main content

while

While is a processor that checks a Bloblang query against messages and executes child processors on them for as long as the query resolves to true.

# Common config fields, showing default values
label: ""
while:
at_least_once: false
check: ""
processors: []

The field at_least_once, if true, ensures that the child processors are always executed at least one time (like a do .. while loop.)

The field max_loops, if greater than zero, caps the number of loops for a message batch to this value.

If following a loop execution the number of messages in a batch is reduced to zero the loop is exited regardless of the condition result. If following a loop execution there are more than 1 message batches the query is checked against the first batch only.

Fields

at_least_once

Whether to always run the child processors at least one time.

Type: bool
Default: false

max_loops

An optional maximum number of loops to execute. Helps protect against accidentally creating infinite loops.

Type: int
Default: 0

check

A Bloblang query that should return a boolean value indicating whether the while loop should execute again.

Type: string
Default: ""

# Examples
check: errored()
check: this.urls.unprocessed.length() > 0

processors

A list of child processors to execute on each loop.

Type: array
Default: []