Request body transformation in Express - Step-by-Step Execution

Concept Flow - Request body transformation

Client sends HTTP request with body

↓

Express receives request

↓

Middleware parses raw body

↓

Middleware transforms body data

↓

Route handler accesses transformed body

↓

Response sent back to client

This flow shows how Express receives a request, parses and transforms the body, then the route handler uses the transformed data.

Execution Sample

Express

app.use(express.json());
app.use((req, res, next) => {
  if (req.body && req.body.name) {
    req.body.name = req.body.name.trim().toUpperCase();
  }
  next();
});

This code parses JSON request bodies and transforms the 'name' field by trimming spaces and converting to uppercase.

Execution Table

Step	Action	Input Body	Transformation	Output Body	Next
1	Receive request	undefined	None yet	undefined	Parse JSON body
2	Parse JSON body	undefined	Parse raw JSON	{"name": " alice "}	Transform body
3	Transform body	{"name": " alice "}	Trim and uppercase 'name'	{"name": "ALICE"}	Call next()
4	Route handler access	{"name": "ALICE"}	Use transformed body	{"name": "ALICE"}	Send response
5	Send response	N/A	N/A	N/A	End

💡 Request processed fully; response sent back to client.

Variable Tracker

Variable	Start	After Step 1	After Step 2	After Step 3	Final
req.body	undefined	undefined	{"name": " alice "}	{"name": "ALICE"}	{"name": "ALICE"}

Key Moments - 3 Insights

Why do we need to call next() after transforming the body?

Calling next() passes control to the next middleware or route handler, allowing the request to continue processing with the transformed body as shown in execution_table step 3.

What happens if express.json() middleware is missing?

Without express.json(), req.body remains undefined or raw, so the transformation middleware cannot access or modify the body, as seen between steps 1 and 2.

Why do we trim and uppercase the 'name' field?

Trimming removes extra spaces and uppercasing standardizes the format, making data consistent for later use, demonstrated in step 3 transformation.

Visual Quiz - 3 Questions

Look at the execution_table, what is req.body after step 3?

A undefined

B {"name": "ALICE"}

C {"name": " alice "}

D {"name": "alice"}

💡 Hint

Check the 'Output Body' column in row for step 3 in execution_table.

At which step does the JSON parsing happen?

A Step 3

B Step 1

C Step 2

D Step 4

💡 Hint

Look at the 'Action' column in execution_table where 'Parse JSON body' is mentioned.

If we remove the transformation middleware, what would req.body be at step 4?

A {"name": " alice "}

B {"name": "ALICE"}

C undefined

D {}

💡 Hint

Refer to variable_tracker and note that without transformation, req.body stays as parsed JSON.

Concept Snapshot

Express request body transformation:
- Use express.json() to parse JSON bodies.
- Middleware can modify req.body before route handlers.
- Always call next() to continue processing.
- Transformations can clean or standardize data.
- Route handlers access the transformed req.body.

Full Transcript

In Express, when a client sends a request with a body, the server first parses the raw body using middleware like express.json(). Then, custom middleware can transform the parsed body, for example trimming spaces and uppercasing a name field. After transformation, the route handler accesses the cleaned data to process the request. Calling next() in middleware is essential to pass control forward. This flow ensures the server works with consistent, clean data before responding.

Practice

1. What is the main purpose of request body transformation in Express?

easy

A. To send the response back to the client

B. To handle errors in the server

C. To change incoming data into a more useful format before using it

D. To set HTTP headers for the response

Solution

1. Step 1: Understand request body transformation

   Request body transformation modifies the data received from the client to a better format for the app.

2. Step 2: Identify the main purpose

   This process happens after parsing and helps clean or convert data before use.

3. Final Answer:

   To change incoming data into a more useful format before using it -> Option C

4. Quick Check:

   Request body transformation = change data format [OK]

Hint: Think: transform means change data format before use [OK]

Common Mistakes:

• Confusing transformation with sending response
• Mixing transformation with error handling
• Thinking it sets HTTP headers

2. Which Express middleware is commonly used to parse JSON request bodies before transformation?

easy

A. express.urlencoded()

B. express.static()

C. express.raw()

D. express.json()

Solution

1. Step 1: Identify JSON parsing middleware

   express.json() parses incoming JSON request bodies into JavaScript objects.

2. Step 2: Confirm other options

   express.urlencoded() parses URL-encoded data, express.static() serves files, express.raw() parses raw buffer data.

3. Final Answer:

   express.json() -> Option D

4. Quick Check:

   JSON body parser = express.json() [OK]

Hint: Use express.json() to parse JSON bodies before transforming [OK]

Common Mistakes:

• Using express.urlencoded() for JSON data
• Confusing express.static() as parser
• Not parsing body before transformation

3. Given this Express code, what will be the value of req.body.age after transformation?

app.use(express.json());
app.post('/user', (req, res) => {
  req.body.age = Number(req.body.age);
  res.send(req.body);
});

If the client sends JSON {"age": "30"}?

medium

A. 30 (number)

B. "30" (string)

C. NaN

D. undefined

Solution

