Trailing slash

The trailingSlash option on Mochi.serve() enforces a consistent trailing-slash policy across every user route. The framework registers each route under both /foo and /foo/, then redirects requests to the non-canonical form.

await Mochi.serve({
  trailingSlash: 'always',
  routes,
});

Policy values

Default: unset — neither form is redirected and only the form you registered is matched.

Redirect status codes

308 preserves the request method and body, so <form method="POST" action="/submit"> still works after a redirect.

Paths that are never redirected

• The root path / — already canonical.
• Paths with file extensions (.css, .js, .png, …) — browsers and CDNs expect exact asset URLs.

Query strings

Query parameters are preserved in the redirect target:

GET /search/?q=mochi  →  301  Location: /search?q=mochi   (policy: 'never')
GET /search?q=mochi   →  301  Location: /search/?q=mochi  (policy: 'always')

Generating canonical links

trailingSlashIt(path) appends a trailing slash, first stripping any the string already ends with so you never double-slash. A query string or #fragment is preserved and the slash lands on the path, so you can pass a full URL straight in. Build hrefs with it under trailingSlash: 'always' so links point straight at the canonical URL and skip the redirect hop.

import { trailingSlashIt } from 'mochi-framework';

trailingSlashIt('/docs/intro'); // '/docs/intro/'
trailingSlashIt('/docs/intro/'); // '/docs/intro/'
trailingSlashIt('/'); // '/'
trailingSlashIt('/search?q=mochi'); // '/search/?q=mochi'
trailingSlashIt('/docs/intro#install'); // '/docs/intro/#install'

It is isomorphic — import it in SSR pages, hydrated islands, and plain .ts modules alike.