Allow a new Apollolink to be set after ApolloClient instantiation

Provides support for setting a new `ApolloLink` (or link chain)
after `new ApolloClient()` has been called, using a public
`ApolloClient.setLink()` method.

CHANGELOG.md

@@ -167,6 +167,9 @@
   [@durchanek](https://github.com/durchanek) in [#6194](https://github.com/apollographql/apollo-client/pull/6194) and [#6279](https://github.com/apollographql/apollo-client/pull/6279) <br/>
   [@hagmic](https://github.com/hagmic) in [#6328](https://github.com/apollographql/apollo-client/pull/6328)
 
+- Apollo Client now supports setting a new `ApolloLink` (or link chain) after `new ApolloClient()` has been called, using the `ApolloClient#setLink` method.  <br/>
+  [@hwillson](https://github.com/hwillson) in [#6193](https://github.com/apollographql/apollo-client/pull/6193)
+
 ### Bug Fixes
 
 - `useMutation` adjustments to help avoid an infinite loop / too many renders issue, caused by unintentionally modifying the `useState` based mutation result directly.  <br/>

src/ApolloClient.ts

@@ -553,4 +553,11 @@ export class ApolloClient<TCacheShape> implements DataProxy {
   public setLocalStateFragmentMatcher(fragmentMatcher: FragmentMatcher) {
     this.localState.setFragmentMatcher(fragmentMatcher);
   }
+
+  /**
+   * Define a new ApolloLink (or link chain) that Apollo Client will use.
+   */
+  public setLink(newLink: ApolloLink) {
+    this.link = this.queryManager.link = newLink;
+  }
 }

src/__tests__/ApolloClient.ts

@@ -2301,4 +2301,33 @@ describe('ApolloClient', () => {
       expect((client.cache as any).data.data).toEqual({});
     });
   });
+
+  describe('setLink', () => {
+    it('should override default link with newly set link', async () => {
+      const client = new ApolloClient({
+        cache: new InMemoryCache()
+      });
+      expect(client.link).toBeDefined();
+
+      const newLink = new ApolloLink(operation => {
+        return new Observable(observer => {
+          observer.next({
+            data: {
+              widgets: [
+                { name: 'Widget 1'},
+                { name: 'Widget 2' }
+              ]
+            }
+          });
+          observer.complete();
+        });
+      });
+
+      client.setLink(newLink);
+
+      const { data } = await client.query({ query: gql`{ widgets }` });
+      expect(data.widgets).toBeDefined();
+      expect(data.widgets.length).toBe(2);
+    });
+  });
 });