Default and conditional responses in Postman

Introduction

Default and conditional responses help you check if your API sends the right reply based on different situations. This makes sure your app works well for all users.

When you want to test how your API responds to a successful request.

When you need to verify the API returns an error message for bad input.

When you want to check different responses based on user roles or permissions.

When you want to handle unexpected responses gracefully in your tests.

Syntax

Postman

// Example of conditional test in Postman
pm.test("Status code is 200", function () {
    pm.response.to.have.status(200);
});

if (pm.response.code === 200) {
    // test for success response
    pm.test("Response has success message", function () {
        pm.expect(pm.response.json().message).to.eql("Success");
    });
} else {
    // test for error response
    pm.test("Response has error message", function () {
        pm.expect(pm.response.json().error).to.exist;
    });
}

Use pm.response.code to check the HTTP status code.

Use pm.test() to create test cases that pass or fail.

Examples

This test checks if the response status code is exactly 200 (OK).

Postman

pm.test("Status code is 200", function () {
    pm.response.to.have.status(200);
});

This checks if the response is 404 and verifies the error message.

Postman

if (pm.response.code === 404) {
    pm.test("Not Found error returned", function () {
        pm.expect(pm.response.json().error).to.eql("Not Found");
    });
}

This test ensures the response code is one of the expected default codes.

Postman

pm.test("Default response check", function () {
    pm.expect(pm.response.code).to.be.oneOf([200, 400, 404]);
});

Sample Program

This script tests if the response status is either 200 or 400. If 200, it checks for a success message. If 400, it checks for an error message. Otherwise, it fails the test with a message.

Postman

// Sample Postman test script for default and conditional responses
pm.test("Response status is 200 or 400", function () {
    pm.expect(pm.response.code).to.be.oneOf([200, 400]);
});

if (pm.response.code === 200) {
    pm.test("Success message is correct", function () {
        pm.expect(pm.response.json().message).to.eql("Operation completed successfully");
    });
} else if (pm.response.code === 400) {
    pm.test("Error message is present", function () {
        pm.expect(pm.response.json().error).to.exist;
    });
} else {
    pm.test("Unexpected status code", function () {
        pm.expect.fail("Received unexpected status code: " + pm.response.code);
    });
}

Important Notes

Always check for both expected success and error responses to cover all cases.

Use clear and descriptive test names to understand test results easily.

Conditional tests help you handle different API behaviors in one script.

Summary

Default and conditional responses let you test different API replies in one place.

Use pm.test() and if conditions to check various outcomes.

This helps catch errors early and improves your API reliability.

Practice

1. What is the main purpose of using default and conditional responses in Postman tests?

easy

A. To send multiple requests at the same time

B. To change the API endpoint dynamically

C. To check different API responses in one test script

D. To automatically generate API documentation

Solution

1. Step 1: Understand the role of conditional responses

   Conditional responses allow testing different API replies based on conditions in one place.

2. Step 2: Identify the main purpose

   This helps verify various outcomes without writing separate tests for each response.

3. Final Answer:

   To check different API responses in one test script -> Option C

4. Quick Check:

   Default and conditional responses = test multiple replies [OK]

Hint: Think: one test script, many response checks [OK]

Common Mistakes:

• Confusing response testing with sending requests
• Assuming it changes API endpoints
• Mixing testing with documentation generation

2. Which of the following is the correct syntax to write a conditional test in Postman to check if the response status is 200?

easy

A. pm.test('Status is 200', () => { if (pm.response.code === 200) { pm.expect(true).to.be.true; } });

B. pm.test('Status is 200', () => { pm.expect(pm.response.code).to.equal(200); });

C. pm.test('Status is 200', () => pm.response.code == 200);

D. pm.test('Status is 200', () => { if (pm.response.status == 200) pm.expect(true); });

Solution

1. Step 1: Review Postman test syntax

   Postman uses pm.test with a callback function and pm.expect for assertions.

2. Step 2: Identify correct assertion for status code

   pm.expect(pm.response.code).to.equal(200) correctly asserts status code equals 200.

3. Final Answer:

   pm.test('Status is 200', () => { pm.expect(pm.response.code).to.equal(200); }); -> Option B

4. Quick Check:

   pm.expect with .to.equal(200) = correct syntax [OK]

Hint: Use pm.expect with .to.equal for exact value checks [OK]

Common Mistakes:

• Using '==' instead of .to.equal() in assertions
• Checking pm.response.status instead of pm.response.code
• Not calling pm.expect properly inside pm.test

