Playwright Smart Table

Appearance

Read Cells ​

Get a specific cell ​

typescript
const cell = row.getCell('Email')
await expect(cell).toHaveText('john@example.com')
await cell.click()

Returns a plain Playwright Locator. Pass it to expect(), click(), fill(), or any other Playwright API. For virtualized tables the cell is scrolled into view automatically before it is returned.

Read a full row as an object ​

typescript
const data = await row.toJSON()
// { ID: '1', Name: 'Alice', Email: 'alice@example.com', Status: 'Active' }

Returns all cells as a plain object keyed by column name.

Read specific columns only ​

typescript
const data = await row.toJSON({ columns: ['ID', 'Status'] })
// { ID: '1', Status: 'Active' }

Pass { columns } to skip columns you don't need. Especially useful in virtualized tables where reading every column requires horizontal scrolling.

Read every cell at the same moment ​

typescript
const data = await row.toJSON({ atomic: true })

Normally each column is read one after another. If the row is live — prices ticking, statuses flipping — the first column and the last can come from different moments. atomic takes a single snapshot of the whole row instead.

It needs cellSelector to be a CSS string (not a function). Column overrides still work — their cell and getCell() read from the snapshot, but row is still the live row, so anything you read through row can be newer than the snapshot.

Bring a row into view ​

typescript
await row.bringIntoView()
const data = await row.toJSON()

For rows returned by getRow() (synchronous, no rowIndex) or when a row may have scrolled out of view after being collected, bringIntoView() scrolls the table to the correct page and row position before you interact. Rows returned by findRow() and findRows() already carry a known rowIndex, so bringIntoView() is optional but harmless.

Scroll a column into view ​

typescript
await table.scrollToColumn('Notes')
const cell = row.getCell('Notes')

Scrolls the table horizontally to bring the named column into view. Prefers strategies.viewport.scrollToColumn when configured; otherwise scrolls the header cell. Use it when you need the header itself visible — for example, to click it for sorting or assert its aria-sort attribute. Reading cell data via toJSON() / getValue() scrolls columns into view internally when a viewport or navigation strategy is configured.

Read a single column value ​

typescript
const email = await row.getValue('Email')

Universal accessor for real, override, and synthetic columns. On virtualized tables (with viewport or navigation), mounts the cell via the same pipeline as toJSON before reading — so you do not get empty/stale text for off-screen columns.

→ API Reference: SmartRow — getCell · SmartRow — toJSON · Table Methods