Playwright Smart Table

Appearance

Iterate Rows ​

Walk every row ​

typescript
await table.forEach(async ({ row }) => {
  await expect(row.getCell('Status')).toHaveText('Active')
})

Processes rows one at a time, in order. Default for forEach.

Map rows to data ​

typescript
const emails = await table.map(async ({ row }) => row.getCell('Email').innerText())
const allRows = await table.map(async ({ row }) => row.toJSON())

Like forEach but returns an array. Default concurrency for map is parallel.

Filter rows by a condition ​

typescript
const highEarners = await table.filter(
  async ({ row }) => {
    const salary = await row.getCell('Salary').innerText()
    return parseInt(salary.replace(/[^0-9]/g, '')) > 50000
  },
  { maxPages: 5 }
)

Returns a SmartRowArray of all rows where the predicate returns true. Default concurrency for filter is sequential.

Concurrency ​

forEach, map, and filter all accept a concurrency option:

typescript
await table.map(async ({ row }) => row.toJSON(), { concurrency: 'sequential' })
  • parallel — all row callbacks run concurrently. Fastest. Default for map.
  • sequential — one row at a time, in order. Default for forEach and filter.
  • synchronized — row callbacks run in parallel, but the library waits for all rows on the current page to finish before advancing to the next page. Use when your callbacks interact with the table and page navigation needs to be coordinated.