Form-data body in Postman - Test Execution Trace

Test Overview

This test sends a POST request with form-data body to an API endpoint and verifies the response status and returned data.

Test Code - Postman Test Script

Postman

pm.test("POST request with form-data body", function () {
    pm.sendRequest({
        url: 'https://postman-echo.com/post',
        method: 'POST',
        header: {
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: {
            mode: 'formdata',
            formdata: [
                { key: 'username', value: 'testuser', type: 'text' },
                { key: 'password', value: 'pass123', type: 'text' }
            ]
        }
    }, function (err, res) {
        pm.expect(err).to.be.null;
        pm.expect(res).to.have.property('code', 200);
        const jsonData = res.json();
        pm.expect(jsonData.form).to.have.property('username', 'testuser');
        pm.expect(jsonData.form).to.have.property('password', 'pass123');
    });
});

Execution Trace - 5 Steps

Step	Action	System State	Assertion	Result
1	Test starts	Postman test runner is ready to execute the test script	—	PASS
2	Sends POST request to https://postman-echo.com/post with form-data body containing username and password	Request is sent with Content-Type multipart/form-data and form fields username=testuser, password=pass123	—	PASS
3	Receives response from server	Response status code 200 OK, response body contains JSON with form data echoed back	Check response code is 200	PASS
4	Parse response JSON and verify form data fields	Response JSON contains form object with username and password keys	Assert form.username equals 'testuser' and form.password equals 'pass123'	PASS
5	Test ends successfully	All assertions passed, test marked as pass	—	PASS

Failure Scenario

Failing Condition: Response status code is not 200 or form data keys are missing or incorrect

Execution Trace Quiz - 3 Questions

What does the test verify after sending the POST request?

A Response contains HTML content

B Request method is GET

C Response status is 200 and form-data fields are correctly echoed

D Form-data keys are missing

Key Result

Always verify both the response status code and the actual data returned when testing API requests with form-data bodies to ensure the server processes the data correctly.

Practice

1. What is the main purpose of using form-data body in Postman?

easy

A. To send only JSON data

B. To send only URL encoded data

C. To send raw binary data without boundaries

D. To send files and text data like a real HTML form

Solution

1. Step 1: Understand form-data usage

   Form-data body is designed to send files and text fields together, mimicking how HTML forms submit data.

2. Step 2: Compare with other body types

   JSON and URL encoded bodies do not support file uploads or mixed data as form-data does.

3. Final Answer:

   To send files and text data like a real HTML form -> Option D

4. Quick Check:

   Form-data = files + text [OK]

Hint: Form-data sends files and text like a real form [OK]

Common Mistakes:

• Confusing form-data with raw JSON
• Thinking form-data cannot send files
• Mixing form-data with URL encoded body

2. Which of the following is the correct way to add a file in Postman's form-data body?

easy

A. Set key type to File and select the file from your system

B. Set key type to Text and enter file path

C. Set key type to Raw and paste file content

D. Set key type to JSON and upload file

Solution

1. Step 1: Identify file upload method in Postman

   Postman requires setting the key type to File to upload a file from your system in form-data.

2. Step 2: Eliminate incorrect options

   Text type is for plain text, Raw is for raw data input, JSON is a data format, none upload files directly.

3. Final Answer:

   Set key type to File and select the file from your system -> Option A

4. Quick Check:

   File upload = key type File [OK]

Hint: Use 'File' type key to upload files in form-data [OK]

Common Mistakes:

• Choosing Text type for file upload
• Trying to upload files in Raw body
• Confusing JSON body with form-data

3. Given this form-data body in Postman:

Key: username, Value: alice, Type: Text
Key: avatar, Value: (file selected), Type: File

What will the Content-Type header look like when the request is sent?

medium

A. application/json

B. multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW

C. application/x-www-form-urlencoded

D. text/plain

Solution

1. Step 1: Recognize form-data Content-Type

   Form-data requests use multipart/form-data with a boundary string to separate parts.

2. Step 2: Match Content-Type to form-data

   Options B, C, and D are for JSON, URL encoded, and plain text respectively, not for form-data with files.

3. Final Answer:

   multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW -> Option B

4. Quick Check:

   Form-data uses multipart/form-data with boundary [OK]

Hint: Form-data always uses multipart/form-data with boundary [OK]

Common Mistakes:

• Assuming JSON Content-Type for form-data
• Confusing URL encoded with form-data
• Ignoring boundary parameter in Content-Type

4. You created a form-data request in Postman but the server reports missing file data. What is the most likely mistake?

medium

A. You set the file key type as Text instead of File

B. You forgot to add the Authorization header

C. You used raw JSON body instead of form-data

D. You did not select any file for the file key

Solution

1. Step 1: Analyze the missing file data issue

   If the server says file data is missing, the file was not sent properly.

2. Step 2: Identify common form-data mistakes

   Setting file key as Text sends file path as text, not the file content. Selecting no file also causes missing data but is less common if user intended to upload.

3. Final Answer:

   You set the file key type as Text instead of File -> Option A

4. Quick Check:

   File key must be type File [OK]

Hint: File keys must be type File, not Text [OK]

Common Mistakes:

• Using Text type for file keys
• Not selecting a file for upload
• Confusing body types (raw vs form-data)

5. You want to send a form-data request with multiple text fields and two files named photo.jpg and resume.pdf. How should you configure the form-data body in Postman to correctly send all data?

hard

A. Add all keys as File type and upload files only, omit text fields

B. Add all keys as Text type and paste file paths as values

C. Add keys for text fields as Text type, add keys for files as File type, select files from system

D. Use raw JSON body with base64 encoded files and text fields

Solution

1. Step 1: Understand form-data mixed data requirements

   Form-data supports sending text fields and files together by setting key types accordingly.

2. Step 2: Configure keys properly in Postman

   Text fields must be type Text with their values; files must be type File with selected files uploaded.

3. Final Answer:

   Add keys for text fields as Text type, add keys for files as File type, select files from system -> Option C

4. Quick Check:

   Text keys = Text type, file keys = File type [OK]

Hint: Text fields use Text type; files use File type in form-data [OK]

Common Mistakes:

• Uploading files as text values
• Omitting text fields when files are present
• Using raw JSON instead of form-data for files