byRole

Locate elements by their ARIA role attribute.

const dialog = byRole('dialog');

SelectableList.tsx

<ul data-testid="selectable-list">
  <li role="button">Apple</li>
  <li role="button">Banana</li>
</ul>

In a list component you can locate each item by its role:

const scene = {
  selectableList: {
    locator: byDataTestId('selectable-list'),
    driver: ListDriver,
    option: {
      itemLocator: byRole('button'),
      itemClass: ListItemDriver,
    },
  },
} satisfies ScenePart;