mirror of
https://github.com/callstack/react-native-testing-library.git
synced 2026-09-18 23:09:04 +08:00
Augustin Le Fèvre
1360b73295
* Port types to TS * Fix CI commands * Fix typo in yml file * Address PR comments * Remove aliased accessibility queries * Add flow types * Update build to support TS * Clean up removed aliased queries * Move @babel/plugin-transform-flow-strip-types to test config * Address PR comments * Delete flow tests * Retrigger pipeline * Update src/helpers/timers.ts Co-authored-by: Michał Pierzchała <thymikee@gmail.com>
2.5 KiB
2.5 KiB
id, title
| id | title |
|---|---|
| how-should-i-query | How Should I Query? |
Priority
Based on the Guiding Principles, your test should resemble how users interact with your code (component, page, etc.) as much as possible. With this in mind, we recommend this order of priority:
- Queries Accessible to Everyone queries that reflect the experience of visual users as well as those that use assistive technology
getByText: This is the number 1 method a user finds any visible text on interactive and non-interactive elements.getByDisplayValue: Useful for the current value of aTextInput.getByPlaceholderText: Only useful for targeting a placeholder of aTextInput.getByLabelText: This can be used to query every element that is exposed in the accessibility tree as a label, usually when there's no visible text.getByHintText: This can be used to query every element that is exposed in the accessibility tree as a hint. Make sure it also has a label set.getByAccessibilityState: This can be used to query every element that is exposed in the accessibility tree as a state of an interactive element, like a checkbox.getByAccessibilityValue: This can be used to query every element that is exposed in the accessibility tree as a value on a range, like a slider.
- Queries Users Can Infer
getByRole: This can be used to query every element that is exposed in the accessibility tree as a role, like buttons or images.
- Test IDs
getByTestId: The user cannot see (or hear) these, so this is only recommended for cases where you can't match by text or it doesn't make sense