Skip to main content
Version: 1.x

Function: getControlAggregation()

getControlAggregation(page, controlId, aggregationName): Promise<readonly BridgeControlRef[]>

Retrieves a control aggregation via page.evaluate() using the bridge.

Parameters

page

MatcherPage

The page (or minimal MatcherPage) to evaluate on.

controlId

string

The ID of the UI5 control.

aggregationName

string

The aggregation to read (e.g., 'items', 'cells').

Returns

Promise<readonly BridgeControlRef[]>

An array of control references from the browser context.

Intent

Read an aggregation (child controls) from a UI5 control for table/list assertions.

Remarks

Ensures the bridge is injected, then executes the getter method for the given aggregation on the target control. Returns an array of BridgeControlRef objects.

Example

const rows = await getControlAggregation(page, 'table1', 'items');