Where is your table?

The root locator you pass to useTable(). Everything else — headers, rows, cells — is resolved relative to this element.

useTable(page.locator('#my-table'))
useTable(page.locator('[role="grid"]'))
useTable(page.locator('.ag-root'))

Config: first argument to useTable()

---

What if there's no table?

A lot of apps don't render an empty table when there are no results — they swap it out for a "No results" message. Without being told, we'll go looking for headers that aren't there and init() will fail.

Point us at the empty-state element instead:

const table = await useTable(page.locator('#orders'), {
  emptyState: page.getByText('No orders found'),
}).init()

if (table.isEmpty()) {
  // nothing to check
}

If the headers can't be found but that element is visible, init() succeeds and isEmpty() returns true. Row methods still throw on an empty table, so check isEmpty() before reaching for rows.

Config: emptyState

---

→ API Reference: Config Options · Config Options — emptyState