.

Author: mdjastrzebski

website/docs/13.x/docs/api/jest-matchers.mdx

@@ -4,11 +4,11 @@ This guide describes built-in Jest matchers. These matchers provide readable ass
 
 ## Setup
 
-There is no need to set up the built-in matchers; they are automatically available in your tests when you import anything from `@testing-library/react-native`, e.g., `render`.
+No setup needed. Matchers are available when you import from `@testing-library/react-native`.
 
-## Migration from legacy Jest Native matchers.
+## Migration from legacy Jest Native matchers
 
-If you are already using legacy Jest Native matchers we have a [migration guide](/docs/migration/jest-matchers) for moving to the built-in matchers.
+If you use legacy Jest Native matchers, see the [migration guide](/docs/migration/jest-matchers).
 
 ## Checking element existence
 
@@ -18,7 +18,7 @@ If you are already using legacy Jest Native matchers we have a [migration guide]
 expect(element).toBeOnTheScreen();
 ```
 
-Checks if an element is attached to the element tree. If you hold a reference to an element and it gets unmounted during the test, it will no longer pass this assertion.
+Checks if an element is attached to the element tree. If a referenced element gets unmounted during the test, this assertion fails.
 
 ## Element Content
 
@@ -34,7 +34,7 @@ expect(element).toHaveTextContent(
 )
 ```
 
