Allow configuring follow redirects count

package.json

@@ -62,7 +62,7 @@
     "openapi-fuzzer-core": "^1.0.6",
     "pactum-matchers": "^1.1.7",
     "parse-graphql": "^1.0.0",
-    "phin": "^3.7.0",
+    "phin": "^3.7.1",
     "polka": "^0.5.2"
   },
   "devDependencies": {

src/config.js

@@ -13,7 +13,10 @@ const config = {
     baseUrl: process.env.PACTUM_REQUEST_BASE_URL || '',
     timeout: process.env.PACTUM_REQUEST_TIMEOUT ? parseInt(process.env.PACTUM_REQUEST_TIMEOUT) : 3000,
     headers: {},
-    followRedirects: false,
+    followRedirects: {
+      enabled: false,
+      count: 20
+    },
     retry: {
       count: 1,
       delay: 1000

src/exports/request.d.ts

@@ -23,7 +23,8 @@ export function setBaseUrl(url: string): void;
 /**
  * sets default value for follow redirects
  */
-export function setFollowRedirects(follow: boolean): void;
+export function setDefaultFollowRedirects(follow: boolean): void;
+export function setDefaultFollowRedirects(follow: number): void;
 
 /**
  * removes all or selective default headers

src/exports/request.js

@@ -43,7 +43,13 @@ const request = {
   },
 
   setDefaultFollowRedirects(follow) {
-    config.request.followRedirects = follow;
+    if (typeof follow !== 'number' && typeof follow !== 'boolean') {
+      throw new PactumRequestError(`Invalid follow redirect option - ${follow}, allowed boolean/number`);
+    }
+    if (typeof follow == 'number' && follow >=0 ) {
+      config.request.followRedirects.count = follow;
+    }
+    config.request.followRedirects.enabled = follow;
   },
 
   removeDefaultHeaders(key) {

src/helpers/requestProcessor.js

@@ -153,8 +153,8 @@ function setMultiPartFormData(request) {
 }
 
 function setFollowRedirects(request) {
-  if (config.request.followRedirects && typeof request.followRedirects === 'undefined') {
-    request.followRedirects = config.request.followRedirects;
+  if (config.request.followRedirects.enabled && typeof request.followRedirects === 'undefined') {
+    request.followRedirects = config.request.followRedirects.count;
   }
 }
 

src/models/Spec.d.ts

@@ -217,7 +217,7 @@ declare class Spec {
    * @see https://pactumjs.github.io/api/requests/withFollowRedirects.html
    */
   withFollowRedirects(follow: boolean): Spec;
-
+  withFollowRedirects(follow: number): Spec;
   /**
    * enables compression
    * @see https://pactumjs.github.io/api/requests/withCompression.html

src/models/Spec.js

@@ -321,8 +321,15 @@ class Spec {
   }
 
   withFollowRedirects(follow) {
+    if (typeof follow !== 'number' && typeof follow !== 'boolean') {
+      throw new PactumRequestError('Follow redirects should be number or boolean');
+    }
+    if (typeof follow == 'number' && follow >=0 ) {
+      this._request.followRedirects = follow;
+      return this;
+    }
     this._request.followRedirects = follow;
-    return this;
+    return this;   
   }
 
   withCompression() {

test/component/interactions.mock.spec.js

@@ -498,7 +498,7 @@ describe('Interactions - Not Strict - Wait', () => {
 
 describe('Interactions - Not Strict - Follow Redirects', () => {
 
-  it('with Follow Redirects', async () => {
+  it('with Follow Redirects - boolean config', async () => {
     await pactum.spec()
       .useInteraction({
         strict: false,
@@ -528,6 +528,75 @@ describe('Interactions - Not Strict - Follow Redirects', () => {
       .expectStatus(200);
   });
 
+  it('with Follow Redirects - count config', async () => {
+    await pactum.spec()
+      .useInteraction({
+        strict: false,
+        request: {
+          method: 'GET',
+          path: '/mock/redirect'
+        },
+        response: {
+          status: 301,
+          headers: {
+            'location': 'http://localhost:9393/mock/intermediate/1'
+          }
+        }
+      })
+      .useInteraction({
+        strict: false,
+        request: {
+          method: 'GET',
+          path: '/mock/intermediate/1'
+        },
+        response: {
+          status: 301,
+          headers: {
+            'location': 'http://localhost:9393/mock/intermediate/2'
+          }
+        }
+      })
+      .useInteraction({
+        strict: false,
+        request: {
+          method: 'GET',
+          path: '/mock/intermediate/2'
+        },
+        response: {
+          status: 301,
+          headers: {
+            'location': 'http://localhost:9393/mock/intermediate/3'
+          }
+        }
+      })
+      .useInteraction({
+        strict: false,
+        request: {
+          method: 'GET',
+          path: '/mock/intermediate/3'
+        },
+        response: {
+          status: 301,
+          headers: {
+            'location': 'http://localhost:9393/mock/actual'
+          }
+        }
+      })
+      .useInteraction({
+        strict: false,
+        request: {
+          method: 'GET',
+          path: '/mock/actual'
+        },
+        response: {
+          status: 200
+        }
+      })
+      .get('http://localhost:9393/mock/redirect')
+      .withFollowRedirects(4)
+      .expectStatus(200);
+  });
+
   it('without Follow Redirects', async () => {
     await pactum.spec()
       .useInteraction({
@@ -597,6 +666,36 @@ describe('Interactions - Not Strict - Follow Redirects', () => {
       .expectStatus(200);
   });
 
+  it('with default Follow Redirects - count config', async () => {
+    pactum.request.setDefaultFollowRedirects(1);
+    await pactum.spec()
+      .useInteraction({
+        strict: false,
+        request: {
+          method: 'GET',
+          path: '/mock/redirect'
+        },
+        response: {
+          status: 301,
+          headers: {
+            'location': 'http://localhost:9393/mock/actual'
+          }
+        }
+      })
+      .useInteraction({
+        strict: false,
+        request: {
+          method: 'GET',
+          path: '/mock/actual'
+        },
+        response: {
+          status: 200
+        }
+      })
+      .get('http://localhost:9393/mock/redirect')
+      .expectStatus(200);
+  });
+
   it('with Follow Redirects as false & default as true', async () => {
     pactum.request.setDefaultFollowRedirects(true);
     await pactum.spec()
@@ -618,6 +717,57 @@ describe('Interactions - Not Strict - Follow Redirects', () => {
       .expectStatus(301);
   });
 
+  it('with Follow Redirects as 0 & default as 1', async () => {
+    pactum.request.setDefaultFollowRedirects(1);
+    await pactum.spec()
+      .useInteraction({
+        strict: false,
+        request: {
+          method: 'GET',
+          path: '/mock/redirect'
+        },
+        response: {
+          status: 301,
+          headers: {
+            'location': 'http://localhost:9393/mock/actual'
+          }
+        }
+      })
+      .get('http://localhost:9393/mock/redirect')
+      .withFollowRedirects(0)
+      .expectStatus(301);
+  });
+
+  it('with Follow Redirects as 1 & default as 0', async () => {
+    pactum.request.setDefaultFollowRedirects(0);
+    await pactum.spec()
+      .useInteraction({
+        strict: false,
+        request: {
+          method: 'GET',
+          path: '/mock/redirect'
+        },
+        response: {
+          status: 301,
+          headers: {
+            'location': 'http://localhost:9393/mock/actual'
+          }
+        }
+      })
+      .useInteraction({
+        strict: false,
+        request: {
+          method: 'GET',
+          path: '/mock/actual'
+        },
+        response: {
+          status: 200
+        }
+      })
+      .get('http://localhost:9393/mock/redirect')
+      .withFollowRedirects(1)
+      .expectStatus(200);
+  });
 
   afterEach(() => {
     pactum.request.setDefaultFollowRedirects(false);