req.body for request payload in Express

Introduction

We use req.body to get the data sent by a user in a web form or API call. It helps the server understand what the user wants to send.

When a user submits a form with information like name or email.

When an app sends data to the server to create or update something.

When you want to read JSON data sent from a client app.

When handling file uploads or other data sent in the request body.

When building APIs that accept data from other programs.

Syntax

Express

app.post('/path', (req, res) => {
  const data = req.body;
  // use data here
  res.send('Got your data');
});

You need to use middleware like express.json() to parse JSON data before accessing req.body.

req.body contains the data sent by the client in the request payload.

Examples

This example shows how to read JSON data sent in a POST request.

Express

app.use(express.json());

app.post('/submit', (req, res) => {
  console.log(req.body);
  res.send('Received');
});

This example reads form data sent as URL-encoded, like from an HTML form.

Express

app.use(express.urlencoded({ extended: true }));

app.post('/form', (req, res) => {
  console.log(req.body.name);
  res.send(`Hello, ${req.body.name}`);
});

Sample Program

This server listens for POST requests at /greet. It reads the name from req.body and sends a greeting. If no name is sent, it returns an error.

Express

import express from 'express';

const app = express();
const port = 3000;

// Middleware to parse JSON body
app.use(express.json());

app.post('/greet', (req, res) => {
  const { name } = req.body;
  if (name) {
    res.send(`Hello, ${name}!`);
  } else {
    res.status(400).send('Name is missing');
  }
});

app.listen(port, () => {
  console.log(`Server running on http://localhost:${port}`);
});

Important Notes

Always use express.json() or other body parsers before accessing req.body.

If you forget the middleware, req.body will be undefined.

For security, validate and sanitize data from req.body before using it.

Summary

req.body holds the data sent by the client in the request payload.

You must use middleware like express.json() to read JSON data.

Use req.body to get user input from forms or API calls.

Practice

1. What does req.body represent in an Express app?

easy

A. The data sent by the client in the request payload

B. The URL parameters of the request

C. The headers of the HTTP request

D. The response sent back to the client

Solution

1. Step 1: Understand the role of req.body

   req.body holds the data sent by the client inside the request payload, such as form data or JSON.

2. Step 2: Differentiate from other request parts

   URL parameters are in req.params, headers in req.headers, and response is separate from request.

3. Final Answer:

   The data sent by the client in the request payload -> Option A

4. Quick Check:

   req.body = client data [OK]

Hint: Remember: body means client data sent inside request [OK]

Common Mistakes:

• Confusing req.body with URL parameters
• Thinking req.body holds response data
• Assuming headers are in req.body

2. Which middleware must you use to correctly parse JSON data into req.body?

easy

A. express.urlencoded()

B. express.static()

C. express.raw()

D. express.json()

Solution

1. Step 1: Identify middleware for JSON parsing

   To parse JSON payloads, Express provides express.json() middleware.

2. Step 2: Differentiate from other middleware

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

3. Final Answer:

   express.json() -> Option D

4. Quick Check:

   JSON parsing middleware = express.json() [OK]

Hint: Use express.json() to read JSON in req.body [OK]

Common Mistakes:

• Using express.urlencoded() for JSON data
• Not adding any middleware before accessing req.body
• Confusing express.static() with body parsing

3. Given this Express route handler, what will console.log(req.body) output if the client sends JSON {"name":"Alice","age":30}?

app.post('/user', express.json(), (req, res) => {
  console.log(req.body);
  res.send('Received');
});

medium

A. "{\"name\":\"Alice\",\"age\":30}"

B. undefined

C. {"name":"Alice","age":30}

D. An error is thrown

Solution

1. Step 1: Identify the loop range

   The route uses express.json() middleware, so JSON payload is parsed into an object.

2. Step 2: Understand req.body content

   Since the client sends JSON {"name":"Alice","age":30}, req.body will be the parsed object with keys and values.

3. Final Answer:

   {"name":"Alice","age":30} -> Option C

4. Quick Check:

   JSON parsed to object = logged req.body [OK]

Hint: If express.json() is used, req.body is parsed object [OK]

Common Mistakes:

• Expecting req.body to be a string
• Forgetting to use express.json() middleware
• Thinking req.body is undefined without middleware

4. What is the main reason req.body is undefined in this Express app?

const express = require('express');
const app = express();

app.post('/data', (req, res) => {
  console.log(req.body);
  res.send('Done');
});

medium

A. Missing middleware to parse the request body

B. The route path is incorrect

C. The HTTP method should be GET instead of POST

D. The server is not listening on a port

Solution

1. Step 1: Identify the loop range

   The code does not use any middleware like express.json() or express.urlencoded() to parse the request body.

2. Step 2: Understand effect on req.body

   Without parsing middleware, Express does not fill req.body, so it remains undefined.

3. Final Answer:

   Missing middleware to parse the request body -> Option A

4. Quick Check:

   No body parser = req.body undefined [OK]

Hint: Always add body parsing middleware before using req.body [OK]

Common Mistakes:

• Assuming route path or method causes undefined body
• Not adding express.json() or express.urlencoded()
• Thinking server listen affects req.body

5. You want to accept both JSON and URL-encoded form data in your Express app and access it via req.body. Which setup correctly handles both types of payloads?

hard

A. app.use(express.raw()); app.use(express.urlencoded({ extended: false }));

B. app.use(express.json()); app.use(express.urlencoded({ extended: true }));

C. app.use(express.static()); app.use(express.json());

D. app.use(express.urlencoded()); app.use(express.json({ extended: true }));

Solution

1. Step 1: Identify middleware for JSON and URL-encoded data

   express.json() parses JSON payloads, and express.urlencoded({ extended: true }) parses URL-encoded form data.

2. Step 2: Confirm correct order and options

   Using both middleware with correct options ensures req.body works for both data types.

3. Final Answer:

   app.use(express.json()); app.use(express.urlencoded({ extended: true })); -> Option B

4. Quick Check:

   Use both json() and urlencoded() middleware [OK]

Hint: Add both express.json() and express.urlencoded() middleware [OK]

Common Mistakes:

• Using express.urlencoded() without options
• Mixing middleware order incorrectly
• Using express.static() instead of body parsers