req.ip and req.hostname in Express - Step-by-Step Execution

Concept Flow - req.ip and req.hostname

Incoming HTTP Request

↓

Express Middleware

↓

Access req.ip

→Get Client IP Address

↓

Access req.hostname

→Get Hostname from Request

↓

Use IP and Hostname in App Logic

When Express receives a request, you can get the client's IP using req.ip and the hostname using req.hostname to use in your app.

Execution Sample

Express

app.get('/', (req, res) => {
  const clientIp = req.ip;
  const host = req.hostname;
  res.send(`IP: ${clientIp}, Hostname: ${host}`);
});

This code gets the client's IP and hostname from the request and sends them back in the response.

Execution Table

Step	Action	req.ip	req.hostname	Result
1	Request arrives from client	undefined	undefined	Waiting for middleware
2	Express parses request	192.168.1.10	example.com	req.ip and req.hostname set
3	Handler reads req.ip	192.168.1.10	example.com	Client IP captured
4	Handler reads req.hostname	192.168.1.10	example.com	Hostname captured
5	Response sent	192.168.1.10	example.com	Response: 'IP: 192.168.1.10, Hostname: example.com'
6	Request processing ends	192.168.1.10	example.com	Done

💡 Request handled and response sent with client IP and hostname

Variable Tracker

Variable	Start	After Step 2	After Step 3	After Step 4	Final
req.ip	undefined	192.168.1.10	192.168.1.10	192.168.1.10	192.168.1.10
req.hostname	undefined	example.com	example.com	example.com	example.com

Key Moments - 2 Insights

Why is req.ip available only after Express parses the request?

Because Express needs to read the incoming request headers and connection info first to determine the IP, as shown in step 2 of the execution_table.

Can req.hostname be different from the actual domain the client typed?

Yes, req.hostname is taken from the Host header sent by the client, so if the client spoofs it, it can differ. See step 2 where req.hostname is set from the request.

Visual Quiz - 3 Questions

Look at the execution_table, what is the value of req.ip at step 3?

A undefined

B 192.168.1.10

C example.com

D localhost

💡 Hint

Check the 'req.ip' column at step 3 in the execution_table.

At which step does Express set req.hostname?

A Step 2

B Step 1

C Step 4

D Step 5

💡 Hint

Look at the 'req.hostname' column and see when it changes from undefined.

If the client sends a request with Host header 'myapp.local', what changes in the execution_table?

A req.ip changes to 'myapp.local'

B req.ip and req.hostname both become 'myapp.local'

C req.hostname changes to 'myapp.local'

D No changes, values stay the same

💡 Hint

req.hostname reflects the Host header from the client, as shown in step 2.

Concept Snapshot

req.ip and req.hostname in Express

- req.ip gives the client's IP address
- req.hostname gives the hostname from the Host header
- Both are available after Express parses the request
- Use them to customize responses or logging
- req.hostname depends on client-sent headers
- req.ip can be affected by proxies or network setup

Full Transcript

When an HTTP request arrives in Express, the framework reads the request details. It sets req.ip to the client's IP address and req.hostname to the hostname from the Host header. These values are undefined before parsing. After parsing, handlers can access req.ip and req.hostname to know who sent the request and what hostname was used. This is useful for logging, security, or customizing responses. The IP is usually the client's network address, while hostname is what the client typed or sent in headers. Both are available during request handling.