Creation:2026-01-21Last update:2026-01-21

    Documentazione del plugin intlayer per Fastify

    Il plugin intlayer per Fastify rileva la locale dell'utente e decora l'oggetto request con le funzioni di Intlayer. Consente inoltre l'uso di funzioni di traduzione globali all'interno del contesto della richiesta.

    Utilizzo

    ts
    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({    it: "Ciao",    en: "Hello",    fr: "Bonjour",  });  return content;});

    Descrizione

    Il plugin esegue le seguenti operazioni:

    1. Rilevamento della locale: Analizza la richiesta (header, cookie, ecc.) per determinare la locale preferita dall'utente.
    2. Decorazione della richiesta: Aggiunge una proprietà intlayer all'oggetto FastifyRequest, contenente:
      • locale: La locale rilevata.
      • t: Una funzione di traduzione.
      • getIntlayer: Una funzione per recuperare i dizionari.
    3. Gestione del contesto: Utilizza cls-hooked per gestire un contesto asincrono, consentendo alle funzioni globali di Intlayer di accedere alla locale specifica della richiesta.