History has moved to the Releases tab of GitHub.
- Update
path-to-regexp
. Migration path: change usage of'*'
in routes to(.*)
or:splat*
.- Example:
router.get('*', ....)
becomesrouter.get('(.*)') ....)
- Example:
others
- b5dd5e8] - chore: rename to @koa/router (dead-horse)
Changelogs inherit from koa-router.
- Fix router.url() for multiple nested routers #407
layer.name
added toctx
atctx.routerName
during routing #412- Router.use() was erroneously settings
(.*)
as a prefix to all routers nested with .use that did not pass an explicit prefix string as the first argument. This resulted in routes being matched that should not have been, included the running of multiple route handlers in error. #369 and #410 include information on this issue.
- Router#url() now accepts query parameters to add to generated urls #396
- Respond to CORS preflights with 200, 0 length body #359
- Fix a bug in Router#url and append Router object to ctx. #350
- Adds
_matchedRouteName
to context #337 - Respond to CORS preflights with 200, 0 length body #359
- Fix bug where param handlers were run out of order #282
- Backports: merge 5.4 work into the 7.x upstream. See 5.4.0 updates for more details.
- Fix: allowedMethods should be ctx.method not this.method #215
- The API has changed to match the new promise-based middleware signature of koa 2. See the koa 2.x readme for more information.
- Middleware is now always run in the order declared by
.use()
(or.get()
, etc.), which matches Express 4 API.
- Expose matched route at
ctx._matchedRoute
.
- Register multiple routes with array of paths #203.
- Improved router.url() #143
- Adds support for named routes and regular expressions #152
- Add support for custom throw functions for 405 and 501 responses #206
- Fix for middleware running twice when nesting routes #184
- Add support for async/await. Resolves #130.
- Add support for array of paths by Router#use(). Resolves #175.
- Inherit param middleware when nesting routers. Fixes #170.
- Default router middleware without path to root. Fixes #161, #155, #156.
- Run nested router middleware after parent's. Fixes #156.
- Remove dependency on koa-compose.
- Match routes in order they were defined. Fixes #131.
- Support mounting router middleware at a given path.
- Fix bug with missing parameters when nesting routers.
- Remove confusing API for extending koa app with router methods. Router#use() does not have the same behavior as app#use().
- Add support for nesting routes.
- Remove support for regular expression routes to achieve nestable routers and enable future trie-based routing optimizations.
- Do not send 405 if route matched but status is 404. Fixes #112, closes #114.
- Do not run middleware if not yielded to by previous middleware. Fixes #115.
- Add support for router prefixes.
- Add MIT license.
- Fixed issue with router middleware being applied even if no route was matched.
- Router.url - new static method to generate url from url pattern and data
Private API changed to separate context parameter decoration from route
matching. Router#match
and Route#match
are now pure functions that return
an array of routes that match the URL path.
For modules using this private API that need to determine if a method and path
match a route, route.methods
must be checked against the routes returned from
router.match()
:
var matchedRoute = router.match(path).filter(function (route) {
return ~route.methods.indexOf(method);
}).shift();
405, 501, and OPTIONS response handling was moved into separate middleware
router.allowedMethods()
. This resolves incorrect 501 or 405 responses when
using multiple routers.
4.x is mostly backwards compatible with 3.x, except for the following:
- Instantiating a router with
new
andapp
returns the router instance, whereas 3.x returns the router middleware. When creating a router in 4.x, the only time router middleware is returned is when creating using theRouter(app)
signature (withapp
and withoutnew
).