docs

Author: mdjastrzebski

website/docs/13.x/docs/api/events/fire-event.mdx

@@ -157,7 +157,6 @@ Prefer using [`user.scrollTo`](docs/api/events/user-event#scrollto) over `fireEv
 
 :::
 
-
 ## `fireEventAsync`
 
 :::info RNTL minimal version
@@ -166,12 +165,15 @@ This API requires RNTL v13.3.0 or later.
 
 :::
 
-
 ```ts
-async function fireEventAsync(element: ReactTestInstance, eventName: string, ...data: unknown[]): Promise<unknown>;
+async function fireEventAsync(
+  element: ReactTestInstance,
+  eventName: string,
+  ...data: unknown[]
+): Promise<unknown>;
 ```
 
-The `fireEventAsync` function is the async version of `fireEvent` designed for working with React 19 and React Suspense. It wraps event handler execution in async `act()`, making it suitable for event handlers that trigger suspense boundaries or other async behavior.
+The `fireEventAsync` function is the async version of `fireEvent` designed for working with React 19 and React Suspense. This function uses async `act` function internally to ensure all pending React updates are executed during event handling.
 
 ```jsx
 import { renderAsync, screen, fireEventAsync } from '@testing-library/react-native';
@@ -192,20 +194,20 @@ Like `fireEvent`, `fireEventAsync` also provides convenience methods for common
 fireEventAsync.press: (element: ReactTestInstance, ...data: Array<any>) => Promise<unknown>
 ```
 
-Async version of `fireEvent.press` designed for React 19 and React Suspense. Use when press event handlers trigger suspense boundaries or other async behavior.
+Async version of `fireEvent.press` designed for React 19 and React Suspense. Use when press event handlers trigger suspense boundaries.
 
 ### `fireEventAsync.changeText` {#async-change-text}
 
 ```
 fireEventAsync.changeText: (element: ReactTestInstance, ...data: Array<any>) => Promise<unknown>
 ```
 
-Async version of `fireEvent.changeText` designed for React 19 and React Suspense. Use when changeText event handlers trigger suspense boundaries or other async behavior.
+Async version of `fireEvent.changeText` designed for React 19 and React Suspense. Use when changeText event handlers trigger suspense boundaries.
 
 ### `fireEventAsync.scroll` {#async-scroll}
 
 ```
 fireEventAsync.scroll: (element: ReactTestInstance, ...data: Array<any>) => Promise<unknown>
 ```
 
-Async version of `fireEvent.scroll` designed for React 19 and React Suspense. Use when scroll event handlers trigger suspense boundaries or other async behavior.
+Async version of `fireEvent.scroll` designed for React 19 and React Suspense. Use when scroll event handlers trigger suspense boundaries.

website/docs/13.x/docs/api/misc/render-hook.mdx

@@ -2,7 +2,7 @@
 
 ```ts
 function renderHook<Result, Props>(
-  callback: (props?: Props) => Result,
+  hookFn: (props?: Props) => Result,
   options?: RenderHookOptions<Props>
 ): RenderHookResult<Result, Props>;
 ```
@@ -129,3 +129,52 @@ it('should use context value', () => {
   // ...
 });
 ```
+
+## `renderHookAsync` function
+
+```ts
+async function renderHookAsync<Result, Props>(
+  hookFn: (props?: Props) => Result,
+  options?: RenderHookOptions<Props>
+): Promise<RenderHookAsyncResult<Result, Props>>;
+```
+
+Async versions of `renderHook` designed for working with React 19 and React Suspense. This method uses async `act` function internally to ensure all pending React updates are executed during rendering.
+
+- **Returns a Promise**: Should be awaited
+- **Async methods**: Both `rerender` and `unmount` return Promises and should be awaited
+- **Suspense support**: Compatible with React Suspense boundaries and `React.use()`
+
+### Result {#result-async}
+
+```ts
+interface RenderHookAsyncResult<Result, Props> {
+  result: { current: Result };
+  rerender: (props: Props) => Promise<void>;
+  unmount: () => Promise<void>;
+}
+```
+
+The `RenderHookAsyncResult` differs from `RenderHookResult` in that `rerender` and `unmount` are async functions.
+
+```ts
+import { renderHookAsync, act } from '@testing-library/react-native';
+
+test('should handle async hook behavior', async () => {
+  const { result, rerender } = await renderHookAsync(useAsyncHook);
+
+  // Test initial state
+  expect(result.current.loading).toBe(true);
+
+  // Wait for async operation to complete
+  await act(async () => {
+    await new Promise((resolve) => setTimeout(resolve, 100));
+  });
+
+  // Re-render to get updated state
+  await rerender();
+  expect(result.current.loading).toBe(false);
+});
+```
+
+Use `renderHookAsync` when testing hooks that use React Suspense, `React.use()`, or other concurrent features where timing of re-renders matters.

website/docs/13.x/docs/api/render.mdx

@@ -77,10 +77,10 @@ This API requires RNTL v13.3.0 or later.
 async function renderAsync(
   component: React.Element<any>,
   options?: RenderAsyncOptions
-): Promise<RenderAsyncResult>
+): Promise<RenderAsyncResult>;
 ```
 
-The `renderAsync` function is the async version of `render` designed for working with React 19 and React Suspense. It allows components to be properly rendered when they contain suspense boundaries or async behavior that needs to complete before the render result is returned.
+The `renderAsync` function is the async version of `render` designed for working with React 19 and React Suspense. This function uses async `act` function internally to ensure all pending React updates are executed during rendering.
 
 ```jsx
 import { renderAsync, screen } from '@testing-library/react-native';

website/docs/13.x/docs/api/screen.mdx

@@ -55,17 +55,17 @@ This API requires RNTL v13.3.0 or later.
 function rerenderAsync(element: React.Element<unknown>): Promise<void>;
 ```
 
-Async versions of `rerender` designed for working with React 19 and React Suspense. These methods wait for async operations to complete during re-rendering, making them suitable for components that use suspense boundaries or other async behavior.
+Async versions of `rerender` designed for working with React 19 and React Suspense. This method uses async `act` function internally to ensure all pending React updates are executed during updating.
 
 ```jsx
 import { renderAsync, screen } from '@testing-library/react-native';
 
 test('async rerender test', async () => {
   await renderAsync(<MyComponent initialData="first" />);
-  
+
   // Use async rerender when component has suspense or async behavior
   await screen.rerenderAsync(<MyComponent initialData="updated" />);
-  
+
   expect(screen.getByText('updated')).toBeOnTheScreen();
 });
 ```
@@ -96,7 +96,7 @@ This API requires RNTL v13.3.0 or later.
 function unmountAsync(): Promise<void>;
 ```
 
-Async version of `unmount` designed for working with React 19 and React Suspense. This method waits for async cleanup operations to complete during unmounting, making it suitable for components that have async cleanup behavior.
+Async version of `unmount` designed for working with React 19 and React Suspense. This method uses async `act` function internally to ensure all pending React updates are executed during unmounting.
 
 :::note