FastifyのHooks

FastifyにはHooksといってイベント発火時に任意の処理を実行できる仕組みがある。

イベントの種類は次の通り

onRequest

preParsing

preValidation

preHandler

preSerialization

onError

onSend

onResponse

onTimeout

Hookからレスポンスを返して、それ以降のライフサイクルを止めることもできる。

ライフサイクル: The Fastify team「Lifecycle」

Hookからレスポンスを返す際には注意点がある。以下の注意点を守らないと、

レスポンスを返した後もライフサイクルが続く・止まらなくなることがある。

リクエストに対する処理が2回実行されることがある（例えばデータベースのトランザクションが2回実行されると困る）。

注意点の内容

The Fastify team「Hooks」

Promise を返さない関数を使う場合、 reply.send() を呼び出してレスポンスを返す。

Promise を返す関数を使う場合、

reply.send() を呼び出してレスポンスを返す。

reply.send() の呼び出しがpromiseチェーンに含まれていない場合、それを呼び出した後に return reply する。

return する前に・promiseが解決される前に reply.send() する。

Promise を返さない関数を使ったHookと Promise を返す関数を使ったHookを混ぜてはいけない。

Streamで返したければ Promise を返す関数を使わないほうが良い。

Hookはスコープごとに設定することができる。