Fix typos (#12972)

kianmeng · web-flow · commit 0340d842398d · 2025-10-14T12:02:45.000-06:00
Found via `codespell -S
*.yaml,codegen,node_modules,patches,package-lock.json,CHANGELOG.md -L
afterall,juli,anad,shepard`
diff --git a/ROADMAP.md b/ROADMAP.md
@@ -30,7 +30,7 @@ For up to date release notes, refer to the project's [Changelog](https://github.
 - New documentation
 - Subscription support
 
-_These changes will take longer than anticipated due to prioritization of other libaries and integrations_
+_These changes will take longer than anticipated due to prioritization of other libraries and integrations_
 
 ### VSCode Extension
 
diff --git a/VERSIONING_POLICY.md b/VERSIONING_POLICY.md
@@ -90,4 +90,4 @@ We reserve the right to update dependencies in minor releases of Apollo Client,
 ### Peer dependencies
 
 The rules stated above apply to peer dependencies as well. Peer dependencies can be updated in minor releases, just like regular dependencies.
-However, we do commit to not adding new peer depenencies during the lifetime of a major - but if an existing peer dependency is renamed, we might follow that rename in a minor release.
+However, we do commit to not adding new peer dependencies during the lifetime of a major - but if an existing peer dependency is renamed, we might follow that rename in a minor release.
diff --git a/docs/source/caching/cache-configuration.mdx b/docs/source/caching/cache-configuration.mdx
@@ -192,7 +192,7 @@ This example shows a variety of `typePolicies` with different `keyFields`:
     ```
 - The `AllProducts` type illustrates a special strategy for a **singleton** type. If the cache will only ever contain one `AllProducts` object and that object has _no_ identifying fields, you can provide an empty array for its `keyFields`.
 - The `Store` type provides an example of how you can [disable normalization](https://www.apollographql.com/docs/react/caching/cache-configuration/#disabling-normalization) by setting the keyFields to `false`
-- The `Location` type provides an example of using custom fuction given object and runtime context to calculate what fields should be used for the key field selection.
+- The `Location` type provides an example of using custom function given object and runtime context to calculate what fields should be used for the key field selection.
   - Keep in mind that the first argument here is a reference to the record that will be written. As such, it does NOT include subselected fields, only scalar fields, and it contains aliases from the operation. If you need to read the real type you can use `context.storeObject`. To read even more indepth about how this function can work the best source will be our own [test cases for the cache policies](https://github.com/apollographql/apollo-client/blob/8bc7d4d406402962bf5151cdd2c5c75c9398d10c/src/cache/inmemory/__tests__/policies.ts#L5543-L5622)
 
 If an object has multiple `keyFields`, the cache ID always lists those fields in the same order to ensure uniqueness.
diff --git a/docs/source/data/fragments.mdx b/docs/source/data/fragments.mdx
@@ -244,7 +244,7 @@ We then import our shared fragment registry into our component file and register
   You need to register fragment definitions with the fragment registry before
   executing operations that use them. This can be problematic when lazy loading
   component files because the application might not register the fragment
-  definition with the registery until after the query begins executing. Move the
+  definition with the registry until after the query begins executing. Move the
   fragment definition to a shared file that isn't lazy-loaded.
 </Caution>
 
@@ -1488,7 +1488,7 @@ npx jscodeshift ... --tag myGql
   Comments in GraphQL documents may be lost after running the codemod because
   the `graphql` library's `print` function used by the codemod doesn't retain
   comments. Always check the output from changes made by the codemod before
-  comitting them.
+  committing them.
 </Caution>
 
 #### 2. Enable `dataMasking`
diff --git a/docs/source/data/persisted-queries.mdx b/docs/source/data/persisted-queries.mdx
@@ -214,7 +214,7 @@ const client = new ApolloClient({
 });
 ```
 
-Thats it! By including the persisted queries link in your client instantiation, your client sends operation IDs instead of the full operation string. This results in improved network performance, but doesn't include the security benefits of operation safelisting that [persisted queries](#differences-between-persisted-queries-and-apq) provide.
+That's it! By including the persisted queries link in your client instantiation, your client sends operation IDs instead of the full operation string. This results in improved network performance, but doesn't include the security benefits of operation safelisting that [persisted queries](#differences-between-persisted-queries-and-apq) provide.
 
 For more details on the options available to `PersistedQueryLink`, see its [API reference documentation](../api/link/persisted-queries).
 
diff --git a/docs/source/integrations/react-native.mdx b/docs/source/integrations/react-native.mdx
@@ -65,7 +65,7 @@ A community plugin called [React Native Apollo devtools](https://github.com/razo
 
 1.  Install Flipper and open it.
 2.  Go to add plugin and search for `react-native-apollo-devtools` and install it
-3.  Add `react-native-flipper` and `react-native-apollo-devtools-client` as dev dependecy to react native app.
+3.  Add `react-native-flipper` and `react-native-apollo-devtools-client` as dev dependency to react native app.
 4.  Initialize the plugin with flipper on client side
 
     ```ts
diff --git a/docs/source/performance/server-side-rendering.mdx b/docs/source/performance/server-side-rendering.mdx
@@ -202,7 +202,7 @@ prerenderStatic({
       ).replace(/</g, "\\u003c")}`,
       bootstrapScripts: ["/client.js"],
       onShellReady() {
-        // Start streaming the reponse to the browser
+        // Start streaming the response to the browser
         res.setHeader("Content-Type", "text/html");
         res.statusCode = 200;
         pipe(res);
diff --git a/scripts/codemods/ac3-to-ac4/README.md b/scripts/codemods/ac3-to-ac4/README.md
@@ -18,7 +18,7 @@ In the order they will be applied per default if you don't manually specify a co
 
 - `legacyEntryPoints`: Moves imports from old legacy entry points like `@apollo/client/main.cjs` or `@apollo/client/react/react.cjs` to the new entry points like `@apollo/client` or `@apollo/client/react`.
 - `imports`: Moves imports that have been moved or renamed in Apollo Client 4. Also moves types into namespace imports where applicable.
-- `links`: Moves `split`, `from`, `concat` and `empty` onto the `ApolloLink` namespace, changes funtion link invocations like `createHttpLink(...)` to their class equivalents like (`new HttpLink(...)`).
+- `links`: Moves `split`, `from`, `concat` and `empty` onto the `ApolloLink` namespace, changes function link invocations like `createHttpLink(...)` to their class equivalents like (`new HttpLink(...)`).
   Does not change `setContext((operation, prevContext) => {})` to `new ContextLink((prevContext, operation) => {})` - this requires manual intervention, as the order of callback arguments is flipped and this is not reliable codemoddable.
 - `removals`: Points all imports of values or types that have been removed in Apollo Client 4 to the `@apollo/client/v4-migration` entry point. That entry point contains context for each removal, oftentimes with migration instructions.
 - `clientSetup`: Applies the following steps from the migration guide to your Apollo Client setup code
@@ -33,7 +33,7 @@ In the order they will be applied per default if you don't manually specify a co
 
 ### Usage against TypeScript/TSX
 
-There is some syntax overlap between TypeScript and TypeScript-JSX files, so you might need to run the Codemod against both file extensions sepearately to avoid errors:
+There is some syntax overlap between TypeScript and TypeScript-JSX files, so you might need to run the Codemod against both file extensions separately to avoid errors:
 
 ```sh
 npx @apollo/client-codemod-migrate-3-to-4 --parser ts --ignore-pattern="*.{tsx,d.ts}" file1.ts file2.ts
diff --git a/scripts/codemods/ac3-to-ac4/src/__tests__/apolloClientInitialization.test.ts b/scripts/codemods/ac3-to-ac4/src/__tests__/apolloClientInitialization.test.ts
@@ -310,7 +310,7 @@ export const dontTouchThis: ApolloClient<MyCacheShape> = new ApolloClient<MyCach
   });
 });
 
-describe("http link intialization", () => {
+describe("http link initialization", () => {
   test("all options", () => {
     expect(
       transform("explicitLinkConstruction")`
diff --git a/scripts/codemods/ac3-to-ac4/src/__tests__/imports.test.ts b/scripts/codemods/ac3-to-ac4/src/__tests__/imports.test.ts
@@ -17,7 +17,7 @@ describe("aliases if `legacyEntryPoints` transform was not applied", () => {
       `"import { somethingElse, useQuery } from "@apollo/client/react/react.cjs";"`
     );
   });
-  test("if nonexistant, creates new modern entry points", () => {
+  test("if nonexistent, creates new modern entry points", () => {
     expect(
       transform`
     import { useQuery } from "@apollo/client/index.js";
diff --git a/src/__tests__/client.ts b/src/__tests__/client.ts
@@ -6083,7 +6083,7 @@ describe("custom document transforms", () => {
     });
   });
 
-  it("runs custom document transforms with fragments defined in the fragment registery", async () => {
+  it("runs custom document transforms with fragments defined in the fragment registry", async () => {
     const query = gql`
       query TestQuery {
         product {
@@ -6155,7 +6155,7 @@ describe("custom document transforms", () => {
     });
   });
 
-  it("runs custom document transforms on fragments that override registered fragments in the fragment registery", async () => {
+  it("runs custom document transforms on fragments that override registered fragments in the fragment registry", async () => {
     const query = gql`
       query TestQuery {
         product {
diff --git a/src/__tests__/dataMasking.ts b/src/__tests__/dataMasking.ts
@@ -2139,7 +2139,7 @@ describe("client.watchQuery", () => {
     );
 
     // Even though `data` didn't change, the `dataState` is updated to reflect
-    // that the full result has been stremed in so we expect another render
+    // that the full result has been streamed in so we expect another render
     // value.
     await expect(stream).toEmitTypedValue({
       data: {
diff --git a/src/__tests__/local-state/export.ts b/src/__tests__/local-state/export.ts
@@ -123,7 +123,7 @@ describe("@client @export tests", () => {
     });
   });
 
-  test("should store the @client nested field value in the specified @export variable, and make it avilable to a subsequent resolver", async () => {
+  test("should store the @client nested field value in the specified @export variable, and make it available to a subsequent resolver", async () => {
     const query = gql`
       query currentAuthorPostCount($authorId: Int!) {
         currentAuthor @client {
diff --git a/src/__tests__/subscribeToMore.ts b/src/__tests__/subscribeToMore.ts
@@ -43,11 +43,11 @@ describe("subscribeToMore", () => {
 
   const results2 = [
     { result: { data: { name: "Amanda Liu" } }, delay: 10 },
-    { error: new Error("You cant touch this"), delay: 10 },
+    { error: new Error("You can't touch this"), delay: 10 },
   ];
 
   const results3 = [
-    { error: new Error("You cant touch this"), delay: 10 },
+    { error: new Error("You can't touch this"), delay: 10 },
     { result: { data: { name: "Amanda Liu" } }, delay: 10 },
   ];
 
@@ -185,7 +185,7 @@ describe("subscribeToMore", () => {
     await wait(15);
 
     expect(onError).toHaveBeenCalledTimes(1);
-    expect(onError).toHaveBeenCalledWith(new Error("You cant touch this"));
+    expect(onError).toHaveBeenCalledWith(new Error("You can't touch this"));
   });
 
   it("prints unhandled subscription errors to the console", async () => {
@@ -241,7 +241,7 @@ describe("subscribeToMore", () => {
     expect(console.error).toHaveBeenCalledTimes(1);
     expect(console.error).toHaveBeenCalledWith(
       "Unhandled GraphQL subscription error",
-      new Error("You cant touch this")
+      new Error("You can't touch this")
     );
 
     await expect(stream).not.toEmitAnything();
diff --git a/src/cache/inmemory/__tests__/__snapshots__/writeToStore.ts.snap b/src/cache/inmemory/__tests__/__snapshots__/writeToStore.ts.snap
@@ -262,7 +262,7 @@ Object {
 }
 `;
 
-exports[`writing to the store writeResultToStore shape checking should not warn if a field is defered 1`] = `[MockFunction]`;
+exports[`writing to the store writeResultToStore shape checking should not warn if a field is deferred 1`] = `[MockFunction]`;
 
 exports[`writing to the store writeResultToStore shape checking should warn when it receives the wrong data inside a fragment 1`] = `
 [MockFunction] {
diff --git a/src/cache/inmemory/__tests__/policies.ts b/src/cache/inmemory/__tests__/policies.ts
@@ -6156,7 +6156,7 @@ describe("type policies", function () {
             currentTask: {
               merge(existing, incoming) {
                 // Not a very reasonable merge strategy, but returning
-                // existing here triggers issue #6245, persumably because
+                // existing here triggers issue #6245, presumably because
                 // the existing data is frozen.
                 return existing || incoming;
               },
diff --git a/src/cache/inmemory/__tests__/writeToStore.ts b/src/cache/inmemory/__tests__/writeToStore.ts
@@ -2288,9 +2288,9 @@ describe("writing to the store", () => {
       });
     });
 
-    it("should not warn if a field is defered", () => {
+    it("should not warn if a field is deferred", () => {
       using _consoleSpy = spyOnConsole.takeSnapshots("error");
-      const defered = gql`
+      const deferred = gql`
         query LazyLoad {
           id
           expensive @defer
@@ -2308,7 +2308,7 @@ describe("writing to the store", () => {
 
       const newStore = writeQueryToStore({
         writer,
-        query: defered,
+        query: deferred,
         result,
       });
 
diff --git a/src/cache/inmemory/fragmentRegistry.ts b/src/cache/inmemory/fragmentRegistry.ts
@@ -90,7 +90,7 @@ class FragmentRegistry implements FragmentRegistryAPI {
 
   /*
    * Note:
-   * This method is only memoized so it can serve as a dependency to `tranform`,
+   * This method is only memoized so it can serve as a dependency to `transform`,
    * so calling `invalidate` will invalidate cache entries for `transform`.
    */
   public lookup(fragmentName: string): FragmentDefinitionNode | null {
diff --git a/src/core/ObservableQuery.ts b/src/core/ObservableQuery.ts
@@ -251,7 +251,7 @@ export declare namespace ObservableQuery {
    */
   interface ResultPromise<T> extends Promise<T> {
     /**
-     * Kepp the network operation running until it is finished, even if
+     * Keep the network operation running until it is finished, even if
      * `ObservableQuery` unsubscribed from the operation.
      */
     retain(): this;
@@ -651,7 +651,7 @@ export class ObservableQuery<
           // not be notified about future cache changes with an equal `diff`.
           // That would be the case if we are working with client-only fields
           // that are forced or with `exports` fields that might change, causing
-          // local resovlers to return a new result.
+          // local resolvers to return a new result.
           // This is based on an implementation detail of `InMemoryCache`, which
           // is not optimal - but the only alternative to this would be to
           // resubscribe to the cache asynchonouly, which would bear the risk of
@@ -1564,7 +1564,7 @@ Did you mean to call refetch(variables) instead of refetch({ variables })?`,
           .then((result) => toQueryResult(this.maskResult(result)))
           .finally(() => {
             if (!this.hasObservers() && this.activeOperations.size === 0) {
-              // If `reobserve` was called on a query without any obervers,
+              // If `reobserve` was called on a query without any observers,
               // the teardown logic would never be called, so we need to
               // call it here to ensure the query is properly torn down.
               this.tearDownQuery();
@@ -1678,7 +1678,7 @@ Did you mean to call refetch(variables) instead of refetch({ variables })?`,
     ) {
       const diff = this.getCacheDiff();
       if (
-        // `fromOptimisticTransaction` is not avaiable through the `cache.diff`
+        // `fromOptimisticTransaction` is not available through the `cache.diff`
         // code path, so we need to check it this way
         equal(diff.result, this.getCacheDiff({ optimistic: false }).result)
       ) {
diff --git a/src/core/QueryManager.ts b/src/core/QueryManager.ts
@@ -1077,7 +1077,7 @@ export class QueryManager {
             }),
         } as ObservableQuery.Result<TData>;
 
-        // In the case we start multiple network requests simulatenously, we
+        // In the case we start multiple network requests simultaneously, we
         // want to ensure we properly set `data` if we're reporting on an old
         // result which will not be caught by the conditional above that ends up
         // throwing the markError result.
diff --git a/src/core/__tests__/ApolloClient/general.test.ts b/src/core/__tests__/ApolloClient/general.test.ts
@@ -2493,7 +2493,7 @@ describe("ApolloClient", () => {
         },
         {
           request: { query },
-          error: new Error("Network error ocurred"),
+          error: new Error("Network error occurred"),
         },
       ]),
     });
diff --git a/src/core/__tests__/ApolloClient/multiple-results.test.ts b/src/core/__tests__/ApolloClient/multiple-results.test.ts
@@ -7,7 +7,7 @@ import { Defer20220824Handler } from "@apollo/client/incremental";
 import { MockSubscriptionLink } from "@apollo/client/testing";
 import { ObservableStream, wait } from "@apollo/client/testing/internal";
 
-describe("mutiple results", () => {
+describe("multiple results", () => {
   it("allows multiple query results from link", async () => {
     const query = gql`
       query LazyLoadLuke {
diff --git a/src/core/__tests__/ObservableQuery.ts b/src/core/__tests__/ObservableQuery.ts
@@ -7731,7 +7731,7 @@ describe.skip("type tests", () => {
     });
   });
 
-  test("variables with optional variales", () => {
+  test("variables with optional variables", () => {
     const query: TypedDocumentNode<{ posts: string[] }, { limit?: number }> =
       gql``;
     const client = new ApolloClient({
@@ -7803,7 +7803,7 @@ describe.skip("type tests", () => {
     });
   });
 
-  test("variables with required variales", () => {
+  test("variables with required variables", () => {
     const query: TypedDocumentNode<{ character: string }, { id: string }> =
       gql``;
     const client = new ApolloClient({
diff --git a/src/core/__tests__/fetchPolicies.ts b/src/core/__tests__/fetchPolicies.ts
@@ -1392,7 +1392,7 @@ describe("nextFetchPolicy", () => {
         },
       });
 
-      // The nextFetchPolicy function we provided always returnes cache-first,
+      // The nextFetchPolicy function we provided always returns cache-first,
       // even when context.reason is variables-changed (which by default
       // resets the fetchPolicy to context.initialFetchPolicy), so cache-first is
       // still what we see here.
diff --git a/src/dev/setErrorMessageHandler.ts b/src/dev/setErrorMessageHandler.ts
@@ -22,7 +22,7 @@ export type ErrorMessageHandler = {
    *
    * ⚠️ Note that arguments will only be passed in for error messages.
    * For normal log messages, you will get an empty array here and they will directly
-   * be passed to `console.log` instead, to have the string subsitution done by the
+   * be passed to `console.log` instead, to have the string substitution done by the
    * engine, as that allows for nicer (and in the case of a browser, interactive)
    * output.
    *
diff --git a/src/link/core/__tests__/ApolloLink.ts b/src/link/core/__tests__/ApolloLink.ts
@@ -72,15 +72,15 @@ describe("ApolloLink", () => {
       const returnOne = new SetContextLink(setContext);
       const mock = new ApolloLink((op, forward) => {
         op.setContext({ add: 3 });
-        op.setContext({ substract: 1 });
+        op.setContext({ subtract: 1 });
 
         return forward(op);
       });
       const link = returnOne.concat(mock).concat(
         new ApolloLink((op) => {
           expect(op.getContext()).toEqual({
             add: 3,
-            substract: 1,
+            subtract: 1,
           });
           return of({ data: { count: op.getContext().add } });
         })
diff --git a/src/link/error/__tests__/index.ts b/src/link/error/__tests__/index.ts
@@ -486,7 +486,7 @@ describe("error handling", () => {
     await expect(stream).toComplete();
   });
 
-  it("can be unsubcribed", async () => {
+  it("can be unsubscribed", async () => {
     const query = gql`
       {
         foo {
@@ -763,7 +763,7 @@ describe("error handling with class", () => {
     expect(callback).not.toHaveBeenCalled();
   });
 
-  it("can be unsubcribed", async () => {
+  it("can be unsubscribed", async () => {
     const query = gql`
       {
         foo {
diff --git a/src/link/http/__tests__/parseAndCheckHttpResponse.ts b/src/link/http/__tests__/parseAndCheckHttpResponse.ts
@@ -70,7 +70,7 @@ describe("parseAndCheckResponse", () => {
   });
 
   it("throws a server error on incorrect data", async () => {
-    const data = { hello: "world" }; //does not contain data or erros
+    const data = { hello: "world" }; //does not contain data or errors
     fetchMock.mock("begin:/incorrect", data);
     const error = await fetch("incorrect")
       .then(parseAndCheckHttpResponse(operations))
diff --git a/src/masking/internal/types.ts b/src/masking/internal/types.ts
@@ -182,7 +182,7 @@ type MergeObjects<T, U> = Prettify<
   } & Pick<U, Exclude<keyof U, keyof T>>
 >;
 
-// force distrubution when T is a union with | undefined
+// force distribution when T is a union with | undefined
 export type RemoveFragmentName<T> =
   T extends any ? Omit<T, " $fragmentName"> : T;
 
diff --git a/src/masking/maskDefinition.ts b/src/masking/maskDefinition.ts
@@ -86,7 +86,7 @@ function maskSelectionSet(
   for (const selection of selectionSet.selections) {
     let value: any;
 
-    // we later want to add acessor warnings to the final result
+    // we later want to add accessor warnings to the final result
     // so we need a new object to add the accessor warning to
     if (migration) {
       knownChanged.add(memo);
diff --git a/src/react/hooks/__tests__/useBackgroundQuery.test.tsx b/src/react/hooks/__tests__/useBackgroundQuery.test.tsx
@@ -3844,7 +3844,7 @@ it('does not suspend deferred queries with partial data in the cache and using a
   const link = new MockSubscriptionLink();
   const cache = new InMemoryCache();
 
-  // We are intentionally writing partial data to the cache. Supress console
+  // We are intentionally writing partial data to the cache. Suppress console
   // warnings to avoid unnecessary noise in the test.
   {
     using _consoleSpy = spyOnConsole("error");
diff --git a/src/react/hooks/__tests__/useFragment.test.tsx b/src/react/hooks/__tests__/useFragment.test.tsx
diff --git a/src/react/hooks/__tests__/useLoadableQuery.test.tsx b/src/react/hooks/__tests__/useLoadableQuery.test.tsx
diff --git a/src/react/hooks/__tests__/useMutation.test.tsx b/src/react/hooks/__tests__/useMutation.test.tsx
diff --git a/src/react/hooks/__tests__/useSuspenseQuery.test.tsx b/src/react/hooks/__tests__/useSuspenseQuery.test.tsx
diff --git a/src/react/hooks/internal/useRenderGuard.ts b/src/react/hooks/internal/useRenderGuard.ts
diff --git a/src/react/hooks/useFragment.ts b/src/react/hooks/useFragment.ts
diff --git a/src/react/hooks/useSyncExternalStore.ts b/src/react/hooks/useSyncExternalStore.ts
diff --git a/src/react/internal/cache/QueryReference.ts b/src/react/internal/cache/QueryReference.ts
diff --git a/src/react/types/types.documentation.ts b/src/react/types/types.documentation.ts
diff --git a/src/testing/core/mocking/mockLink.ts b/src/testing/core/mocking/mockLink.ts
diff --git a/src/testing/matchers/index.d.ts b/src/testing/matchers/index.d.ts
diff --git a/src/testing/matchers/toEmitError.ts b/src/testing/matchers/toEmitError.ts
diff --git a/src/utilities/internal/getMemoryInternals.ts b/src/utilities/internal/getMemoryInternals.ts
