Why Local variables in Postman? - Purpose & Use Cases

The Big Idea

What if you could fix your test mistakes by changing just one place instead of many?

The Scenario

Imagine testing an API where you have to reuse the same data multiple times in different requests. You write the data again and again in each request manually.

The Problem

This manual way is slow and tiring. You might mistype data or forget to update it everywhere. It's easy to make mistakes and hard to keep track of changes.

The Solution

Local variables let you store data once and use it many times within a single request or script. This keeps your tests clean, easy to update, and less error-prone.

Before vs After

✗ Before

pm.sendRequest({ url: 'https://api.example.com/user/123', method: 'GET' });
pm.sendRequest({ url: 'https://api.example.com/user/123/orders', method: 'GET' });

✓ After

let userId = '123';
pm.sendRequest({ url: `https://api.example.com/user/${userId}`, method: 'GET' });
pm.sendRequest({ url: `https://api.example.com/user/${userId}/orders`, method: 'GET' });

What It Enables

Local variables make your tests faster to write, easier to read, and simpler to maintain.

Real Life Example

When testing a login flow, you can save the user token in a local variable and reuse it for all following requests without copying it each time.

Key Takeaways

Manual repetition of data is slow and error-prone.

Local variables store data once for reuse in the same request or script.

This improves test clarity, speed, and reduces mistakes.

Practice

1. What is the main purpose of local variables in Postman?

easy

A. To create global environment settings

B. To save data permanently across all requests

C. To share data between different collections

D. To store data only during a single request execution

Solution

1. Step 1: Understand local variable scope

   Local variables exist only during the execution of one request and are not saved beyond that.

2. Step 2: Compare with other variable types

   Global or environment variables persist beyond one request, unlike local variables.

3. Final Answer:

   To store data only during a single request execution -> Option D

4. Quick Check:

   Local variables = single request scope [OK]

Hint: Local variables last only during one request [OK]

Common Mistakes:

• Confusing local variables with global variables
• Thinking local variables persist across requests
• Assuming local variables share data between collections

2. Which of the following is the correct syntax to set a local variable named token with value abc123 in Postman?

easy

A. pm.local.set('token', 'abc123');

B. pm.environment.set('token', 'abc123');

C. pm.variables.set('token', 'abc123');

D. pm.globals.set('token', 'abc123');

Solution

1. Step 1: Identify the correct method for local variables

   Local variables use pm.variables.set to assign values.

2. Step 2: Check other options for correctness

   pm.environment.set and pm.globals.set set environment and global variables, not local. pm.local.set is invalid.

3. Final Answer:

   pm.variables.set('token', 'abc123'); -> Option C

4. Quick Check:

   Set local variable = pm.variables.set [OK]

Hint: Use pm.variables.set() for local variables [OK]

Common Mistakes:

• Using pm.environment.set instead of pm.variables.set
• Trying to use pm.local.set which does not exist
• Confusing global and local variable methods

3. Consider this Postman test script:

pm.variables.set('count', 5);
pm.variables.set('count', pm.variables.get('count') + 3);
console.log(pm.variables.get('count'));

What will be printed in the console?

medium

A. 8

B. 5

C. Error: Cannot add number to undefined

D. null

Solution

1. Step 1: Set initial local variable 'count'

   The first line sets 'count' to 5.

2. Step 2: Increment 'count' by 3

   The second line gets 'count' (5), adds 3, and sets it back to 8.

3. Step 3: Output the updated value

   The console.log prints the current value of 'count', which is 8.

4. Final Answer:

   8 -> Option A

5. Quick Check:

   5 + 3 = 8 [OK]

Hint: Get then set to update local variable value [OK]

Common Mistakes:

• Assuming the variable does not update
• Expecting an error due to type mismatch
• Confusing local with environment variables

4. You wrote this Postman script:

pm.variables.set('user', 'Alice');
console.log(pm.variables.get('username'));

What is the problem here?

medium

A. Variable 'username' was never set, so get returns undefined

B. Syntax error in pm.variables.set method

C. Local variables cannot be logged to console

D. pm.variables.get requires two arguments

Solution

1. Step 1: Check variable names used

   The script sets 'user' but tries to get 'username', which was never set.

2. Step 2: Understand get behavior for unset variables

   Getting an unset local variable returns undefined, no error occurs.

3. Final Answer:

   Variable 'username' was never set, so get returns undefined -> Option A

4. Quick Check:

   Unset variable get = undefined [OK]

Hint: Check variable names carefully for typos [OK]

Common Mistakes:

• Assuming syntax error when variable name mismatches
• Thinking pm.variables.get needs two arguments
• Believing console.log cannot show local variables

5. You want to store a temporary token during a request and use it in multiple tests within that request. Which approach correctly uses local variables to achieve this?

hard

A. Set the token with pm.environment.set('token', 'abc') and get it with pm.variables.get('token')

B. Set the token once with pm.variables.set('token', 'abc') and get it in tests with pm.variables.get('token')

C. Set the token with pm.variables.set('token', 'abc') but cannot access it in other tests

D. Set the token with pm.globals.set('token', 'abc') and get it with pm.variables.get('token')

Solution

1. Step 1: Understand local variable scope within one request

   Local variables set with pm.variables.set are accessible throughout the request execution, including multiple tests.

2. Step 2: Verify correct get method usage

   Use pm.variables.get to retrieve the local variable value within the same request.

3. Step 3: Check other options for scope mismatch

   Environment and global variables persist beyond one request and are not local. Also, local variables are accessible across tests in the same request.

4. Final Answer:

   Set the token once with pm.variables.set('token', 'abc') and get it in tests with pm.variables.get('token') -> Option B

5. Quick Check:

   Local variable set/get works within one request [OK]

Hint: Use pm.variables.set/get to share data within one request [OK]

Common Mistakes:

• Using environment or global variables instead of local
• Thinking local variables cannot be shared between tests in one request
• Mixing set and get methods from different scopes