@types/koa-router

Version 7.4.8
Published 1 year ago
20.5 kB
1 dependency
MIT license

Install

npm i @types/koa-router

yarn add @types/koa-router

pnpm add @types/koa-router

Overview

TypeScript definitions for koa-router

Classes

class Layer

class Layer {}

constructor

constructor(
    path: string | RegExp,
    methods: string[],
    middleware: Koa.Middleware<
        StateT,
        CustomT & IRouterParamContext<StateT, CustomT>
    >,
    opts?: ILayerOptions
);

constructor

constructor(
    path: string | RegExp,
    methods: string[],
    middleware: Koa.Middleware<
        StateT,
        CustomT & IRouterParamContext<StateT, CustomT>
    >[],
    opts?: ILayerOptions
);

property methods

methods: string[];

property name

name: string;

property opts

opts: ILayerOptions;

property paramNames

paramNames: ParamName[];

property path

path: string;

property regexp

regexp: RegExp;

property stack

stack: Koa.Middleware<StateT, CustomT & IRouterParamContext<StateT, CustomT>>[];

method captures

captures: (path: string) => string[];

Returns array of regexp url path captures.

method match

match: (path: string) => boolean;

Returns whether request path matches route.

method param

param: (
    param: string,
    fn: Koa.Middleware<StateT, CustomT & IRouterParamContext<StateT, CustomT>>
) => Layer;

Run validations on route named parameters.

method params

params: (
    path: string | RegExp,
    captures: string[],
    existingParams?: Object
) => Object;

Returns map of URL parameters for given path and paramNames.

method setPrefix

setPrefix: (prefix: string) => Layer;

Prefix route path.

method url

url: (params: Object) => string;

Generate URL for route using given params.

class ParamName

class ParamName {}

property asterisk

asterisk: boolean;

property delimiter

delimiter: string;

property name

name: string;

property optional

optional: boolean;

property partial

partial: boolean;

property pattern

pattern: string;

property prefix

prefix: string;

property repeat

repeat: string;

class Router

class Router<StateT = any, CustomT = {}> {}

constructor

constructor(opt?: Router.IRouterOptions);

Create a new router.

property params

params: Object;

property stack

stack: Router.Layer[];

method all

all: {
    (
        name: string,
        path: string | RegExp,
        ...middleware: Array<Router.IMiddleware<StateT, CustomT>>
    ): Router<StateT, CustomT>;
    (
        path: string | RegExp | (string | RegExp)[],
        ...middleware: Koa.Middleware<
            StateT,
            CustomT & Router.IRouterParamContext<StateT, CustomT>
        >[]
    ): Router<StateT, CustomT>;
    <T, U>(
        name: string,
        path: string | RegExp,
        middleware: Koa.Middleware<T, U>,
        routeHandler: Koa.Middleware<
            StateT,
            CustomT & Router.IRouterParamContext<StateT, CustomT>
        >
    ): Router<StateT & T, CustomT & U>;
    <T, U>(
        path: string | RegExp | (string | RegExp)[],
        middleware: Koa.Middleware<T, U>,
        routeHandler: Koa.Middleware<
            StateT,
            CustomT & Router.IRouterParamContext<StateT, CustomT>
        >
    ): Router<StateT & T, CustomT & U>;
};

method allowedMethods

allowedMethods: (
    options?: Router.IRouterAllowedMethodsOptions
) => Koa.Middleware<
    StateT,
    CustomT & Router.IRouterParamContext<StateT, CustomT>
>;

Returns separate middleware for responding to OPTIONS requests with an Allow header containing the allowed methods, as well as responding with 405 Method Not Allowed and 501 Not Implemented as appropriate.

method del

del: {
    (
        name: string,
        path: string | RegExp,
        ...middleware: Array<Router.IMiddleware<StateT, CustomT>>
    ): Router<StateT, CustomT>;
    (
        path: string | RegExp | (string | RegExp)[],
        ...middleware: Koa.Middleware<
            StateT,
            CustomT & Router.IRouterParamContext<StateT, CustomT>
        >[]
    ): Router<StateT, CustomT>;
    <T, U>(
        name: string,
        path: string | RegExp,
        middleware: Koa.Middleware<T, U>,
        routeHandler: Koa.Middleware<
            StateT,
            CustomT & Router.IRouterParamContext<StateT, CustomT>
        >
    ): Router<StateT & T, CustomT & U>;
    <T, U>(
        path: string | RegExp | (string | RegExp)[],
        middleware: Koa.Middleware<T, U>,
        routeHandler: Koa.Middleware<
            StateT,
            CustomT & Router.IRouterParamContext<StateT, CustomT>
        >
    ): Router<StateT & T, CustomT & U>;
};

