Feature: Support no-cache requests

lib/client.js

@@ -283,7 +283,10 @@ class Client extends EventEmitter {
       });
     }
 
-    if (this.cache && this.sentVersions) {
+    // Indicates whether to check the request cache or not
+    const isRequestCacheable = data?.$nocache === undefined;
+
+    if (this.cache && this.sentVersions && isRequestCacheable) {
       const cacheResult = this.cache.get(url, data);
       if (cacheResult?.$data !== undefined) {
         return new Promise((resolve) => {

lib/client.test.js

@@ -556,6 +556,7 @@ describe('Client', () => {
         client.authed = true;
         client.sentVersions = true;
 
+        // simulate a cache hit
         getCacheStub = jest
           .spyOn(Cache.prototype, 'get')
           .mockImplementation(() => {
@@ -586,6 +587,42 @@ describe('Client', () => {
         expect(response).toEqual(returnValue);
         expect(headers).toEqual({ $data: returnValue });
       });
+
+      it('returns the cached response on cache hit', async () => {
+        const result = await client.get('url', 'data');
+
+        expect(result).toEqual(returnValue);
+        expect(getCacheStub).toHaveBeenCalledTimes(1);
+        expect(getCacheStub).toHaveBeenCalledWith('url', 'data');
+        expect(requestStub).not.toHaveBeenCalled();
+      });
+
+      it('sends a request on cache miss', async () => {
+        // simulate a cache miss
+        getCacheStub.mockImplementationOnce(() => {
+          return null;
+        });
+
+        await client.get('url', 'data');
+
+        expect(getCacheStub).toHaveBeenCalledTimes(1);
+        expect(getCacheStub).toHaveBeenCalledWith('url', 'data');
+        expect(requestStub).toHaveBeenCalledTimes(1);
+        expect(requestStub).toHaveBeenCalledWith('get', 'url', 'data', undefined);
+      });
+
+      it('skips the cache if $nocache is specified', async () => {
+        await client.get('url', { $nocache: true });
+
+        expect(getCacheStub).not.toHaveBeenCalled();
+        expect(requestStub).toHaveBeenCalledTimes(1);
+        expect(requestStub).toHaveBeenCalledWith(
+          'get',
+          'url',
+          { $nocache: true },
+          undefined
+        );
+      });
     });
   });