Pagination

Every list() method returns a Page<T>. Pages are async-iterable, so the simplest consumer iterates across every item across every page transparently.

Auto-iterate

for await (const env of await verial.environments.list()) {
  console.log(env.id)
}

The iterator fetches successive pages lazily as you consume items.

One Page at a Time

let page = await verial.environments.list({ limit: 50 })

do {
  for (const env of page.data) {
    console.log(env.id)
  }
  const next = await page.getNextPage()
  if (!next) break
  page = next
} while (true)

Page Surface

Member	Type	Description
`data`	`T[]`	Items in this page
`hasNextPage()`	`() => boolean`	`true` if another page is available
`getNextPage()`	`() => Promise<Page<T> \| null>`	Fetches the next page, or `null` if none
`toJSON()`	`() => { data, _meta }`	Serializable snapshot
`_meta.next`	`string \| null`	Next cursor
`_meta.prev`	`string \| null`	Previous cursor
`_meta.limit`	`number`	Page size

Options

All list methods accept:

Option	Type	Description
`cursor`	string	Resume from a specific cursor
`limit`	number	Items per page

Early Exit

Stop iteration whenever you want — the SDK doesn’t prefetch pages.

for await (const run of await verial.runs.list()) {
  if (run.verdict === 'pass') {
    return run
  }
}

Getting Started

Resources

Auto-iterate

One Page at a Time

Page Surface

Options

Early Exit

​Auto-iterate

​One Page at a Time

​Page Surface

​Options

​Early Exit

Auto-iterate

One Page at a Time

Page Surface

Options

Early Exit