Why req.query for query strings in Express? - Purpose & Use Cases

The Big Idea

Discover how a tiny Express feature can save you hours of frustrating code!

The Scenario

Imagine building a web server that reads user input from the URL like ?name=John&age=30 by manually parsing the URL string every time.

The Problem

Manually extracting query strings is slow, error-prone, and messy. You have to split strings, handle missing values, and decode characters yourself, which leads to bugs and wasted time.

The Solution

Express provides req.query which automatically parses the query string into an easy-to-use object, so you can access parameters directly by name without extra work.

Before vs After

✗ Before

const url = req.url;
const queryString = url.split('?')[1];
const params = {};
queryString.split('&').forEach(pair => {
  const [key, value] = pair.split('=');
  params[key] = decodeURIComponent(value);
});
console.log(params.name);

✓ After

console.log(req.query.name);

What It Enables

This lets you quickly and reliably access user inputs from URLs, making your code cleaner and your server faster to build.

Real Life Example

When a user searches on a website with ?search=shoes&color=red, req.query lets you easily get those values to show matching products.

Key Takeaways

Manually parsing query strings is complicated and error-prone.

req.query gives a simple object with all query parameters.

This saves time and reduces bugs when handling URL inputs.

Practice

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

easy

A. An object containing URL query parameters sent after the question mark

B. The body data sent in a POST request

C. The headers of the HTTP request

D. The cookies sent by the client

Solution

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

   req.query holds key-value pairs from the URL query string, which comes after the question mark in a URL.

2. Step 2: Differentiate from other request parts

   Body data is accessed via req.body, headers via req.headers, and cookies via req.cookies. So, req.query is specifically for query parameters.

3. Final Answer:

   An object containing URL query parameters sent after the question mark -> Option A

4. Quick Check:

   req.query = URL query parameters [OK]

Hint: Remember: query = URL after '?' [OK]

Common Mistakes:

• Confusing query parameters with body data
• Thinking req.query holds headers or cookies
• Assuming req.query is a string instead of an object

2. Which of the following is the correct way to access a query parameter named id in Express?

easy

A. req.params.id

B. req.query.id

C. req.body.id

D. req.headers.id

Solution

1. Step 1: Identify where query parameters are stored

   Query parameters are stored in req.query, so to get the value of id, use req.query.id.

2. Step 2: Differentiate from other request properties

   req.params is for route parameters, req.body is for POST data, and req.headers is for HTTP headers.

3. Final Answer:

   req.query.id -> Option B

4. Quick Check:

   Query param 'id' = req.query.id [OK]

Hint: Query params always use req.query.[name] [OK]

Common Mistakes:

• Using req.params for query strings
• Trying to get query data from req.body
• Accessing query params from headers

3. Given this Express route handler, what will be logged if the URL is /search?term=books&page=2?

app.get('/search', (req, res) => {
  console.log(req.query.term);
  console.log(req.query.page);
  res.send('Done');
});

medium

A. term\npage

B. undefined\nundefined

C. books\n2

D. books\nundefined

Solution

1. Step 1: Understand the URL query string

   The URL has query parameters: term=books and page=2. These are accessible via req.query.term and req.query.page.

2. Step 2: Check what is logged

   The code logs req.query.term which is "books" and req.query.page which is "2" (strings).

3. Final Answer:

   books 2 -> Option C

4. Quick Check:

   req.query.term = 'books', req.query.page = '2' [OK]

Hint: Query values come as strings from req.query [OK]

Common Mistakes:

• Expecting numbers instead of strings
• Confusing query params with route params
• Assuming undefined if query exists

4. What is the problem with this Express route handler?

app.get('/items', (req, res) => {
  const page = req.query.page;
  if (page > 0) {
    res.send(`Page number is ${page}`);
  } else {
    res.send('Invalid page');
  }
});

medium

A. res.send cannot be called inside an if statement

B. req.query.page is undefined, causing a crash

C. The route should use req.params instead of req.query

D. req.query.page is a string, so numeric comparison may fail

Solution

1. Step 1: Identify the type of req.query.page

   Query parameters are strings by default, so req.query.page is a string, e.g., "1".

2. Step 2: Understand comparison behavior

   Comparing a string with a number using > can lead to unexpected results because string comparison is lexicographic. The code should convert page to a number first.

3. Final Answer:

   req.query.page is a string, so numeric comparison may fail -> Option D

4. Quick Check:

   Convert query strings to numbers before numeric checks [OK]

Hint: Convert query strings to numbers before numeric comparisons [OK]

Common Mistakes:

• Not converting query params to numbers
• Assuming req.query.page is a number
• Using req.params instead of req.query incorrectly

5. You want to create an Express route that reads optional query parameters sort and limit. If limit is missing or not a positive number, it should default to 10. Which code snippet correctly implements this behavior?

hard

A. app.get('/data', (req, res) => {
const sort = req.query.sort || 'asc';
const limit = Number(req.query.limit) > 0 ? Number(req.query.limit) : 10;
res.send(`Sort: ${sort}, Limit: ${limit}`);
});

B. app.get('/data', (req, res) => {
const sort = req.query.sort;
const limit = req.query.limit || 10;
res.send(`Sort: ${sort}, Limit: ${limit}`);
});

C. app.get('/data', (req, res) => {
const sort = req.query.sort ?? 'desc';
const limit = parseInt(req.query.limit) || 10;
res.send(`Sort: ${sort}, Limit: ${limit}`);
});

D. app.get('/data', (req, res) => {
const sort = req.query.sort || 'desc';
const limit = req.query.limit > '0' ? req.query.limit : 10;
res.send(`Sort: ${sort}, Limit: ${limit}`);
});

Solution

1. Step 1: Default sort parameter

   Use req.query.sort || 'asc' to default falsy/missing values to 'asc'.

2. Step 2: Validate limit as positive number

   Number(req.query.limit) > 0 ? Number(req.query.limit) : 10 properly converts, checks positivity (>0), and defaults for missing/undefined/NaN/zero/negative.

3. Step 3: Why others fail

   B: No sort default; limit || 10 accepts invalid like '-1'. C: parseInt(req.query.limit) || 10 accepts negatives ('-1' is truthy). D: req.query.limit > '0' does string comparison, accepts invalid like 'a' ("a" > "0").

4. Final Answer:

   Number(req.query.limit) > 0 ? Number(req.query.limit) : 10 -> Option A

5. Quick Check:

   Convert and validate query params before use [OK]

Hint: Always convert and validate query params before use [OK]

Common Mistakes:

• Not converting query params to numbers
• Using || default with parseInt causing wrong defaults
• Comparing strings directly to numbers