Skip to main content
Version: 1.x

Function: selectRowByValues()

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

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>

Capability​

ui5.table.selectRowByValues

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' });