Validating route params and query in Express

Introduction

We check route parameters and query data to make sure they are correct before using them. This helps avoid errors and keeps the app safe.

When you want to make sure a user ID in the URL is a number.

When you need to confirm a search query is not empty.

When you want to check that a date parameter is in the right format.

When you want to prevent invalid or harmful data from reaching your app.

When you want to give clear error messages if input is wrong.

Syntax

Express

app.get('/path/:param', (req, res) => {
  const param = req.params.param;
  const queryValue = req.query.key;

  // Validate param and queryValue here

  if (/* validation fails */) {
    return res.status(400).send('Invalid input');
  }

  res.send('Valid input');
});

Route params come from req.params and query strings come from req.query.

Validation is usually done inside the route handler before using the data.

Examples

This checks if the id param is only digits.

Express

app.get('/user/:id', (req, res) => {
  const id = req.params.id;
  if (!/^[0-9]+$/.test(id)) {
    return res.status(400).send('User ID must be a number');
  }
  res.send(`User ID is ${id}`);
});

This ensures the query term is not empty or missing.

Express

app.get('/search', (req, res) => {
  const term = req.query.term;
  if (!term || term.trim() === '') {
    return res.status(400).send('Search term is required');
  }
  res.send(`Searching for ${term}`);
});

This validates the date param matches the format YYYY-MM-DD.

Express

app.get('/event/:date', (req, res) => {
  const date = req.params.date;
  if (!/^\d{4}-\d{2}-\d{2}$/.test(date)) {
    return res.status(400).send('Date must be YYYY-MM-DD');
  }
  res.send(`Event date is ${date}`);
});

Sample Program

This Express app has a route that checks if the product ID is a number and if the optional color query is one of the allowed colors. It sends an error if validation fails.

Express

import express from 'express';
const app = express();
const port = 3000;

app.get('/product/:productId', (req, res) => {
  const productId = req.params.productId;
  const color = req.query.color;

  // Validate productId is a number
  if (!/^[0-9]+$/.test(productId)) {
    return res.status(400).send('Product ID must be a number');
  }

  // Validate color is one of allowed values
  const allowedColors = ['red', 'blue', 'green'];
  if (color && !allowedColors.includes(color.toLowerCase())) {
    return res.status(400).send('Color must be red, blue, or green');
  }

  res.send(`Product ID: ${productId}, Color: ${color || 'default'}`);
});

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

Important Notes

Always validate both route params and query strings to avoid unexpected errors.

Use regular expressions or simple checks to validate formats and allowed values.

Send clear error messages with status 400 when input is invalid.

Summary

Validate route params from req.params and query strings from req.query.

Use simple checks or regex to confirm data is correct before using it.

Return a 400 error with a helpful message if validation fails.

Practice

1. What is the main reason to validate route parameters and query strings in an Express app?

easy

A. To automatically generate HTML pages

B. To speed up the server response time

C. To ensure the data is correct and prevent errors or security issues

D. To change the URL structure dynamically

Solution

1. Step 1: Understand the role of validation

   Validation checks if the data coming from the user is correct and safe to use.

2. Step 2: Identify the benefits of validation

   It prevents errors in the app and protects against malicious input that could cause security problems.

3. Final Answer:

   To ensure the data is correct and prevent errors or security issues -> Option C

4. Quick Check:

   Validation = prevent errors and security risks [OK]

Hint: Validation protects your app from bad or harmful input [OK]

Common Mistakes:

• Thinking validation speeds up the server
• Confusing validation with UI rendering
• Believing validation changes URLs automatically

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

easy

A. req.route.id

B. req.query.id

C. req.body.id

D. req.params.id

Solution

1. Step 1: Recall Express request object properties

   Route parameters are accessed via req.params.

2. Step 2: Match the parameter name

   To get the id parameter, use req.params.id.

3. Final Answer:

   req.params.id -> Option D

4. Quick Check:

   Route params = req.params [OK]

Hint: Route params are always in req.params, not req.query [OK]

Common Mistakes:

• Using req.query for route params
• Trying to get params from req.body without POST data
• Using req.route which is not for params

3. Consider this Express route handler:

