docs: add guidance on testing suspense hooks with MockedProvider

[Copilot]

Components using useSuspenseQuery permanently hang in tests with MockedProvider unless render is wrapped in await act(). Unlike useQuery, suspense hooks suspend the component immediately — the test never advances without act to drive React through the suspend/resume cycle.

Changes

• docs/source/development-testing/testing.mdx — adds a "Testing with Suspense" section explaining the behavioral difference between useQuery and useSuspenseQuery in tests, with a full working example:

it("should render the greeting", async () => {
  await act(() =>
    render(
      <MockedProvider mocks={mocks}>
        <Suspense fallback={<div>Loading...</div>}>
          <Greeting />
        </Suspense>
      </MockedProvider>
    )
  );

  expect(await screen.findByText("Hello")).toBeInTheDocument();
});

Without await act(), the Suspense fallback renders and never resolves. This is not a MockLink bug — Apollo's SuspenseCache keeps the subscription alive; the missing piece is act to let React process the suspend/resume cycle.

[apollo-cla]

@copilot: Thank you for submitting a pull request! Before we can merge it, you'll need to sign the Apollo Contributor License Agreement here: https://contribute.apollographql.com/

[apollo-librarian]

✅ Docs preview ready

The preview is ready to be viewed. View the preview

File Changes

0 new, 1 changed, 0 removed

* (developer-tools)/react/(latest)/development-testing/testing.mdx

Build ID: c25e1f72d733e716f5692547
Build Logs: View logs

URL: https://www.apollographql.com/docs/deploy-preview/c25e1f72d733e716f5692547

---

⚠️ AI Style Review — 2 Issues Found

Summary

The documentation has been updated to align with the style guide across three key sections. Under structural elements, headings were updated to sentence case, specifically treating 'suspense' as a common noun. For framing Apollo products, the narrative was shifted to emphasize the benefits of the suspense approach over the limitations of previous methods. Finally, language was improved for global accessibility by replacing the idiom 'in flight' with clearer terms like 'active' or 'processing'.

Duration: 3749ms
Review Log: View detailed log

This review is AI-generated. Please use common sense when accepting these suggestions, as they may not always be accurate or appropriate for your specific context.

[changeset-bot]

⚠️ No Changeset found

Latest commit: b318a37

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[pkg-pr-new]

npm i https://pkg.pr.new/@apollo/client@13291

commit: b318a37