Playwright Smart Table

Appearance

Find Rows ​

Get a row on the current page ​

typescript
const row = table.getRow({ firstName: 'John', lastName: 'Doe' })

Synchronous. Returns a locator for the row on the current page matching all filters. If more than one row matches, Playwright throws a strict mode error on evaluation — same as any ambiguous locator. For a more descriptive error that shows you which rows matched, use findRow.

Find a row across pages ​

typescript
const row = await table.findRow({ firstName: 'John', lastName: 'Doe' }, { maxPages: 10 })

Paginates until it finds exactly one match or hits maxPages. If more than one row matches on the same page, it throws an Ambiguous Row error with details about the conflicting rows — add more filters to narrow it down. Requires a pagination strategy if the row might not be on the first page.

Collect all matching rows ​

typescript
const activeUsers = await table.findRows({ Status: 'Active' }, { maxPages: 10 })

Returns every match across pages. Add a pagination strategy to search beyond page one.

Get a row by its position in the data ​

typescript
const row = await table.findRowByIndex(250, { maxPages: 50 })

Row 250 of the dataset — not the 250th element on the page. If it's already rendered, you get it straight away. If not, we jump to it with your viewport's scrollToRow, or page forward with your pagination strategy until it shows up. If it can't be reached — no way to move, or not found within maxPages — it throws rather than giving you some other row.

Needs a resolveRowIndex strategy so we can tell which rendered row is which. That only identifies rows; it doesn't move the table. For the Nth row currently on screen, use getRowByIndex(n) instead — synchronous, no scrolling.

Readable names in traces and errors ​

Rows and cells come back with a name, so the trace viewer, HTML report and failed assertions show SmartRow where Name="Bob" › "Age" cell instead of a long selector chain. Rows found by position show up as SmartRow #2, findRows results include their filters too (SmartRow #2 where Status="Active"), and a findRow that comes up empty shows SmartRow not found: Name="Zed".

You don't need to do anything to get this. It uses Playwright's locator.describe(), so it needs @playwright/test 1.53 or newer. On older versions everything still works; you just see the raw selectors.

→ API Reference: Table Methods — findRow · Table Methods — findRows · Table Methods — findRowByIndex