Creazione:2026-01-21Ultimo aggiornamento: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

    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.