Testing POST with request body in Express - Step-by-Step Execution

Concept Flow - Testing POST with request body

Start Test

↓

Send POST request

↓

Server receives request

↓

Parse request body

↓

Process data

↓

Send response

↓

Test checks response

↓

Test Pass or Fail

This flow shows how a POST request with a body is sent, processed by the server, and then tested for the correct response.

Execution Sample

Express

app.use(express.json());

app.post('/data', (req, res) => {
  const { name } = req.body;
  res.json({ greeting: `Hello, ${name}!` });
});

This code defines a POST route that reads 'name' from the request body and responds with a greeting message. Note that express.json() middleware is used to parse JSON bodies.

Execution Table

Step	Action	Request Body	Server Processing	Response Sent
1	Send POST request to /data	{"name":"Alice"}	Receive request, parse body	Waiting
2	Extract 'name' from body	{"name":"Alice"}	name = 'Alice'	Waiting
3	Create greeting message	{"name":"Alice"}	greeting = 'Hello, Alice!'	Waiting
4	Send JSON response	{"name":"Alice"}	Response ready	{"greeting":"Hello, Alice!"}
5	Test receives response	{"name":"Alice"}	Response received	Check if greeting matches
6	Test assertion	{"name":"Alice"}	Compare expected vs actual	Pass if matches

💡 Test ends after response is checked and assertion passes or fails.

Variable Tracker

Variable	Start	After Step 2	After Step 3	Final
req.body	undefined	{"name":"Alice"}	{"name":"Alice"}	{"name":"Alice"}
name	undefined	"Alice"	"Alice"	"Alice"
greeting	undefined	undefined	"Hello, Alice!"	"Hello, Alice!"

Key Moments - 2 Insights

Why do we need to parse the request body before accessing 'name'?

Because the raw request body is a stream of bytes, parsing converts it into a usable JavaScript object, as shown in step 1 and 2 of the execution_table.

What happens if the request body does not contain 'name'?

The variable 'name' will be undefined, so the greeting will include 'undefined', which can cause unexpected output. This is visible in the variable_tracker if 'name' is missing.

Visual Quiz - 3 Questions

Look at the execution_table, what is the value of 'greeting' after step 3?

A "Alice"

B "Hello, Alice!"

C undefined

D {"name":"Alice"}

💡 Hint

Check the 'Server Processing' and 'Response Sent' columns at step 3 in the execution_table.

At which step does the server send the JSON response back to the client?

A Step 4

B Step 2

C Step 5

D Step 6

💡 Hint

Look for the 'Send JSON response' action in the execution_table.

If the request body was empty, how would the 'name' variable appear in the variable_tracker after step 2?

A "" (empty string)

B null

C undefined

D "name"

💡 Hint

Refer to the variable_tracker row for 'name' and consider what happens if the key is missing in req.body.

Concept Snapshot

POST route receives data in request body
Use middleware to parse JSON body
Access data via req.body.property
Process and send response with res.json()
Test by sending POST with body and checking response

Full Transcript

This visual execution trace shows how to test a POST request with a request body in Express. The test sends a POST request containing JSON data with a 'name' property. The server receives the request, parses the JSON body, extracts the 'name' value, and creates a greeting message. It then sends this greeting back as a JSON response. The test checks the response to confirm it matches the expected greeting. Variables like req.body, name, and greeting change step-by-step as the request is processed. Key moments include understanding why parsing the body is necessary and what happens if expected data is missing. The quiz questions reinforce understanding of variable values and response timing during the process.