Skip to main content
Version: 1.x

Function: selectRowByValues()

selectRowByValues(page, tableId, columnValues, options?): Promise<void>

Defined in: src/modules/table-operations.ts:231

Finds a row by column values and selects it.

Parameters

page

TableOperationsPage

Playwright Page (or compatible subset).

tableId

string

The UI5 control ID.

columnValues

ColumnValueCriteria

Column name to expected value mapping.

options?

TableOptions

Table options.

Returns

Promise<void>

Intent

Locate a table row matching column criteria and select it programmatically.

Recipe

Table row selection by value: 1. Resolve column names via getColumnNames(), 2. Search rows for matching cell values via findRowByValues(), 3. Select the matched row via selectTableRow().

Throws

ControlError if no matching row is found.

Example

await selectRowByValues(page, 'myTable', { Name: 'Alice' });