Move to `@testing-library/react-native` 🎉

[kentcdodds]

We're in the process of completely replacing https://github.com/testing-library/native-testing-library with this repo. Which means renaming react-native-testing-library to @testing-library/react-native.

Would anyone be interested in writing a migration guide?

EDIT:
Migration guide: https://callstack.github.io/react-native-testing-library/docs/migration-v7

[balavishnuvj]

I could help.

[thymikee]

Awesome @balavishnuvj! Let me know if you need any help. So far, in terms of differences between the libs, I'm only aware of the "disabled" property being specially handled by the second library. Is there anything else?

[balavishnuvj]

@thymikee I don't understand in and out of the library as of now. Would need your help. Also, this would one of my first open-source contributions.

[ryanjwessel]

I am working on migrating a project from @testing-library/react-native to this one now.

The first difference I noticed was that '@testing-library/react-native/cleanup-after-each', in the jest.config.js was no longer required because it happens by default in this library (see docs here).

Second, there is a difference in querying by accessibility labels between the two libraries. @testing-library/react-native uses queryByLabelText (see here), whereas this library uses queryByAccessibilityLabel, or queryByA11yLabel (see here).

Hope this helps!

[thymikee]

I'm happy to accept a PR that aliases *ByA11yLabel to *ByLabelText to ease the migration :)

[ryanjwessel]

I would be happy to take on this PR, but it would be my first time contributing to the project.

To clarify, we would alias any queries ending in ByLabelText to use ByA11yLabel instead? Should we display some sort of warning that this is temporary to support migration from the other library?

[thymikee]

Great! No warning is needed, queryByAccessibilityLabel is already an alias of queryByA11yLabel, so it's a matter of extending that to another value. Should be fairly straight-forward I hope :)

[ryanjwessel]

@thymikee Just put a PR up for it now. I think I see what you mean, hopefully this was what you were thinking. 😄

[vanGalilea]

Hi all,

Just migrated my real world examples repo, was pretty straightforward here are the diffs:

vanGalilea/react-native-testing@66f8fd3

vanGalilea/react-native-testing@364a4b4

Summary of all changes in my repo:

• wait becomes waitFor

• getByPlaceholderText becomes getByPlaceholder (chore: [TL migration] rename getByPlaceholder to getByPlaceholderText (or provide an alias) #447)

• getByLabelText become getByA11yLabel (feat: introduce ByLabelText, ByRole and ByHintText a11y aliases #445)

• *ByTestId can't handle a regex, only string

• in jest.config.js:

  • preset: '@testing-library/react-native' becomes ''react-native"
  • setupFilesAfterEnv: [ "@testing-library/react-native/cleanup-after-each"] becomes "@testing-library/jest-native/extend-expect"

• package.json:

  • installed 'testing-library/jest-native'
  • installed 'react-native-testing-library'
  • uninstalled '@testing-library/react-native'

[thymikee]

Thank you very much @vanGalilea!