Alias for router.delete() because delete is a reserved word

method delete

delete: {
    (
        name: string,
        path: string | RegExp,
        ...middleware: Array<Router.IMiddleware<StateT, CustomT>>
    ): Router<StateT, CustomT>;
    (
        path: string | RegExp | (string | RegExp)[],
        ...middleware: Koa.Middleware<
            StateT,
            CustomT & Router.IRouterParamContext<StateT, CustomT>
        >[]
    ): Router<StateT, CustomT>;
    <T, U>(
        name: string,
        path: string | RegExp,
        middleware: Koa.Middleware<T, U>,
        routeHandler: Koa.Middleware<
            StateT,
            CustomT & Router.IRouterParamContext<StateT, CustomT>
        >
    ): Router<StateT & T, CustomT & U>;
    <T, U>(
        path: string | RegExp | (string | RegExp)[],
        middleware: Koa.Middleware<T, U>,
        routeHandler: Koa.Middleware<
            StateT,
            CustomT & Router.IRouterParamContext<StateT, CustomT>
        >
    ): Router<StateT & T, CustomT & U>;
};

HTTP delete method

method get

get: {
    (
        name: string,
        path: string | RegExp,
        ...middleware: Array<Router.IMiddleware<StateT, CustomT>>
    ): Router<StateT, CustomT>;
    (
        path: string | RegExp | (string | RegExp)[],
        ...middleware: Koa.Middleware<
            StateT,
            CustomT & Router.IRouterParamContext<StateT, CustomT>
        >[]
    ): Router<StateT, CustomT>;
    <T, U>(
        name: string,
        path: string | RegExp,
        middleware: Koa.Middleware<T, U>,
        routeHandler: Koa.Middleware<
            StateT,
            CustomT & Router.IRouterParamContext<StateT, CustomT>
        >
    ): Router<StateT & T, CustomT & U>;
    <T, U>(
        path: string | RegExp | (string | RegExp)[],
        middleware: Koa.Middleware<T, U>,
        routeHandler: Koa.Middleware<
            StateT,
            CustomT & Router.IRouterParamContext<StateT, CustomT>
        >
    ): Router<StateT & T, CustomT & U>;
};

HTTP get method

method head

head: {
    (
        name: string,
        path: string | RegExp,
        ...middleware: Array<Router.IMiddleware<StateT, CustomT>>
    ): Router<StateT, CustomT>;
    (
        path: string | RegExp | (string | RegExp)[],
        ...middleware: Koa.Middleware<
            StateT,
            CustomT & Router.IRouterParamContext<StateT, CustomT>
        >[]
    ): Router<StateT, CustomT>;
    <T, U>(
        name: string,
        path: string | RegExp,
        middleware: Koa.Middleware<T, U>,
        routeHandler: Koa.Middleware<
            StateT,
            CustomT & Router.IRouterParamContext<StateT, CustomT>
        >
    ): Router<StateT & T, CustomT & U>;
    <T, U>(
        path: string | RegExp | (string | RegExp)[],
        middleware: Koa.Middleware<T, U>,
        routeHandler: Koa.Middleware<
            StateT,
            CustomT & Router.IRouterParamContext<StateT, CustomT>
        >
    ): Router<StateT & T, CustomT & U>;
};

HTTP head method

method link

