Function: getControlAggregation()
getControlAggregation(
page,controlId,aggregationName):Promise<readonlyBridgeControlRef[]>
Retrieves a control aggregation via page.evaluate() using the bridge.
Parameters
page
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.
Capability
matchers.getControlAggregation
Guarantee
Returns an array of BridgeControlRef objects (empty array if no items in aggregation).
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');