intlayer Fastify プラグインドキュメント

Fastify 用の intlayer プラグインは、ユーザーのロケールを検出し、Intlayer の関数を含むプロパティでリクエストオブジェクトを装飾します。また、リクエストコンテキスト内でグローバルな翻訳関数を使用できるようにします。

使用方法

import Fastify from "fastify";
import { intlayer } from "fastify-intlayer";

const fastify = Fastify();

fastify.register(intlayer);

fastify.get("/", async (req, reply) => {
  const content = req.intlayer.t({
    ja: "こんにちは",
    en: "Hello",
    fr: "Bonjour",
  });

  return content;
});

説明

プラグインは次のタスクを実行します:

1. ロケール検出: リクエスト（ヘッダー、クッキーなど）を分析して、ユーザーの優先ロケールを判定します。
2. Request Decoration: FastifyRequest オブジェクトに intlayer プロパティを追加します。含まれるもの:
   • locale: 検出されたロケール。
   • t: 翻訳関数。
   • getIntlayer: 辞書を取得する関数。
3. コンテキスト管理: 非同期コンテキストを管理するために cls-hooked を使用し、グローバルな Intlayer 関数がリクエスト固有のロケールにアクセスできるようにします。