3. Given this Postman test code, what will be the test result if the response status is 404?

pm.test('Check response', () => {
  if (pm.response.code === 200) {
    pm.expect(pm.response.json().success).to.be.true;
  } else {
    pm.expect(pm.response.code).to.equal(404);
  }
});

medium

A. Test passes because status is 404 and matches else condition

B. Test fails because success property is missing

C. Test throws an error due to missing JSON body

D. Test passes only if success is true

Solution

1. Step 1: Analyze the if-else condition with status 404

   Status 404 triggers the else block which asserts pm.response.code equals 404.

2. Step 2: Check assertion in else block

   pm.expect(pm.response.code).to.equal(404) will pass since status is 404.

3. Final Answer:

   Test passes because status is 404 and matches else condition -> Option A

4. Quick Check:

   404 status triggers else assertion = pass [OK]

Hint: Match status code to correct if/else branch [OK]

Common Mistakes:

• Assuming test fails due to missing success property
• Thinking JSON parsing fails on 404
• Ignoring else block assertions

4. Identify the error in this Postman test script that checks for a 201 status or a 400 error:

pm.test('Status check', () => {
  if (pm.response.code = 201) {
    pm.expect(pm.response.code).to.equal(201);
  } else if (pm.response.code = 400) {
    pm.expect(pm.response.json().error).to.exist;
  }
});

medium

A. No else block to handle other status codes

B. Missing pm.expect in the first if block

C. Incorrect JSON parsing method

D. Using assignment '=' instead of comparison '===' in if conditions

Solution

1. Step 1: Check if condition syntax

   The code uses '=' which assigns value instead of '===' for comparison.

2. Step 2: Understand impact of assignment in conditions

   Assignment always returns true, causing logic errors and wrong test behavior.

3. Final Answer:

   Using assignment '=' instead of comparison '===' in if conditions -> Option D

4. Quick Check:

   Use '===' for comparisons, not '=' [OK]

Hint: Use '===' for comparisons, '=' is assignment [OK]

Common Mistakes:

• Confusing '=' with '==' or '==='
• Ignoring that assignment returns a value
• Not validating all possible status codes

5. You want to write a Postman test that checks if the response status is 200 and the JSON body has a 'data' field, but if the status is 404, it should check for an 'error' message. Which code snippet correctly implements this conditional response test?

hard

A. pm.test('Conditional response test', () => {
if (pm.response.code === 200) {
pm.expect(pm.response.json().data).to.exist;
} else if (pm.response.code === 404) {
pm.expect(pm.response.json().error).to.exist;
} else {
pm.expect.fail('Unexpected status code');
}
});

B. pm.test('Conditional response test', () => {
pm.expect(pm.response.code === 200 && pm.response.json().data).to.exist;
pm.expect(pm.response.code === 404 && pm.response.json().error).to.exist;
});

C. pm.test('Conditional response test', () => {
if (pm.response.code = 200) {
pm.expect(pm.response.json().data).to.exist;
} else if (pm.response.code = 404) {
pm.expect(pm.response.json().error).to.exist;
}
});

D. pm.test('Conditional response test', () => {
pm.expect(pm.response.json().data || pm.response.json().error).to.exist;
});

Solution

1. Step 1: Check correct use of comparison operators

   pm.test('Conditional response test', () => { if (pm.response.code === 200) { pm.expect(pm.response.json().data).to.exist; } else if (pm.response.code === 404) { pm.expect(pm.response.json().error).to.exist; } else { pm.expect.fail('Unexpected status code'); } }); uses '===' for comparisons correctly. Using '=' causes assignment instead of comparison.

2. Step 2: Verify conditional logic and assertions

   The code checks 'data' field existence for status 200, 'error' for 404, and explicitly fails for unexpected codes using pm.expect.fail().

3. Step 3: Evaluate other options

   One option incorrectly combines status and field checks in single pm.expect statements, causing failures. Another does not condition on status codes at all.

4. Final Answer:

   pm.test('Conditional response test', () => { if (pm.response.code === 200) { pm.expect(pm.response.json().data).to.exist; } else if (pm.response.code === 404) { pm.expect(pm.response.json().error).to.exist; } else { pm.expect.fail('Unexpected status code'); } }); -> Option A

5. Quick Check:

   Use if-else with '===' and proper assertions [OK]

Hint: Use if-else with '===' and separate assertions [OK]

Common Mistakes:

• Using '=' instead of '===' in conditions
• Combining conditions inside one pm.expect
• Not handling unexpected status codes