Configuration

The library can be configured via the configure function, which accepts:

a plain JS object; this will be merged into the existing configuration. e.g. configure({testIdAttribute: 'not-data-testid'})
a function; the function will be given the existing configuration, and should return a plain JS object which will be merged as above, e.g. configure(existingConfig => ({something: [...existingConfig.something, 'extra value for the something array']}))

Configuration options:

testIdAttribute: The attribute used by getByTestId and related queries. Defaults to data-testid. See getByTestId.

Native

React

Cypress

// setup-tests.js
import { configure } from '@testing-library/dom'

configure({testIdAttribute: 'my-data-test-id'})`

// setup-tests.js
import { configure } from '@testing-library/react'

configure({testIdAttribute: 'my-data-test-id'})`

The configuration object is not currently exposed to in Cypress Testing Library

Testing Library