Migration to 13.0#

Migration to React Native Testing Library version 13 from version 12.x.

Breaking changes#

Supported React and React Native versions#

This version supports only React 19 and corresponding React Native versions. If you use React 18 or 19, please use latest of v12 versions.

[Note: at the moment there is no React Native for React 19, and React 19 is still in beta, so we use React 18.3 for the time being].

Removed deprecated *ByAccessibilityState queries#

This deprecated query has been removed as is typically too general to give meaningful results. Use one of the following options:

• *ByRole query with relevant state options: disabled, selected, checked, expanded and busy
• use built-in Jest matchers to check the state of element found using some other query:
  • enabled state: toBeEnabled() / toBeDisabled()
  • checked state: toBeChecked() / toBePartiallyChecked()
  • selected state: toBeSelected()
  • expanded state: toBeExpanded() / toBeCollapsed()
  • busy state: toBeBusy()

// Replace this
const view = screen.getByAccessibilityState({ disabled: true });

// with this (getByRole query)
const view = screen.getByRole('<proper role here>', { disabled: true });

// or this (Jest matcher)
const view = screen.getBy*(...); // Find the element using any query: *ByRole, *ByText, *ByTestId
expect(view).toBeDisabled(); // Assert its accessibility state

Removed deprecated *ByAccessibilityValue queries#

This deprecated query has been removed as is typically too general to give meaningful results. Use one of the following options:

• toHaveAccessibilityValue() Jest matcher to check the state of element found using some other query
• *ByRole query with value option

// Replace this
const view = screen.getByAccessibilityValue({ now: 50, min: 0, max: 50 });

// with this (getByRole query)
const view = screen.getByRole('<proper role here>', { value: { now: 50, min: 0, max: 50 } });

// or this (Jest matcher)
const view = screen.getBy*(...); // Find the element using any query: *ByRole, *ByText, *ByTestId
expect(view).toHaveAccessibilityValue({ now: 50, min: 0, max: 50 }); // Assert its accessibility value

Removed debug.shallow#

For a time being we didn't support shallow rendering. Now we are removing the last remains of it: debug.shallow(). If you are interested in shallow rendering see here.

Other changes#

Updated flushMicroTasks internal method#

This should not break any tests.

Full Changelog#

https://github.com/callstack/react-native-testing-library/compare/v12.5.2...v13.0.0