Add list support to useFragment, useSuspenseFragment, and client.watchFragment

[jerelmiller]

Add support for lists with useFragment, useSuspenseFragment, and client.watchFragment.

const result = useFragment({
  fragment,
  from: [item1, item2]
});

console.log(result); // { data: [{...}, {...}], dataState: "complete", complete: true }

[changeset-bot]

🦋 Changeset detected

Latest commit: 1d0e27c

The changes in this PR will be included in the next version bump.

Not sure what this means? Click here to learn what changesets are.

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

[apollo-librarian]

✅ Docs preview ready

The preview is ready to be viewed. View the preview

File Changes

0 new, 10 changed, 0 removed

* (developer-tools)/react/(latest)/caching/cache-configuration.mdx
* (developer-tools)/react/(latest)/data/fragments.mdx
* (developer-tools)/react/(latest)/data/mutations.mdx
* (developer-tools)/react/(latest)/data/persisted-queries.mdx
* (developer-tools)/react/(latest)/data/queries.mdx
* (developer-tools)/react/(latest)/integrations/react-native.mdx
* (developer-tools)/react/(latest)/migrating/apollo-client-4-migration.mdx
* (developer-tools)/react/(latest)/performance/server-side-rendering.mdx
* (developer-tools)/react/(latest)/VERSIONING_POLICY.md
* (developer-tools)/react/(latest)/versioning-policy.md

Build ID: 8b14569e469e89d32b062239
Build Logs: View logs

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

[pkg-pr-new]

npm i https://pkg.pr.new/apollographql/apollo-client/@apollo/client@12971

commit: 1d0e27c

[phryneas]

Could we return something with a changeTargets property here? That way we wouldn't need to unwatch/rewatch 999 unrelated elements if one id changed.

[jerelmiller]

Yes! I was planning to do that next 🙂.

[jerelmiller]

This is now implemented with reobserve which will only watch new ids and keep ids that haven't changed around 🙂