Add support for skip option to useSuspenseQuery and `useBackgroun…

…dQuery` (#10940)

Co-authored-by: Alessia Bellisario <[email protected]>

.changeset/mean-tigers-thank.md

@@ -0,0 +1,5 @@
+---
+'@apollo/client': patch
+---
+
+Add support for the `skip` option in `useBackgroundQuery` and `useSuspenseQuery`. Setting this option to `true` will avoid a network request.

.prettierignore

@@ -17,7 +17,7 @@
 *.md
 
 # Do not format anything automatically except files listed below
-*
+/*
 
 !config/
 config/*

.size-limit.cjs

@@ -1,7 +1,7 @@
 const checks = [
   {
     path: "dist/apollo-client.min.cjs",
-    limit: "37479"
+    limit: "37700"
   },
   {
     path: "dist/main.cjs",

src/react/cache/QueryReference.ts

@@ -3,6 +3,7 @@ import type {
   ApolloQueryResult,
   ObservableQuery,
   OperationVariables,
+  WatchQueryOptions,
 } from '../../core';
 import { NetworkStatus, isNetworkRequestSettled } from '../../core';
 import type { ObservableSubscription } from '../../utilities';
@@ -86,6 +87,10 @@ export class QueryReference<TData = unknown> {
     );
   }
 
+  get watchQueryOptions() {
+    return this.observable.options;
+  }
+
   listen(listener: Listener<TData>) {
     // As soon as the component listens for updates, we know it has finished
     // suspending and is ready to receive updates, so we can remove the auto
@@ -117,6 +122,16 @@ export class QueryReference<TData = unknown> {
     return promise;
   }
 
+  reobserve(
+    watchQueryOptions: Partial<WatchQueryOptions<OperationVariables, TData>>
+  ) {
+    const promise = this.observable.reobserve(watchQueryOptions);
+
+    this.promise = promise;
+
+    return promise;
+  }
+
   dispose() {
     this.subscription.unsubscribe();
     this.onDispose();