app.get('/user/:id', (req, res) => {
  const id = req.params.id;
  if (!/^\d+$/.test(id)) {
    return res.status(400).send('Invalid ID');
  }
  res.send(`User ID is ${id}`);
});

What will be the response if the URL is /user/abc123?

medium

A. User ID is abc123

B. Invalid ID

C. 404 Not Found

D. 500 Internal Server Error

Solution

1. Step 1: Understand the regex validation

   The regex ^\d+$ matches only digits from start to end.

2. Step 2: Check the input against regex

   The input abc123 contains letters, so it fails the test.

3. Step 3: Identify the response on failure

   The code returns status 400 with message 'Invalid ID' when validation fails.

4. Final Answer:

   Invalid ID -> Option B

5. Quick Check:

   Non-digit ID triggers 400 error [OK]

Hint: Regex test fails non-digit IDs, returns 400 error [OK]

Common Mistakes:

• Assuming letters pass the digit-only regex
• Expecting 404 instead of 400 error
• Thinking it returns the ID even if invalid

4. Given this Express route:

app.get('/search', (req, res) => {
  const { term } = req.query;
  if (!term || term.length < 3) {
    res.status(400).send('Search term too short');
  }
  res.send(`Searching for ${term}`);
});

What is the bug in this code?

medium

A. It does not return after sending 400 response, causing headers error

B. It does not check if term is a string

C. It uses req.params instead of req.query

D. It should use POST method instead of GET

Solution

1. Step 1: Analyze the validation logic

   If term is missing or too short, it sends a 400 response.

2. Step 2: Check flow after sending response

   There is no return after res.status(400).send(), so code continues and tries to send another response.

3. Step 3: Identify the error caused

   Sending two responses causes an error about headers already sent.

4. Final Answer:

   It does not return after sending 400 response, causing headers error -> Option A

5. Quick Check:

   Always return after sending error response [OK]

Hint: Return immediately after sending error response [OK]

Common Mistakes:

• Missing return after res.send causes crash
• Confusing req.params with req.query
• Thinking GET cannot have query params

5. You want to validate both a route parameter userId (must be a number) and a query parameter active (must be 'true' or 'false') in Express. Which code snippet correctly validates both and returns 400 errors if invalid?

hard

A. app.get('/user/:userId', (req, res) => {
const { userId } = req.params;
const { active } = req.query;
if (!/^\d+$/.test(userId)) {
return res.status(400).send('Invalid userId');
}
if (active !== 'true' && active !== 'false') {
return res.status(400).send('Invalid active flag');
}
res.send(`User ${userId} active: ${active}`);
});

B. app.get('/user/:userId', (req, res) => {
const userId = Number(req.params.userId);
const active = req.query.active === true;
if (!userId) {
res.status(400).send('Invalid userId');
}
if (active !== true && active !== false) {
res.status(400).send('Invalid active flag');
}
res.send(`User ${userId} active: ${active}`);
});

C. app.get('/user/:userId', (req, res) => {
const { userId, active } = req.params;
if (isNaN(userId)) {
return res.status(400).send('Invalid userId');
}
if (active !== 'true' || active !== 'false') {
return res.status(400).send('Invalid active flag');
}
res.send(`User ${userId} active: ${active}`);
});

D. app.get('/user/:userId', (req, res) => {
const userId = req.params.userId;
const active = req.query.active;
if (typeof userId !== 'number') {
return res.status(400).send('Invalid userId');
}
if (active !== 'true' && active !== 'false') {
return res.status(400).send('Invalid active flag');
}
res.send(`User ${userId} active: ${active}`);
});

Solution

1. Step 1: Validate userId as digits string

   uses regex ^\d+$ on req.params.userId, correctly checking it is numeric string.

2. Step 2: Validate active query param as 'true' or 'false'

   checks active equals 'true' or 'false' strings, returning 400 if not.

3. Step 3: Confirm proper returns after errors

   uses return after sending 400 responses, preventing multiple sends.

4. Final Answer:

   Correctly validates both parameters and returns errors properly -> Option A

5. Quick Check:

   Regex + strict string checks + return after error = correct [OK]

Hint: Use regex for numbers and strict string checks for query params [OK]

Common Mistakes:

• Not returning after res.status(400).send
• Checking query params in req.params
• Using loose type checks instead of strict string comparison