1. Step 1: Parse JSON body

   express.json() converts the JSON string {"age": "30"} into an object with age as string "30".

2. Step 2: Transform age to number

   req.body.age = Number(req.body.age) converts the string "30" to the number 30.

3. Final Answer:

   30 (number) -> Option A

4. Quick Check:

   Number("30") = 30 [OK]

Hint: Number() converts string digits to number type [OK]

Common Mistakes:

• Assuming age stays a string
• Thinking Number("30") returns NaN
• Confusing undefined with missing property

4. Identify the error in this Express request body transformation code:

app.use(express.json());
app.post('/data', (req, res) => {
  req.body.count = parseInt(req.body.count);
  if (!req.body.count) {
    res.status(400).send('Count required');
  }
  res.send(req.body);
});

medium

A. parseInt should be replaced with Number

B. The check '!req.body.count' fails when count is 0

C. express.json() middleware is missing

D. res.send() should be called before res.status()

Solution

1. Step 1: Understand parseInt and check

   parseInt converts strings to numbers; 0 is falsy in JavaScript.

2. Step 2: Analyze the if condition

   The condition '!req.body.count' treats 0 as false, wrongly triggering the error for count=0.

3. Final Answer:

   The check '!req.body.count' fails when count is 0 -> Option B

4. Quick Check:

   Falsy check fails for 0 count [OK]

Hint: Check for 0 explicitly, not with '!value' [OK]

Common Mistakes:

• Assuming parseInt is wrong here
• Missing express.json() middleware
• Calling res.send before res.status

5. You want to transform an incoming request body to remove any properties with empty strings and convert all numeric strings to numbers. Which code snippet correctly performs this transformation in Express?

hard

A. app.use(express.json());
app.post('/transform', (req, res) => {
for (const key in req.body) {
if (req.body[key] === '') delete req.body[key];
else if (!isNaN(req.body[key])) req.body[key] = Number(req.body[key]);
}
res.send(req.body);
});

B. app.use(express.json());
app.post('/transform', (req, res) => {
Object.keys(req.body).forEach(key => {
if (req.body[key] === '') req.body[key] = null;
else if (typeof req.body[key] === 'string') req.body[key] = parseInt(req.body[key]);
});
res.send(req.body);
});

C. app.use(express.urlencoded());
app.post('/transform', (req, res) => {
for (const key in req.body) {
if (req.body[key] === '') delete req.body[key];
else if (!isNaN(req.body[key])) req.body[key] = Number(req.body[key]);
}
res.send(req.body);
});

D. app.use(express.json());
app.post('/transform', (req, res) => {
for (const key in req.body) {
if (req.body[key] === '') req.body[key] = undefined;
else if (isNaN(req.body[key])) req.body[key] = Number(req.body[key]);
}
res.send(req.body);
});

Solution

1. Step 1: Check middleware and iteration

   express.json() is needed to parse JSON bodies; for..in loops over keys correctly.

2. Step 2: Validate transformation logic

   app.use(express.json()); app.post('/transform', (req, res) => { for (const key in req.body) { if (req.body[key] === '') delete req.body[key]; else if (!isNaN(req.body[key])) req.body[key] = Number(req.body[key]); } res.send(req.body); }); deletes keys with empty strings and converts numeric strings to numbers using !isNaN check.

3. Step 3: Compare other options

   app.use(express.json()); app.post('/transform', (req, res) => { Object.keys(req.body).forEach(key => { if (req.body[key] === '') req.body[key] = null; else if (typeof req.body[key] === 'string') req.body[key] = parseInt(req.body[key]); }); res.send(req.body); }); sets empty strings to null and always parses strings with parseInt (may convert non-numeric wrongly). app.use(express.urlencoded()); app.post('/transform', (req, res) => { for (const key in req.body) { if (req.body[key] === '') delete req.body[key]; else if (!isNaN(req.body[key])) req.body[key] = Number(req.body[key]); } res.send(req.body); }); uses express.urlencoded() which is wrong for JSON. app.use(express.json()); app.post('/transform', (req, res) => { for (const key in req.body) { if (req.body[key] === '') req.body[key] = undefined; else if (isNaN(req.body[key])) req.body[key] = Number(req.body[key]); } res.send(req.body); }); wrongly converts non-numeric strings to numbers.

4. Final Answer:

   app.use(express.json()); app.post('/transform', (req, res) => { for (const key in req.body) { if (req.body[key] === '') delete req.body[key]; else if (!isNaN(req.body[key])) req.body[key] = Number(req.body[key]); } res.send(req.body); }); -> Option A

5. Quick Check:

   Delete empty and convert numeric strings = app.use(express.json()); app.post('/transform', (req, res) => { for (const key in req.body) { if (req.body[key] === '') delete req.body[key]; else if (!isNaN(req.body[key])) req.body[key] = Number(req.body[key]); } res.send(req.body); }); [OK]

Hint: Delete empty strings, convert numeric strings with !isNaN check [OK]

Common Mistakes:

• Using wrong middleware for JSON
• Setting empty strings to null instead of deleting
• Converting non-numeric strings to numbers