Express.js and Mongoose: Handling Duplicate Query Parameters in Pagination

Query Parsing Interoperability

Express 4.x uses the qs library by default to parse req.query, which supports extended syntax for nested objects and arrays. When building paginated endpoints, pagination parameters like limit and page are typically extracted from this object and passed to Mongoose limit() and skip() methods.

Type Mismatch with Duplicate Keys

A specific behavior occurs when a client sends duplicate keys in the query string (e.g., ?limit=10&limit=20). In this scenario, the default Express parser transforms req.query.limit into an array of strings ['10', '20'] rather than a single primitive value.

Because Mongoose expects a number for the limit() method, passing this parsed array directly can lead to runtime type errors or inconsistent results depending on the specific ORM version and MongoDB driver.

• How does Mongoose handle an array of strings when passed to the limit() method?
• Is there a documented way to configure the Express query parser to enforce single-value primitives for specific keys while maintaining nested object support for others?