const Koa = require('koa') // koa v2.xconst convert = require('koa-convert')const app = new Koa()app.use(modernMiddleware)app.use(convert(legacyMiddleware))app.use(convert.compose(legacyMiddleware, modernMiddleware))function * legacyMiddleware (next) { // before yield next // after}function modernMiddleware (ctx, next) { // before return next().then
Distinguish legacy and modern middleware
In koa 0.x and 1.x (without experimental flag), app.use has an assertion that all (legacy) middleware must be generator function and it's tested with fn.constructor.name == 'GeneratorFunction' at here.
Therefore, we can distinguish legacy and modern middleware with fn.constructor.name == 'GeneratorFunction'.
Migration
app.use(legacyMiddleware) is everywhere in 0.x and 1.x and it would be painful to manually change all of them to app.use(convert(legacyMiddleware)).
You can use following snippet to make migration easier.
const _use = app.useapp.use = x => _use.call(app, convert(x))
The above snippet will override app.use method and implicitly convert all legacy generator middleware to modern promise middleware.
Therefore, you can have both app.use(modernMiddleware) and app.use(legacyMiddleware) and your 0.x or 1.x should work without modification.
Complete example:
const Koa = require('koa') // v2.xconst convert = require('koa-convert')const app = new Koa()// ---------- override app.use method ----------const _use = app.useapp.use = x => _use.call(app, convert(x))// ---------- end ----------app.use(modernMiddleware)// this will be converted to modern promise middleware implicitlyapp.use(legacyMiddleware)function * legacyMiddleware (next) { // before yield
API
convert()
Convert legacy generator middleware to modern promise middleware.
modernMiddleware = convert(legacyMiddleware)
convert.compose()
Convert and compose multiple middleware (could mix legacy and modern ones) and return modern promise middleware.