Registry / web-framework / express-slash

express-slash

JSON →
library2.0.1jsnpmunverified

express-slash is an Express.js middleware designed for web applications that enforce strict routing rules regarding trailing slashes in URLs. It automatically handles `GET` and `HEAD` requests, redirecting clients (with a 301 status code by default) to the canonical URL with or without a trailing slash, based on the application's configured routes and `strict routing` setting. This package ensures URL consistency and prevents 404 errors for users who might incorrectly add or omit trailing slashes. The current stable version is 2.0.1, specifically compatible with Express 4.x. Version 1.x was for Express 3.x. The package has not seen active development in many years, suggesting it is in an abandoned state. While alternatives exist, its direct integration with Express's `strict routing` is a key differentiator for maintaining consistent URL structures programmatically.

web-frameworkhttp-networking
npm install express-slash
github ↗package ↗
INSTALL
IMPORT
SIG · EXPRESS-SLASH
E
express-slash
web-frameworkjavascriptv2.0.1
Install
—
Import
—
Disk
—
Pass rate
0/ 6
Env Coverage0 / 6
glibc
18–22
musl
18–22
Install & Compatibility
Where this runs
tested against v? · npm install
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
node 18–226 runs
build_error
glibc
node 18–226 runs
build_error
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

slash
✓ const slash = require('express-slash');
✗ import slash from 'express-slash';
This package is CommonJS-only. Attempting to use ESM `import` syntax will result in an error.
express
✓ const express = require('express');
✗ import express from 'express';
Express.js itself, which this middleware depends on, is commonly imported via `require` in projects compatible with `express-slash` v2.x.

This quickstart demonstrates how to set up `express-slash` with an Express application, enabling strict routing and ensuring proper trailing slash redirection for defined routes. It highlights the correct order of middleware.

const express = require('express'); const slash = require('express-slash'); const app = express(); // Important: Enable strict routing in Express for this middleware to be effective. app.enable('strict routing'); // Create the router using the same routing options as the app. const router = express.Router({ caseSensitive: app.get('case sensitive routing'), strict : app.get('strict routing') }); // Define some routes. Note the trailing slash on '/about/'. router.get('/', function (req, res) { res.send('Home Page'); }); router.get('/about/', function (req, res) { res.send('About Us'); }); router.get('/contact', function (req, res) { res.send('Contact Page'); }); // Add the `router` middleware first. app.use(router); // Add the `slash()` middleware *after* your app's `router`. // Optionally specify an HTTP status code for redirection (defaults to 301). app.use(slash()); const port = 3000; app.listen(port, () => { console.log(`Server listening on http://localhost:${port}`); console.log(`Try http://localhost:${port}/about (will redirect to /about/)`); console.log(`Try http://localhost:${port}/contact/ (will redirect to /contact)`); });
Debug
Known issues
breakingBreaking changes exist between major versions. `express-slash` v1.x is for Express 3.x, while v2.x is for Express 4.x. Using an incorrect version will lead to compatibility issues or runtime errors.
fix
Ensure `express-slash` v2.x is used for Express 4.x applications. For Express 5.x, this package is not officially supported and may not function as expected due to changes in Express's routing. Consider alternative solutions for newer Express versions.
affects: >=1.0.0
gotchaThe `express-slash` middleware *must* be added after your application's `router` middleware. Placing it before the router will prevent it from correctly identifying and redirecting unmatched routes based on trailing slashes.
fix
Ensure your `app.use(slash())` call appears *after* `app.use(router)` or any other route-defining middleware.
affects: >=1.0.0
gotchaThis middleware requires `app.enable('strict routing')` to be set in your Express application. Without strict routing, Express treats `/path` and `/path/` as the same, making `express-slash` ineffective for its intended purpose.
fix
Add `app.enable('strict routing');` early in your Express application setup.
affects: >=1.0.0
gotchaWhen using multiple routers or mounted paths, ensure that `strict routing` is also enabled on each `express.Router()` instance to prevent unexpected behavior or redirection loops. If a router is mounted with a trailing slash prefix (e.g., `app.use('/series/', seriesRouter)`), but the `seriesRouter` itself doesn't have strict routing enabled or has conflicting slash logic, it can lead to infinite redirects.
fix
When creating a router, pass the `strict` option: `const router = express.Router({ strict: app.get('strict routing') });`
affects: >=1.0.0
deprecatedThe `express-slash` package has not been updated in many years (last publish 12 years ago for version 2.0.1). While it works with Express 4.x, it is not maintained and is unlikely to be compatible with Express 5.x or future versions. Express 5.x itself has improved default handling for strict routing.
fix
For new projects or migration to Express 5.x, consider leveraging Express's built-in `strict routing` options directly or exploring more actively maintained middleware alternatives for trailing slash management. Evaluate if `express-slash` is still necessary given Express 5.x's enhanced defaults and native support for features like async/await in middleware.
affects: >=2.0.0
Errors
Common errors & fixes
TypeError: app.use() requires middleware functions but got a 'Object'
Attempting to use `express-slash` without calling it as a function, e.g., `app.use(slash);` instead of `app.use(slash());`
fix
Always call `express-slash` as a function: `app.use(slash());`
Error: Cannot GET /path (and no redirection occurs)
The `express-slash` middleware is placed *before* the main Express router, or `app.enable('strict routing')` is not set, or the router itself doesn't have strict routing enabled.
fix
Ensure `app.enable('strict routing');` is called, and `app.use(slash());` comes *after* `app.use(router);`. Also, ensure `strict` is set to `true` when creating `express.Router()` instances if not inheriting from `app.get('strict routing')`.
Maximum call stack size exceeded / too many redirects
A redirection loop is occurring, often due to conflicting strict routing settings between the main app and a sub-router, or if `express-slash` is misconfigured with a wildcard route (e.g., `router.get('/:param/'`) where the middleware keeps toggling the slash.
fix
Verify that `strict routing` settings are consistent across `app` and all `express.Router()` instances. Ensure `express-slash` is placed correctly after routers and check for any routes that might conflict with its redirection logic, especially parameterized routes with optional trailing slashes.
Upgrade
Version history
2.0.1latest on npm
Audit
Dependencies
expressrequiredRuntime dependency as a middleware for Express.js. Specific versions of express-slash are tied to major Express versions (v2.x for Express 4.x).
Agent activity
9 hits · last 30 days
node
8
OpenAI (training)
1
Resources
githubhttps://github.com/ericf/express-slash ↗
packagehttps://www.npmjs.com/package/express-slash ↗
express-slash — npm install express-slash · libregistry