link: {
    (
        name: string,
        path: string | RegExp,
        ...middleware: Array<Router.IMiddleware<StateT, CustomT>>
    ): Router<StateT, CustomT>;
    (
        path: string | RegExp | (string | RegExp)[],
        ...middleware: Koa.Middleware<
            StateT,
            CustomT & Router.IRouterParamContext<StateT, CustomT>
        >[]
    ): Router<StateT, CustomT>;
    <T, U>(
        name: string,
        path: string | RegExp,
        middleware: Koa.Middleware<T, U>,
        routeHandler: Koa.Middleware<
            StateT,
            CustomT & Router.IRouterParamContext<StateT, CustomT>
        >
    ): Router<StateT & T, CustomT & U>;
    <T, U>(
        path: string | RegExp | (string | RegExp)[],
        middleware: Koa.Middleware<T, U>,
        routeHandler: Koa.Middleware<
            StateT,
            CustomT & Router.IRouterParamContext<StateT, CustomT>
        >
    ): Router<StateT & T, CustomT & U>;
};

HTTP link method

method match

match: (path: string, method: string) => Router.IRoutesMatch;

Match given path and return corresponding routes.

method middleware

middleware: () => Koa.Middleware<
    StateT,
    CustomT & Router.IRouterParamContext<StateT, CustomT>
>;

Returns router middleware which dispatches a route matching the request.

method options

options: {
    (
        name: string,
        path: string | RegExp,
        ...middleware: Array<Router.IMiddleware<StateT, CustomT>>
    ): Router<StateT, CustomT>;
    (
        path: string | RegExp | (string | RegExp)[],
        ...middleware: Koa.Middleware<
            StateT,
            CustomT & Router.IRouterParamContext<StateT, CustomT>
        >[]
    ): Router<StateT, CustomT>;
    <T, U>(
        name: string,
        path: string | RegExp,
        middleware: Koa.Middleware<T, U>,
        routeHandler: Koa.Middleware<
            StateT,
            CustomT & Router.IRouterParamContext<StateT, CustomT>
        >
    ): Router<StateT & T, CustomT & U>;
    <T, U>(
        path: string | RegExp | (string | RegExp)[],
        middleware: Koa.Middleware<T, U>,
        routeHandler: Koa.Middleware<
            StateT,
            CustomT & Router.IRouterParamContext<StateT, CustomT>
        >
    ): Router<StateT & T, CustomT & U>;
};

HTTP options method

method param

param: (
    param: string,
    middleware: Router.IParamMiddleware<StateT, CustomT>
) => Router<StateT, CustomT>;

Run middleware for named route parameters. Useful for auto-loading or validation.

method patch

patch: {
    (
        name: string,
        path: string | RegExp,
        ...middleware: Array<Router.IMiddleware<StateT, CustomT>>
    ): Router<StateT, CustomT>;
    (
        path: string | RegExp | (string | RegExp)[],
        ...middleware: Koa.Middleware<
            StateT,
            CustomT & Router.IRouterParamContext<StateT, CustomT>
        >[]
    ): Router<StateT, CustomT>;
    <T, U>(
        name: string,
        path: string | RegExp,
        middleware: Koa.Middleware<T, U>,
        routeHandler: Koa.Middleware<
            StateT,
            CustomT & Router.IRouterParamContext<StateT, CustomT>
        >
    ): Router<StateT & T, CustomT & U>;
    <T, U>(
        path: string | RegExp | (string | RegExp)[],
        middleware: Koa.Middleware<T, U>,
        routeHandler: Koa.Middleware<
            StateT,
            CustomT & Router.IRouterParamContext<StateT, CustomT>
        >
    ): Router<StateT & T, CustomT & U>;
};

HTTP patch method

method post

post: {
    (
        name: string,
        path: string | RegExp,
        ...middleware: Array<Router.IMiddleware<StateT, CustomT>>
    ): Router<StateT, CustomT>;
    (
        path: string | RegExp | (string | RegExp)[],
        ...middleware: Koa.Middleware<
            StateT,
            CustomT & Router.IRouterParamContext<StateT, CustomT>
        >[]
    ): Router<StateT, CustomT>;
    <T, U>(
        name: string,
        path: string | RegExp,
        middleware: Koa.Middleware<T, U>,
        routeHandler: Koa.Middleware<
            StateT,
            CustomT & Router.IRouterParamContext<StateT, CustomT>
        >
    ): Router<StateT & T, CustomT & U>;
    <T, U>(
        path: string | RegExp | (string | RegExp)[],
        middleware: Koa.Middleware<T, U>,
        routeHandler: Koa.Middleware<
            StateT,
            CustomT & Router.IRouterParamContext<StateT, CustomT>
        >
    ): Router<StateT & T, CustomT & U>;
};