-Checks if the element has the specified text content. Accepts `string` or `RegExp` matchers, as well as [text match options](/docs/api/queries#text-match-options) of `exact` and `normalizer`.
+Checks if the element has the specified text content. Accepts `string` or `RegExp`, with optional [text match options](/docs/api/queries#text-match-options) `exact` and `normalizer`.
 
 ### `toContainElement()`
 
@@ -44,15 +44,15 @@ expect(container).toContainElement(
 )
 ```
 
-Checks if the container element contains another host element.
+Checks if a container element contains another element.
 
 ### `toBeEmptyElement()`
 
 ```ts
 expect(element).toBeEmptyElement();
 ```
 
-Checks if the element has no host child elements or text content.
+Checks if the element has no child elements or text content.
 
 ## Checking element state
 
@@ -68,7 +68,7 @@ expect(element).toHaveDisplayValue(
 )
 ```
 
-Checks if the `TextInput` element has the specified display value. Accepts `string` or `RegExp` matchers, as well as [text match options](/docs/api/queries#text-match-options) of `exact` and `normalizer`.
+Checks if a `TextInput` has the specified display value. Accepts `string` or `RegExp`, with optional [text match options](/docs/api/queries#text-match-options) `exact` and `normalizer`.
 
 ### `toHaveAccessibilityValue()`
 
@@ -85,9 +85,9 @@ expect(element).toHaveAccessibilityValue(
 
 Checks if the element has a specified accessible value.
 
-This matcher will assert accessibility value based on `aria-valuemin`, `aria-valuemax`, `aria-valuenow`, `aria-valuetext` and `accessibilityValue` props. Only defined value entries will be used in the assertion, the element might have additional accessibility value entries and still be matched.
+Reads from `aria-valuemin`, `aria-valuemax`, `aria-valuenow`, `aria-valuetext`, and `accessibilityValue` props. Only the values you specify are checked, so the element can have other accessibility value entries and still match.
 
-When querying by `text` entry a string or `RegExp` might be used.
+For the `text` entry, you can use `string` or `RegExp`.
 
 ### `toBeEnabled()` / `toBeDisabled` {#tobeenabled}
 
@@ -96,10 +96,10 @@ expect(element).toBeEnabled();
 expect(element).toBeDisabled();
 ```
 
-Checks if the element is enabled or disabled from the user's perspective. These rely on the accessibility disabled state set by `aria-disabled` or `accessibilityState.disabled` props. An element is considered disabled when it or any of its ancestors is disabled.
+Checks if the element is enabled or disabled based on `aria-disabled` or `accessibilityState.disabled` props. An element is disabled when it or any ancestor is disabled.
 
 :::note
-These matchers are the negation of each other, and both are provided to avoid double negations in your assertions.
+These matchers are opposites. Both are provided to avoid double negations in assertions.
 :::
 
 ### `toBeSelected()`
@@ -108,7 +108,7 @@ These matchers are the negation of each other, and both are provided to avoid do
 expect(element).toBeSelected();
 ```
 
-Checks if the element is selected from the user's perspective. Relies on the accessibility selected state set by `aria-selected` or `accessibilityState.selected` props.
+Checks if the element is selected based on `aria-selected` or `accessibilityState.selected` props.
 
 ### `toBeChecked()` / `toBePartiallyChecked()` {#tobechecked}
 
@@ -117,12 +117,12 @@ expect(element).toBeChecked();
 expect(element).toBePartiallyChecked();
 ```
 
-Checks if the element is checked or partially checked from the user's perspective. These rely on the accessibility checked state set by `aria-checked` or `accessibilityState.checked` props.
+Checks if the element is checked or partially checked based on `aria-checked` or `accessibilityState.checked` props.
 
 :::note
 
-- `toBeChecked()` matcher works only on `Switch` host elements and accessibility elements with `checkbox`, `radio` or `switch` role.
-- `toBePartiallyChecked()` matcher works only on elements with `checkbox` role.
+- `toBeChecked()` works only on `Switch` elements and elements with `checkbox`, `radio`, or `switch` role.
+- `toBePartiallyChecked()` works only on elements with `checkbox` role.
 
 :::
 
@@ -133,10 +133,10 @@ expect(element).toBeExpanded();
 expect(element).toBeCollapsed();
 ```
 
-Checks if the element is expanded or collapsed from the user's perspective. These rely on the accessibility expanded state set by `aria-expanded` or `accessibilityState.expanded` props.
+Checks if the element is expanded or collapsed based on `aria-expanded` or `accessibilityState.expanded` props.
 
 :::note
-These matchers are the negation of each other for expandable elements (elements with explicit `aria-expanded` or `accessibilityState.expanded` props). However, both won't pass for non-expandable elements (ones without explicit `aria-expanded` or `accessibilityState.expanded` props).
+These matchers are opposites for expandable elements (those with explicit `aria-expanded` or `accessibilityState.expanded` props). For non-expandable elements, neither matcher passes.
 :::
 
 ### `toBeBusy()`
@@ -145,7 +145,7 @@ These matchers are the negation of each other for expandable elements (elements
 expect(element).toBeBusy();
 ```
 
-Checks if the element is busy from the user's perspective. Relies on the accessibility busy state set by `aria-busy` or `accessibilityState.busy` props.
+Checks if the element is busy based on `aria-busy` or `accessibilityState.busy` props.
 
 ## Checking element style
 
@@ -155,9 +155,9 @@ Checks if the element is busy from the user's perspective. Relies on the accessi
 expect(element).toBeVisible();
 ```
 
-Checks if the element is visible from the user's perspective.
+Checks if the element is visible.
 
-The element is considered invisible when itself or any of its ancestors has `display: none` or `opacity: 0` styles, as well as when it's hidden from accessibility.
+An element is invisible when it or any ancestor has `display: none` or `opacity: 0` styles, or when it's hidden from accessibility.
 
 ### `toHaveStyle()`
 
@@ -167,7 +167,7 @@ expect(element).toHaveStyle(
 )
 ```
 
-Checks if the element has the specified styles.
+Checks if the element has specific styles.
 
 ## Other matchers
 
@@ -183,11 +183,11 @@ expect(element).toHaveAccessibleName(
 )
 ```
 
-Checks if the element has the specified accessible name. Accepts `string` or `RegExp` matchers, as well as [text match options](/docs/api/queries#text-match-options) of `exact` and `normalizer`.
+Checks if the element has the specified accessible name. Accepts `string` or `RegExp`, with optional [text match options](/docs/api/queries#text-match-options) `exact` and `normalizer`.
 
-The accessible name will be computed based on `aria-labelledby`, `accessibilityLabelledBy`, `aria-label`, and `accessibilityLabel` props, in the absence of these props, the element text content will be used.
+The accessible name comes from `aria-labelledby`, `accessibilityLabelledBy`, `aria-label`, and `accessibilityLabel` props. If none are present, the element's text content is used.
 
-When the `name` parameter is `undefined` it will only check if the element has any accessible name.
+Without a `name` parameter (or with `undefined`), it only checks if the element has any accessible name.
 
 ### `toHaveProp()`
 
@@ -198,8 +198,8 @@ expect(element).toHaveProp(
 )
 ```
 
-Checks if the element has the specified prop. When `value` is `undefined`, it only checks for existence of the prop. When `value` is defined, it checks if the actual value matches.
+Checks if the element has a prop. Without a `value` (or with `undefined`), it only checks if the prop exists. With a `value`, it checks if the prop's value matches.
 
 :::note
-This matcher should be treated as an escape hatch to be used when all other matchers are not suitable.
+Use this matcher as a last resort when other matchers don't fit your needs.
 :::

website/docs/14.x/docs/api/jest-matchers.mdx

@@ -4,7 +4,7 @@ This guide covers the built-in Jest matchers. These matchers make your tests eas
 
 ## Setup
 
-There is no need to set up the built-in matchers; they are automatically available in your tests when you import anything from `@testing-library/react-native`, e.g., `render`.
+No setup needed. Matchers are available when you import from `@testing-library/react-native`.
 
 ## Checking element existence
 
@@ -30,7 +30,7 @@ expect(element).toHaveTextContent(
 )
 ```
 
-Checks if an element has the specified text content. You can pass a `string` or `RegExp`, plus [text match options](/docs/api/queries#text-match-options) like `exact` and `normalizer`.
+Checks if an element has the specified text content. Accepts `string` or `RegExp`, with optional [text match options](/docs/api/queries#text-match-options) like `exact` and `normalizer`.
 
 ### `toContainElement()`
 
@@ -40,15 +40,15 @@ expect(container).toContainElement(
 )
 ```
 
-Checks if the container element contains another host element.
+Checks if a container element contains another element.
 
 ### `toBeEmptyElement()`
 
 ```ts
 expect(element).toBeEmptyElement();
 ```
 
-Checks if an element has no host child elements or text content.
+Checks if an element has no child elements or text content.
 
 ## Checking element state
 
@@ -64,7 +64,7 @@ expect(element).toHaveDisplayValue(
 )
 ```
 
-Checks if the `TextInput` element has the specified display value. You can pass a `string` or `RegExp`, plus [text match options](/docs/api/queries#text-match-options) like `exact` and `normalizer`.
+Checks if a `TextInput` has the specified display value. Accepts `string` or `RegExp`, with optional [text match options](/docs/api/queries#text-match-options) like `exact` and `normalizer`.
 
 ### `toHaveAccessibilityValue()`
 
@@ -81,7 +81,7 @@ expect(element).toHaveAccessibilityValue(
 
 Checks if an element has the specified accessible value.
 
-The matcher checks accessibility values from `aria-valuemin`, `aria-valuemax`, `aria-valuenow`, `aria-valuetext`, and `accessibilityValue` props. It only checks the values you specify—the element can have other accessibility value entries and still match.
+The matcher reads accessibility values from `aria-valuemin`, `aria-valuemax`, `aria-valuenow`, `aria-valuetext`, and `accessibilityValue` props. It only checks the values you specify, so the element can have other accessibility value entries and still match.
 
 For the `text` entry, you can use a string or `RegExp`.
 
@@ -92,7 +92,7 @@ expect(element).toBeEnabled();
 expect(element).toBeDisabled();
 ```
 
-Checks if an element is enabled or disabled. Uses the accessibility disabled state from `aria-disabled` or `accessibilityState.disabled` props. An element is considered disabled if it or any of its ancestors is disabled.
+Checks if an element is enabled or disabled from `aria-disabled` or `accessibilityState.disabled` props. An element is disabled if it or any ancestor is disabled.
 
 :::note
 These matchers are opposites. Both are available so you can avoid double negations like `expect(element).not.toBeDisabled()`.
@@ -104,7 +104,7 @@ These matchers are opposites. Both are available so you can avoid double negatio
 expect(element).toBeSelected();
 ```
 
-Checks if an element is selected. Uses the accessibility selected state from `aria-selected` or `accessibilityState.selected` props.
+Checks if an element is selected from `aria-selected` or `accessibilityState.selected` props.
 
 ### `toBeChecked()` / `toBePartiallyChecked()` {#tobechecked}
 
@@ -113,7 +113,7 @@ expect(element).toBeChecked();
 expect(element).toBePartiallyChecked();
 ```
 
-Checks if an element is checked or partially checked. Uses the accessibility checked state from `aria-checked` or `accessibilityState.checked` props.
+Checks if an element is checked or partially checked from `aria-checked` or `accessibilityState.checked` props.
 
 :::note
 
@@ -129,7 +129,7 @@ expect(element).toBeExpanded();
 expect(element).toBeCollapsed();
 ```
 
-Checks if an element is expanded or collapsed. Uses the accessibility expanded state from `aria-expanded` or `accessibilityState.expanded` props.
+Checks if an element is expanded or collapsed from `aria-expanded` or `accessibilityState.expanded` props.
 
 :::note
 These matchers are opposites for expandable elements (those with explicit `aria-expanded` or `accessibilityState.expanded` props). For non-expandable elements, neither matcher will pass.
@@ -141,7 +141,7 @@ These matchers are opposites for expandable elements (those with explicit `aria-
 expect(element).toBeBusy();
 ```
 
-Checks if an element is busy. Uses the accessibility busy state from `aria-busy` or `accessibilityState.busy` props.
+Checks if an element is busy from `aria-busy` or `accessibilityState.busy` props.
 
 ## Checking element style
 
@@ -153,7 +153,7 @@ expect(element).toBeVisible();
 
 Checks if an element is visible.
 
-An element is considered invisible if it or any of its ancestors has `display: none` or `opacity: 0` styles, or if it's hidden from accessibility.
+An element is invisible if it or any ancestor has `display: none` or `opacity: 0` styles, or if it's hidden from accessibility.
 
 ### `toHaveStyle()`
 
@@ -163,7 +163,7 @@ expect(element).toHaveStyle(
 )
 ```
 
-Checks if an element has the specified styles.
+Checks if an element has specific styles.
 
 ## Other matchers
 
@@ -179,11 +179,11 @@ expect(element).toHaveAccessibleName(
 )
 ```
 
-Checks if an element has the specified accessible name. You can pass a `string` or `RegExp`, plus [text match options](/docs/api/queries#text-match-options) like `exact` and `normalizer`.
+Checks if an element has the specified accessible name. Accepts `string` or `RegExp`, with optional [text match options](/docs/api/queries#text-match-options) like `exact` and `normalizer`.
 
-The accessible name comes from `aria-labelledby`, `accessibilityLabelledBy`, `aria-label`, and `accessibilityLabel` props. For `Image` elements, the `alt` prop is also used. If none of these are present, the element's text content is used.
+The accessible name comes from `aria-labelledby`, `accessibilityLabelledBy`, `aria-label`, and `accessibilityLabel` props. For `Image` elements, the `alt` prop is also used. If none are present, the element's text content is used.
 
-If you don't pass a `name` parameter (or pass `undefined`), it only checks whether the element has any accessible name.
+Without a `name` parameter (or with `undefined`), it only checks whether the element has any accessible name.
 
 ### `toHaveProp()`
 
@@ -194,7 +194,7 @@ expect(element).toHaveProp(
 )
 ```
 
-Checks if an element has a prop. If you don't pass a `value` (or pass `undefined`), it only checks if the prop exists. If you pass a `value`, it checks if the prop's value matches.
+Checks if an element has a prop. Without a `value` (or with `undefined`), it only checks if the prop exists. With a `value`, it checks if the prop's value matches.
 
 :::note
 Use this matcher as a last resort when other matchers don't fit your needs.