Nocturnal Prancing Mosquito

    tkoa
    TypeScript icon, indicating that this package has built-in type declarations

    1.0.1 • Public • Published

    tkoa logo

    🌈 Tkoa is a Koa web app framework written in typescript. typescript logo

    Although written in typescript, you can still use the nodejs framework and koa middleware.

    Not only that, you can also enjoy the type checking and convenient testing with typescript!

    Installation

    TKoa requires >= typescript v3.1.0 and node v7.6.0 for ES2015 and async function support.

    $ npm install tkoa

    Hello T-koa

    import tKoa = require('tkoa');
     
    interface ctx {
        res: {
            end: Function
        }
    }
     
    const app = new tKoa();
     
    // response
    app.use((ctx: ctx) => {
        ctx.res.end('Hello T-koa!');
    });
     
    app.listen(3000);

    Middleware

    Tkoa is a middleware framework that can take two different kinds of functions as middleware:

    • async function
    • common function

    Here is an example of logger middleware with each of the different functions:

    async functions (node v7.6+):

    interface ctx {
      method: string,
      url: string
    }
     
    app.use(async (ctx: ctx, next: Function) => {
      const start = Date.now();
      await next();
      const ms = Date.now() - start;
      console.log(`${ctx.method} ${ctx.url} - ${ms}ms`);
    });

    Common function

    // Middleware normally takes two parameters (ctx, next), ctx is the context for one request,
    // next is a function that is invoked to execute the downstream middleware. It returns a Promise with a then function for running code after completion.
     
    interface ctx {
      method: string,
      url: string
    }
     
    app.use((ctx: ctx, next: Function) => {
      const start = Date.now();
      return next().then(() => {
        const ms = Date.now() - start;
        console.log(`${ctx.method} ${ctx.url} - ${ms}ms`);
      });
    });

    Getting started

    Support

    TypeScript

    • Higher than version v3.1

    Node.js

    • Higher than version v7.6.0

    License

    MIT

    Install

    npm i tkoa

    DownloadsWeekly Downloads

    0

    Version

    1.0.1

    License

    MIT

    Unpacked Size

    97.3 kB

    Total Files

    13

    Last publish

    Collaborators

    • billdong