HTTP post method

method prefix

prefix: (prefix: string) => Router<StateT, CustomT>;

Set the path prefix for a Router instance that was already initialized.

method put

put: {
    (
        name: string,
        path: string | RegExp,
        ...middleware: Array<Router.IMiddleware<StateT, CustomT>>
    ): Router<StateT, CustomT>;
    (
        path: string | RegExp | (string | RegExp)[],
        ...middleware: Koa.Middleware<
            StateT,
            CustomT & Router.IRouterParamContext<StateT, CustomT>
        >[]
    ): Router<StateT, CustomT>;
    <T, U>(
        name: string,
        path: string | RegExp,
        middleware: Koa.Middleware<T, U>,
        routeHandler: Koa.Middleware<
            StateT,
            CustomT & Router.IRouterParamContext<StateT, CustomT>
        >
    ): Router<StateT & T, CustomT & U>;
    <T, U>(
        path: string | RegExp | (string | RegExp)[],
        middleware: Koa.Middleware<T, U>,
        routeHandler: Koa.Middleware<
            StateT,
            CustomT & Router.IRouterParamContext<StateT, CustomT>
        >
    ): Router<StateT & T, CustomT & U>;
};

HTTP put method

method redirect

redirect: (
    source: string,
    destination: string,
    code?: number
) => Router<StateT, CustomT>;

Redirect source to destination URL with optional 30x status code.
Both source and destination can be route names.

method register

register: (
    path: string | RegExp,
    methods: string[],
    middleware:
        | Router.IMiddleware<StateT, CustomT>
        | Array<Router.IMiddleware<StateT, CustomT>>,
    opts?: Router.ILayerOptions
) => Router.Layer;

Create and register a route.

method route

route: { (name: string): Router.Layer; (name: string): boolean };

Lookup route with given name.

method routes

routes: () => Koa.Middleware<
    StateT,
    CustomT & Router.IRouterParamContext<StateT, CustomT>
>;

Returns router middleware which dispatches a route matching the request.

method unlink

unlink: {
    (
        name: string,
        path: string | RegExp,
        ...middleware: Array<Router.IMiddleware<StateT, CustomT>>
    ): Router<StateT, CustomT>;
    (
        path: string | RegExp | (string | RegExp)[],
        ...middleware: Koa.Middleware<
            StateT,
            CustomT & Router.IRouterParamContext<StateT, CustomT>
        >[]
    ): Router<StateT, CustomT>;
    <T, U>(
        name: string,
        path: string | RegExp,
        middleware: Koa.Middleware<T, U>,
        routeHandler: Koa.Middleware<
            StateT,
            CustomT & Router.IRouterParamContext<StateT, CustomT>
        >
    ): Router<StateT & T, CustomT & U>;
    <T, U>(
        path: string | RegExp | (string | RegExp)[],
        middleware: Koa.Middleware<T, U>,
        routeHandler: Koa.Middleware<
            StateT,
            CustomT & Router.IRouterParamContext<StateT, CustomT>
        >
    ): Router<StateT & T, CustomT & U>;
};

HTTP unlink method

method url

static url: (path: string | RegExp, params: Object) => string;

