byDataTestId

Locate elements by the data-testid attribute. An array of IDs can be provided to build a descendant chain.

LoginForm.tsx

<form>
  <input data-testid='username' />
  <input type='password' data-testid='password' />
  <button data-testid='submit'>Submit</button>
</form>

const submitBtn = byDataTestId('submit');

A common pattern is to use byDataTestId when defining a driver:

const parts = {
  username: { locator: byDataTestId('username'), driver: TextFieldDriver },
  password: { locator: byDataTestId('password'), driver: TextFieldDriver },
  submit: { locator: byDataTestId('submit'), driver: ButtonDriver },
} satisfies ScenePart;