Fastify 中間件

中間件

Fastify 提供了一個(gè)開(kāi)箱即用的異步中間件引擎。它兼容 Express 與 Restify 的中間件。

想知道中間件何時(shí)執(zhí)行，請(qǐng)看生命周期一文。

Fastify 的中間件不支持 middleware(err, req, res, next) 這一完整語(yǔ)法，因?yàn)殄e(cuò)誤在 Fastify 內(nèi)部就被解決了。 此外，Express 和 Restify 添加在 req 和 res 對(duì)象之上的方法，F(xiàn)astify 也不支持。

假如你使用一個(gè)打包了多個(gè)更小的中間件的中間件，例如 helmet，為了性能考慮，我們建議你使用單個(gè)模塊：

fastify.use(require('cors')())
fastify.use(require('dns-prefetch-control')())
fastify.use(require('frameguard')())
fastify.use(require('hide-powered-by')())
fastify.use(require('hsts')())
fastify.use(require('ienoopen')())
fastify.use(require('x-xss-protection')())

或者，在這個(gè) helmet 的例子中，你可以使用針對(duì) Fastify 和 helmet 的整合做了優(yōu)化的 fastify-helmet 插件：

const fastify = require('fastify')()
const helmet = require('fastify-helmet')

fastify.register(helmet)

請(qǐng)記住，中間件能被封裝。這就意味著你可以通過(guò)使用 register 來(lái)決定中間件該在何處運(yùn)行，正如插件指南一文所述。

Fastify 中間件不會(huì)暴露 send 等 Fastify 的 Reply 實(shí)例上專屬的方法。這是因?yàn)?，雖然 Fastify 使用 Request 和 Reply 對(duì)象包裹了 Node 原生的 req 和 res 實(shí)例，但是它們的處理要在中間件階段之后。因此，在一個(gè)中間件里，你必須使用 Node 原生的 req 和 res 對(duì)象。要使用 Fastify 的 Request 與 Reply 實(shí)例，你可以通過(guò) preHandler 鉤子。更多信息，請(qǐng)看鉤子。

將中間件限定在特定的路徑執(zhí)行

如果你只想在某些路徑下運(yùn)行一個(gè)中間件，只需將路徑作為 use 的第一個(gè)參數(shù)傳遞即可！

注意，該做法不支持參數(shù)路由 (例如：/user/:id/comments)，且在多個(gè)路徑中不能使用通配符。

const path = require('path')
const serveStatic = require('serve-static')

// 單個(gè)路徑
fastify.use('/css', serveStatic(path.join(__dirname, '/assets')))

// 通配符路徑
fastify.use('/css/*', serveStatic(path.join(__dirname, '/assets')))

// 多個(gè)路徑
fastify.use(['/css', '/js'], serveStatic(path.join(__dirname, '/assets')))

Express 中間件兼容性

Express 很大程度上修改了 Node 原生的 Request 和 Response 對(duì)象，所以 Fastify 無(wú)法確保中間件一定完全兼容。一些 Express 特殊的功能，例如 res.sendFile()、res.send() 或者 express.Router() 的實(shí)例將無(wú)法在 Fastify 中正常工作。舉個(gè)例子，cors 可以正常兼容但是 passport 就不可以。