.

Author: mdjastrzebski

docs/api/fire-event.md

@@ -15,6 +15,8 @@ The `fireEvent` API triggers event handlers on both host and composite component
 
 Unlike User Event, this API does not automatically pass event object to event handler, this is responsibility of the user to construct such object.
 
+The base `fireEvent(instance, eventName, ...data)` API can pass multiple custom arguments to the handler. Convenience helpers such as `fireEvent.press` and `fireEvent.scroll` are different: they create a default event object and accept one optional object to merge into it.
+
 This function uses async `act` internally to execute all pending React updates during event handling.
 
 ```jsx
@@ -64,11 +66,11 @@ FireEvent exposes convenience methods for common events like: `press`, `changeTe
 ```tsx
 fireEvent.press: (
   instance: TestInstance,
-  ...data: Array<any>,
-) => Promise<unknown>
+  eventProps?: Record<string, unknown>,
+) => Promise<void>
 ```
 
-Invokes `press` event handler on the element or parent element in the tree.
+Builds a press event object, merges `eventProps` into it, and invokes the `press` handler on the element or nearest eligible parent.
 
 ```jsx
 import { View, Text, TouchableOpacity } from 'react-native';
@@ -91,7 +93,7 @@ await render(
 );
 
 await fireEvent.press(screen.getByText('Press me'), eventData);
-expect(onPressMock).toHaveBeenCalledWith(eventData);
+expect(onPressMock).toHaveBeenCalledWith(expect.objectContaining(eventData));
 ```
 
 ### `fireEvent.changeText`
@@ -102,8 +104,8 @@ expect(onPressMock).toHaveBeenCalledWith(eventData);
 ```tsx
 fireEvent.changeText: (
   instance: TestInstance,
-  ...data: Array<any>,
-) => Promise<unknown>
+  text: string,
+) => Promise<void>
 ```
 
 Invokes `changeText` event handler on the element or parent element in the tree.
@@ -132,11 +134,11 @@ await fireEvent.changeText(screen.getByPlaceholderText('Enter data'), CHANGE_TEX
 ```tsx
 fireEvent.scroll: (
   instance: TestInstance,
-  ...data: Array<any>,
-) => Promise<unknown>
+  eventProps?: Record<string, unknown>,
+) => Promise<void>
 ```
 
-Invokes `scroll` event handler on the element or parent element in the tree.
+Builds a scroll event object, merges `eventProps` into it, and invokes the `scroll` handler on the element or nearest eligible parent.
 
 #### On a `ScrollView`
 

docs/api/overview.md

@@ -12,7 +12,7 @@ React Native Testing Library consists of following APIs:
 - [Fire Event](./fire-event.md) - simulate any component event in a simplified way purposes
 - Misc APIs:
   - [`renderHook` function](./render-hook.md) - render hooks for testing
-  - [Async utils](./async-utilities.md): `findBy*` queries, `wait`, `waitForElementToBeRemoved`
+  - [Async utils](./async-utilities.md): `findBy*` queries, `waitFor`, `waitForElementToBeRemoved`
   - [Configuration](./configuration.md): `configure`, `resetToDefaults`
   - [Accessibility](./accessibility.md): `isHiddenFromAccessibility`
   - [Other](./other-helpers.md): `within`, `act`, `cleanup`

docs/api/queries.md

@@ -397,7 +397,6 @@ expect(
 ).not.toBeOnTheScreen();
 
 // Include hidden elements
-expect(screen.getByText('Hidden from accessibility')).toBeOnTheScreen();
 expect(
   screen.getByText('Hidden from accessibility', { includeHiddenElements: true }),
 ).toBeOnTheScreen();