feat(pmapi): add support to get path of current request in sandbox sc…

…ript

CHANGELOG.yaml

@@ -1,3 +1,7 @@
+unreleased:
+    new features:
+     - GH-950 Added support for pm.execution.location
+
 4.3.0:
   date: 2023-11-02
   new features:

lib/sandbox/execution-location.js

@@ -0,0 +1,17 @@
+class ExecutionClass extends Array {
+    /**
+     *
+     * @param {string} current - Current item name, current item is the item whose script is being executed
+     * @param  {string} rest - Arguments to pass to Array constructor
+     */
+    constructor (current, ...rest) {
+        super(...rest);
+        this._current = current;
+    }
+
+    get current () {
+        return this._current;
+    }
+}
+
+module.exports = ExecutionClass;

lib/sandbox/pmapi.js

@@ -6,6 +6,7 @@ const _ = require('lodash'),
     PostmanResponse = sdk.Response,
     PostmanCookieList = sdk.CookieList,
     chai = require('chai'),
+    ExecutionClass = require('./execution-location'),
 
     /**
      * Use this function to assign readonly properties to an object
@@ -269,7 +270,16 @@ function Postman (execution, onRequest, onSkipRequest, onAssertion, cookieStore,
              * @excludeFromTestScript
              * @instance
              */
-            skipRequest: onSkipRequest
+            skipRequest: onSkipRequest,
+
+            /**
+             * Complete Path of the current request being executed.
+             *
+             * @instance
+             * @type {Array<string>}
+             * @property {string} current - Name of the current item being executed.
+             */
+            location: new ExecutionClass(execution.legacy.currentItem, ...execution.legacy.requestPath)
         }
     }, options.disabledAPIs);
 

test/unit/sandbox-libraries/pm.test.js

@@ -1087,5 +1087,38 @@ describe('sandbox library - pm api', function () {
                 });
             });
         });
+        describe('.location', function () {
+            it('should return the correct path of the request', function (done) {
+                context.execute({
+                    script: `
+                        var assert = require('assert');
+                        assert.deepEqual(Array.from(pm.execution.location), ['C1', 'R1']);
+                    ` }, {
+                    legacy: {
+                        _itemName: 'request-name',
+                        _itemId: 'request-id',
+                        requestPath: ['C1', 'R1'],
+                        currentItem: 'R1'
+                    }
+                }, done);
+            });
+
+            describe('.current ', function () {
+                it('should return the correct current item', function (done) {
+                    context.execute({
+                        script: `
+                            var assert = require('assert');
+                            assert.deepEqual(pm.execution.location.current, 'R1');
+                        ` }, {
+                        legacy: {
+                            _itemName: 'request-name',
+                            _itemId: 'request-id',
+                            requestPath: ['C1', 'R1'],
+                            currentItem: 'R1'
+                        }
+                    }, done);
+                });
+            });
+        });
     });
 });

types/sandbox/prerequest.d.ts

@@ -1,4 +1,4 @@
-// Type definitions for postman-sandbox 4.2.8
+// Type definitions for postman-sandbox 4.3.0
 // Project: https://github.com/postmanlabs/postman-sandbox
 // Definitions by: PostmanLabs
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
@@ -112,6 +112,11 @@ declare interface Execution {
      * @excludeFromTestScript
      */
     skipRequest(): void;
+    /**
+     * Path of the current script being executed.
+     * @property current - Returns the current item name whose script is being executed
+     */
+    location: string[];
 }
 
 /**

types/sandbox/test.d.ts

@@ -1,4 +1,4 @@
-// Type definitions for postman-sandbox 4.2.8
+// Type definitions for postman-sandbox 4.3.0
 // Project: https://github.com/postmanlabs/postman-sandbox
 // Definitions by: PostmanLabs
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
@@ -113,6 +113,11 @@ declare interface Visualizer {
 }
 
 declare interface Execution {
+    /**
+     * Path of the current script being executed.
+     * @property current - Returns the current item name whose script is being executed
+     */
+    location: string[];
 }
 
 /**