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

    2.1.0 • Public • Published

    koa-connect npm package badge

    Use Express/Connect middleware with Koa.

    Warning

    It is highly recommended to use a Koa-specific middleware instead of trying to convert an Express version when they're available. There is a non-trivial difference in the Koa and Express designs and you will inevitably run into some issues. This module is a workaround for the specific cases where the differences can be ignored. Additionally, it also enables library authors to write 1 version of their HTTP middleware.

    Always use next middleware parameter

    Express middlewares need to declare and invoke the next callback appropriately for the koa-connect integration to work correctly.

    For library authors

    If you're attempting to write a framework-agnostic middleware library, be sure to use only core HTTP methods and not any Express-dependent APIs like res.send.

    Installation

    npm install koa-connect

    Usage

    See examples/ for more practical usage.

    const Koa = require('koa');
    const c2k = require('koa-connect');
     
    // A generic Express-style middleware function
    function connectMiddlware(req, res, next) {
      res.writeHead(200, { 'Content-Type': 'text/plain' });
      res.end('From the Connect middleware');
      next();
    }
     
    // A generic Koa middlware, without async/await
    function koaMiddlware(ctx, next) {
      next()
        .then(() => {
          // The control flow will bubble back to here, like usual
        })
        .catch((err) => {
          // Error handling from downstream middleware, like usual
        });
    }
     
    // A generic Koa middlware with async/await
    async function koaMiddleware(ctx, next) {
      try {
        await next();
      } catch (e) {
        // Normal error handling
      }
      // Normal control flow
    }
     
    const app = new Koa();
    app.use(koaMiddlware);
    app.use(c2k(connectMiddlware));
    app.use((ctx, next) => {
      console.log('It will continue on to here');
    });
     
    app.listen(3000);

    Contributing

    Developing

    npm start starts the TypeScript compiler in watch mode. Code will be auto-formatted upon commit as part of the Prettier + lint-staged + Husky setup.

    Building

    npm run build produces the types declaration file and JavaScript file for publishing.

    Testing

    npm test runs the tests. Tests are in tests.js and are made with the Mocha framework.

    Use npm run test:watch in conjunction with npm start to automatically re-run the tests when the source changes.

    License

    MIT

    Install

    npm i koa-connect

    DownloadsWeekly Downloads

    34,955

    Version

    2.1.0

    License

    MIT

    Unpacked Size

    17.1 kB

    Total Files

    16

    Last publish

    Collaborators

    • lourd
    • vkurchatkin