Request in Express JS

Express.js is a powerful web application framework for Node.js that provides a simple and flexible way to build web applications and APIs. One of the key features of Express.js is its powerful request system, which allows developers to handle a wide range of incoming requests from clients.

In this article, we’ll explore the various features of the Express.js request system and how to use them effectively in your web applications.

Express Request Object

In Express.js, the request object (req) is an object that represents the HTTP request sent by the client. The req object is created automatically by the framework and is passed as an argument to route handler functions. Developers can use this object to access information about the incoming request, such as the URL, headers, and query parameters.

Properties of the Request Object in Express JS

Let’s take a look at some of the most commonly used properties of the Request object in Express:

1. req.params

The req.params property is an object containing properties mapped to the named route “parameters”. For example, if you have a route defined like this:

app.get('/users/:id', (req, res) => {
  console.log(req.params.id);
  res.send('User details');
});

And the client makes a request to /users/123, req.params.id would be equal to 123.

2. req.query

The req.query property is an object containing a property for each query string parameter in the route. For example, if a client makes a request to /users?name=john&age=25, req.query would be an object with properties name and age.

3. req.body

The req.body property is an object containing the parsed request body, if any. The body of an HTTP request can contain data in a variety of formats, including JSON, URL-encoded form data, and more. Express provides middleware to parse the request body into an object that can be easily accessed via req.body. In order to use this middleware, you need to install and configure a body-parser module.

4. req.cookies

The req.cookies property is an object containing the cookies sent by the client. Cookies are small pieces of data that can be used to store information about a client’s session or preferences. In order to use this property, you need to install and configure the cookie-parser module.

5. req.headers

The req.headers property is an object containing the HTTP headers sent by the client. HTTP headers are key-value pairs that provide additional information about the request or the response. Some common headers include Content-Type, User-Agent, Referer, and more.

6. req.protocol

The req.protocol property is a string containing the protocol used by the client to make the request. This property can be used to determine whether the request was made over HTTP or HTTPS.

7. req.path

The req.path property is a string containing the path portion of the URL of the request. For example, if a client makes a request to /users/123, req.path would be equal to /users/123.

Methods of the Request Object

In addition to the properties, the Request object also provides several useful methods:

1. req.get()

The req.get() method can be used to retrieve the value of an HTTP header from the request. For example, to get the value of the User-Agent header, you can use req.get(‘User-Agent’).

2. req.is()

The req.is() method can be used to determine whether the request was made with a specific content type. For example, to check whether the request was made with JSON data, you can use req.is(‘application/json’).

Key features of the req object in Express.js:

1. Accessing Request Headers

The request headers provide additional information about the incoming request, such as the content type, encoding, and user agent. In Express.js, you can access the request headers using the get() method of the req object. Here’s an example:

app.get('/', function (req, res) {
  const contentType = req.get('Content-Type');
  const userAgent = req.get('User-Agent');
  res.send(`Content-Type: ${contentType}\nUser-Agent: ${userAgent}`);
});

In this example, we use the get() method to access the Content-Type and User-Agent headers of the incoming request and send them back to the client using the send() method.

2. Accessing Request Parameters

The request parameters are values passed in the URL or as part of a form submission. In Express.js, you can access the request parameters using the params and query properties of the req object. Here’s an example:

app.get('/user/:id', function (req, res) {
  const id = req.params.id;
  const name = req.query.name;
  res.send(`ID: ${id}\nName: ${name}`);
});

In this example, we define a route with a parameter named id and access it using the params property of the req object. We also access a query parameter named name using the query property of the req object.

3. Accessing Request Body

The request body contains the data submitted by the client in a POST, PUT or PATCH request. In Express.js, you can access the request body using the body property of the req object. However, by default, the body property is not populated. To populate it, you need to use a middleware such as body-parser.

Here’s an example:

const bodyParser = require('body-parser');
app.use(bodyParser.urlencoded({ extended: true }));
app.use(bodyParser.json());

app.post('/user', function (req, res) {
  const name = req.body.name;
  const email = req.body.email;
  res.send(`Name: ${name}\nEmail: ${email}`);
});

In this example, we use the body-parser middleware to parse the incoming request body as URL-encoded or JSON data, and populate the body property of the req object. We then access the name and email fields of the request body using the body property.

Conclusion

In this article, we’ve explored the various features of the Express.js request system and how to use them effectively in your web applications. We’ve seen how to access request headers, parameters, and body, and how to use middleware such as body-parser to populate the request body.