feat(core): Reimplement fetch source as async generator

.changeset/real-donkeys-act.md

@@ -0,0 +1,7 @@
+---
+'@urql/core': patch
+---
+
+Replace fetch source implementation with async generator implementation, based on Wonka's `fromAsyncIterable`.
+This also further hardens our support for the "Incremental Delivery" specification and
+refactors its implementation and covers more edge cases.

exchanges/execute/src/execute.test.ts

@@ -196,6 +196,7 @@ describe('on operation', () => {
 
     fetchMock.mockResolvedValue({
       status: 200,
+      headers: { get: () => 'application/json' },
       text: vi
         .fn()
         .mockResolvedValue(JSON.stringify({ data: mockHttpResponseData })),

exchanges/graphcache/src/offlineExchange.test.ts

@@ -62,7 +62,11 @@ const storage = {
 
 describe('storage', () => {
   it('should read the metadata and dispatch operations on initialization', () => {
-    const client = createClient({ url: 'http://0.0.0.0' });
+    const client = createClient({
+      url: 'http://0.0.0.0',
+      exchanges: [],
+    });
+
     const reexecuteOperation = vi
       .spyOn(client, 'reexecuteOperation')
       .mockImplementation(() => undefined);
@@ -100,7 +104,11 @@ describe('offline', () => {
   it('should intercept errored mutations', () => {
     const onlineSpy = vi.spyOn(navigator, 'onLine', 'get');
 
-    const client = createClient({ url: 'http://0.0.0.0' });
+    const client = createClient({
+      url: 'http://0.0.0.0',
+      exchanges: [],
+    });
+
     const queryOp = client.createRequestOperation('query', {
       key: 1,
       query: queryOne,

exchanges/multipart-fetch/src/multipartFetchExchange.test.ts

@@ -1,5 +1,6 @@
-import { Client, OperationResult, makeOperation } from '@urql/core';
-import { empty, fromValue, pipe, Source, subscribe, toPromise } from 'wonka';
+import { Client, OperationResult } from '@urql/core';
+import { empty, fromValue, pipe, Source, toPromise } from 'wonka';
+
 import {
   vi,
   expect,
@@ -23,9 +24,6 @@ import {
 const fetch = (global as any).fetch as Mock;
 const abort = vi.fn();
 
-const abortError = new Error();
-abortError.name = 'AbortError';
-
 beforeAll(() => {
   (global as any).AbortController = function AbortController() {
     this.signal = undefined;
@@ -61,6 +59,7 @@ describe('on success', () => {
   beforeEach(() => {
     fetch.mockResolvedValue({
       status: 200,
+      headers: { get: () => 'application/json' },
       text: vi.fn().mockResolvedValue(response),
     });
   });
@@ -130,6 +129,7 @@ describe('on error', () => {
   beforeEach(() => {
     fetch.mockResolvedValue({
       status: 400,
+      headers: { get: () => 'application/json' },
       text: vi.fn().mockResolvedValue('{}'),
     });
   });
@@ -165,6 +165,7 @@ describe('on error', () => {
   it('ignores the error when a result is available', async () => {
     fetch.mockResolvedValue({
       status: 400,
+      headers: { get: () => 'application/json' },
       text: vi.fn().mockResolvedValue(response),
     });
 
@@ -177,52 +178,3 @@ describe('on error', () => {
     expect(data.data).toEqual(JSON.parse(response).data);
   });
 });
-
-describe('on teardown', () => {
-  const fail = () => {
-    expect(true).toEqual(false);
-  };
-
-  it('does not start the outgoing request on immediate teardowns', () => {
-    fetch.mockRejectedValueOnce(abortError);
-
-    const { unsubscribe } = pipe(
-      fromValue(queryOperation),
-      multipartFetchExchange(exchangeArgs),
-      subscribe(fail)
-    );
-
-    unsubscribe();
-    expect(fetch).toHaveBeenCalledTimes(0);
-    expect(abort).toHaveBeenCalledTimes(1);
-  });
-
-  it('aborts the outgoing request', async () => {
-    fetch.mockRejectedValueOnce(abortError);
-
-    const { unsubscribe } = pipe(
-      fromValue(queryOperation),
-      multipartFetchExchange(exchangeArgs),
-      subscribe(fail)
-    );
-
-    await Promise.resolve();
-
-    unsubscribe();
-    expect(fetch).toHaveBeenCalledTimes(1);
-    expect(abort).toHaveBeenCalledTimes(1);
-  });
-
-  it('does not call the query', () => {
-    pipe(
-      fromValue(
-        makeOperation('teardown', queryOperation, queryOperation.context)
-      ),
-      multipartFetchExchange(exchangeArgs),
-      subscribe(fail)
-    );
-
-    expect(fetch).toHaveBeenCalledTimes(0);
-    expect(abort).toHaveBeenCalledTimes(0);
-  });
-});

exchanges/persisted-fetch/src/persistedFetchExchange.test.ts

@@ -36,6 +36,8 @@ it('accepts successful persisted query responses', async () => {
   });
 
   fetch.mockResolvedValueOnce({
+    status: 200,
+    headers: { get: () => 'application/json' },
     text: () => Promise.resolve(expected),
   });
 
@@ -63,9 +65,13 @@ it('supports cache-miss persisted query errors', async () => {
 
   fetch
     .mockResolvedValueOnce({
+      status: 200,
+      headers: { get: () => 'application/json' },
       text: () => Promise.resolve(expectedMiss),
     })
     .mockResolvedValueOnce({
+      status: 200,
+      headers: { get: () => 'application/json' },
       text: () => Promise.resolve(expectedRetry),
     });
 
@@ -94,9 +100,13 @@ it('supports GET exclusively for persisted queries', async () => {
 
   fetch
     .mockResolvedValueOnce({
+      status: 200,
+      headers: { get: () => 'application/json' },
       text: () => Promise.resolve(expectedMiss),
     })
     .mockResolvedValueOnce({
+      status: 200,
+      headers: { get: () => 'application/json' },
       text: () => Promise.resolve(expectedRetry),
     });
 
@@ -127,12 +137,18 @@ it('supports unsupported persisted query errors', async () => {
 
   fetch
     .mockResolvedValueOnce({
+      status: 200,
+      headers: { get: () => 'application/json' },
       text: () => Promise.resolve(expectedMiss),
     })
     .mockResolvedValueOnce({
+      status: 200,
+      headers: { get: () => 'application/json' },
       text: () => Promise.resolve(expectedRetry),
     })
     .mockResolvedValueOnce({
+      status: 200,
+      headers: { get: () => 'application/json' },
       text: () => Promise.resolve(expectedRetry),
     });
 

packages/core/src/exchanges/fetch.test.ts

@@ -62,6 +62,7 @@ describe('on success', () => {
   beforeEach(() => {
     fetch.mockResolvedValue({
       status: 200,
+      headers: { get: () => 'application/json' },
       text: vi.fn().mockResolvedValue(response),
     });
   });
@@ -91,6 +92,7 @@ describe('on error', () => {
   beforeEach(() => {
     fetch.mockResolvedValue({
       status: 400,
+      headers: { get: () => 'application/json' },
       text: vi.fn().mockResolvedValue(JSON.stringify({})),
     });
   });
@@ -126,6 +128,7 @@ describe('on error', () => {
   it('ignores the error when a result is available', async () => {
     fetch.mockResolvedValue({
       status: 400,
+      headers: { get: () => 'application/json' },
       text: vi.fn().mockResolvedValue(response),
     });
 
@@ -143,8 +146,9 @@ describe('on teardown', () => {
   const fail = () => {
     expect(true).toEqual(false);
   };
+
   it('does not start the outgoing request on immediate teardowns', () => {
-    fetch.mockRejectedValueOnce(abortError);
+    fetch.mockResolvedValue(new Response('text', { status: 200 }));
 
     const { unsubscribe } = pipe(
       fromValue(queryOperation),
@@ -154,11 +158,11 @@ describe('on teardown', () => {
 
     unsubscribe();
     expect(fetch).toHaveBeenCalledTimes(0);
-    expect(abort).toHaveBeenCalledTimes(1);
+    expect(abort).toHaveBeenCalledTimes(0);
   });
 
   it('aborts the outgoing request', async () => {
-    fetch.mockRejectedValueOnce(abortError);
+    fetch.mockResolvedValue(new Response('text', { status: 200 }));
 
     const { unsubscribe } = pipe(
       fromValue(queryOperation),
@@ -169,11 +173,16 @@ describe('on teardown', () => {
     await Promise.resolve();
 
     unsubscribe();
+
+    // NOTE: We can only observe the async iterator's final run after a macro tick
+    await new Promise(resolve => setTimeout(resolve));
     expect(fetch).toHaveBeenCalledTimes(1);
-    expect(abort).toHaveBeenCalledTimes(1);
+    expect(abort).toHaveBeenCalled();
   });
 
   it('does not call the query', () => {
+    fetch.mockResolvedValue(new Response('text', { status: 200 }));
+
     pipe(
       fromValue(
         makeOperation('teardown', queryOperation, queryOperation.context)

packages/core/src/internal/__snapshots__/fetchSource.test.ts.snap

@@ -606,6 +606,9 @@ exports[`on success > uses the mock fetch if given 1`] = `
           {
             "type": "return",
             "value": {
+              "headers": {
+                "get": [Function],
+              },
               "status": 200,
               "text": [MockFunction spy] {
                 "calls": [

packages/core/src/internal/fetchSource.test.ts

@@ -19,9 +19,6 @@ import { makeOperation } from '../utils';
 const fetch = (global as any).fetch as Mock;
 const abort = vi.fn();
 
-const abortError = new Error();
-abortError.name = 'AbortError';
-
 beforeAll(() => {
   (global as any).AbortController = function AbortController() {
     this.signal = undefined;
@@ -51,6 +48,7 @@ describe('on success', () => {
   beforeEach(() => {
     fetch.mockResolvedValue({
       status: 200,
+      headers: { get: () => 'application/json' },
       text: vi.fn().mockResolvedValue(response),
     });
   });
@@ -73,6 +71,7 @@ describe('on success', () => {
     const fetchOptions = {};
     const fetcher = vi.fn().mockResolvedValue({
       status: 200,
+      headers: { get: () => 'application/json' },
       text: vi.fn().mockResolvedValue(response),
     });
 
@@ -102,6 +101,7 @@ describe('on error', () => {
     fetch.mockResolvedValue({
       status: 400,
       statusText: 'Forbidden',
+      headers: { get: () => 'application/json' },
       text: vi.fn().mockResolvedValue('{}'),
     });
   });
@@ -165,7 +165,7 @@ describe('on teardown', () => {
   };
 
   it('does not start the outgoing request on immediate teardowns', () => {
-    fetch.mockRejectedValue(abortError);
+    fetch.mockResolvedValue(new Response('text', { status: 200 }));
 
     const { unsubscribe } = pipe(
       makeFetchSource(queryOperation, 'https://test.com/graphql', {}),
@@ -174,20 +174,22 @@ describe('on teardown', () => {
 
     unsubscribe();
     expect(fetch).toHaveBeenCalledTimes(0);
-    expect(abort).toHaveBeenCalledTimes(1);
+    expect(abort).toHaveBeenCalledTimes(0);
   });
 
   it('aborts the outgoing request', async () => {
-    fetch.mockRejectedValue(abortError);
+    fetch.mockResolvedValue(new Response('text', { status: 200 }));
 
     const { unsubscribe } = pipe(
       makeFetchSource(queryOperation, 'https://test.com/graphql', {}),
       subscribe(fail)
     );
 
     await Promise.resolve();
-
     unsubscribe();
+
+    // NOTE: We can only observe the async iterator's final run after a macro tick
+    await new Promise(resolve => setTimeout(resolve));
     expect(fetch).toHaveBeenCalledTimes(1);
     expect(abort).toHaveBeenCalledTimes(1);
   });