著者:
    Aymeric PINEAU
    作成:2026-08-24最終更新:2026-08-24

    elysia-intlayer パッケージ

    elysia-intlayer パッケージは Elysia アプリケーション向けのプラグインを提供し、国際化を扱います。ユーザーのロケールを検出し、ルートコンテキストに intlayer オブジェクトを注入します。

    インストール

    bash
    npm install elysia-intlayer

    エクスポート

    プラグイン

    インポート:

    tsx
    import { intlayer } from "elysia-intlayer";
    関数 説明 関連ドキュメント
    intlayer Intlayer を Elysia アプリケーションに統合する Elysia プラグイン。ストレージ（クッキー、ヘッダー）からのロケール検出、その後 Accept-Language からの検出を処理し、locale、t、getIntlayer、getDictionary を公開する intlayer オブジェクトをルートコンテキストに注入し、AsyncLocalStorage のリクエストコンテキストをセットアップします。 intlayer

    関数

    インポート:

    tsx
    import { t, getIntlayer, getDictionary } from "elysia-intlayer";
    関数 説明 関連ドキュメント
    t Elysia で現在のロケールのコンテンツを取得するグローバル翻訳関数。intlayer プラグインがセットアップしたリクエストコンテキストに AsyncLocalStorage を通じてアクセスし、その外側ではデフォルトロケールにフォールバックします。intlayer.t からもアクセスできます。 translation
    getIntlayer 生成された宣言からキーで辞書を取得し、現在のロケールのコンテンツを返します。getDictionary の最適化版です。AsyncLocalStorage を使用してリクエストコンテキストにアクセスします。intlayer.getIntlayer からもアクセスできます。 -
    getDictionary 辞書オブジェクトを処理し、現在のロケールのコンテンツを返します。t() 翻訳、列挙、markdown、HTML などを処理します。AsyncLocalStorage を使用してリクエストコンテキストにアクセスします。intlayer.getDictionary からもアクセスできます。 -

    型

    インポート:

    tsx
    import type { IntlayerContext, TranslateFunction } from "elysia-intlayer";
    型 説明
    IntlayerContext すべてのルートコンテキストに注入される intlayer オブジェクトの形: locale、locale_storage、locale_detected、defaultLocale、t、getIntlayer、getDictionary。
    TranslateFunction ロケールマップを現在のリクエストロケールに対応するコンテンツへ変換する翻訳関数のシグネチャ。
    intlayerintlayer