Generate URL for route. Takes either map of named params or series of arguments (for regular expression routes)
router = new Router(); router.get('user', "/users/:id", ...
router.url('user', { id: 3 }); // => "/users/3"
Query can be generated from third argument:
router.url('user', { id: 3 }, { query: { limit: 1 } }); // => "/users/3?limit=1"
router.url('user', { id: 3 }, { query: "limit=1" }); // => "/users/3?limit=1"
Generate URL from url pattern and given params.

method use

use: {
    (...middleware: Array<Router.IMiddleware<StateT, CustomT>>): Router<
        StateT,
        CustomT
    >;
    (
        path: string | RegExp | string[],
        ...middleware: Koa.Middleware<
            StateT,
            CustomT & Router.IRouterParamContext<StateT, CustomT>
        >[]
    ): Router<StateT, CustomT>;
};

Use given middleware.
Middleware run in the order they are defined by .use(). They are invoked sequentially, requests start at the first middleware and work their way "down" the middleware stack.

Interfaces

interface ILayerOptions

interface ILayerOptions {}

property end

end?: boolean | undefined;

property ignoreCaptures

ignoreCaptures?: boolean | undefined;

property name

name: string;

property prefix

prefix?: string | undefined;

property sensitive

sensitive?: boolean | undefined;

property strict

strict?: boolean | undefined;

interface IParamMiddleware

interface IParamMiddleware<STateT = any, CustomT = {}> {}

call signature

(
    param: string,
    ctx: RouterContext<STateT, CustomT>,
    next: () => Promise<any>
): any;

interface IRouterAllowedMethodsOptions

interface IRouterAllowedMethodsOptions {}

property methodNotAllowed

methodNotAllowed?: (() => any) | undefined;

throw the returned value in place of the default MethodNotAllowed error

property notImplemented

notImplemented?: (() => any) | undefined;

throw the returned value in place of the default NotImplemented error

property throw

throw?: boolean | undefined;

throw error instead of setting status and header

interface IRouterContext

interface IRouterContext extends RouterContext {}

interface IRouterOptions

interface IRouterOptions {}

property methods

methods?: string[] | undefined;

Methods which should be supported by the router.

property prefix

prefix?: string | undefined;

Prefix for all routes.

property routerPath

routerPath?: string | undefined;

property sensitive

sensitive?: boolean | undefined;

Whether or not routing should be case-sensitive.

property strict

strict?: boolean | undefined;

Whether or not routes should matched strictly.
If strict matching is enabled, the trailing slash is taken into account when matching routes.

interface IRouterParamContext

interface IRouterParamContext<StateT = any, CustomT = {}> {}

property params

params: Record<string, string>;

url params

property router

router: Router<StateT, CustomT>;

the router instance

interface IRoutesMatch

interface IRoutesMatch {}

property path

path: Layer[];

property pathAndMethod

pathAndMethod: Layer[];

property route

route: boolean;

interface IUrlOptionsQuery

interface IUrlOptionsQuery {}

property query

query: object | string;

Type Aliases

type IMiddleware

type IMiddleware<StateT = any, CustomT = {}> = Koa.Middleware<
    StateT,
    CustomT & IRouterParamContext<StateT, CustomT>
>;

type RouterContext

type RouterContext<StateT = any, CustomT = {}> = Koa.ParameterizedContext<
    StateT,
    CustomT & IRouterParamContext<StateT, CustomT>
>;

Package Files (1)

index.d.ts

Dependencies (1)

@types/koa

Dev Dependencies (0)

No dev dependencies.

Peer Dependencies (0)

No peer dependencies.

Badge

To add a badge like this oneto your package's README, use the codes available below.

You may also use Shields.io to create a custom badge linking to https://www.jsdocs.io/package/@types/koa-router.

Markdown

[![jsDocs.io](https://img.shields.io/badge/jsDocs.io-reference-blue)](https://www.jsdocs.io/package/@types/koa-router)

HTML

<a href="https://www.jsdocs.io/package/@types/koa-router"><img src="https://img.shields.io/badge/jsDocs.io-reference-blue" alt="jsDocs.io"></a>

Updated 1 year ago.
Package analyzed in 2626 ms.
Missing or incorrect documentation? Open an issue for this package.

@types/koa-router

Install

Overview

Index

Classes

Interfaces

Type Aliases

Classes

class Layer

constructor

constructor

property methods

property name

property opts

property paramNames

property path

property regexp

property stack

method captures

method match

method param

method params

method setPrefix

method url

class ParamName

property asterisk

property delimiter

property name

property optional

property partial

property pattern

property prefix

property repeat

class Router

constructor

property params

property stack

method all

method allowedMethods

method del

method delete

method get

method head

method link

method match

method middleware

method options

method param

method patch

method post

method prefix

method put

method redirect

method register

method route

method routes

method unlink

method url

method use

Interfaces

interface ILayerOptions

property end

property ignoreCaptures

property name

property prefix

property sensitive

property strict

interface IParamMiddleware

call signature

interface IRouterAllowedMethodsOptions

property methodNotAllowed

property notImplemented

property throw

interface IRouterContext

interface IRouterOptions

property methods

property prefix

property routerPath

property sensitive

property strict