Criação:2026-01-29Última atualização:2026-01-29

    Documentação do Middleware Hono intlayer

    O middleware intlayer para Hono detecta a localidade do usuário e preenche o objeto de contexto com funções Intlayer. Ele também permite o uso de funções de tradução globais dentro do contexto da solicitação.

    Uso

    import { Hono } from "hono";
    import { intlayer } from "hono-intlayer";
    
    const app = new Hono();
    
    app.use("*", intlayer());
    
    app.get("/", async (c) => {
      const t = c.get("t");
      const content = t({
        en: "Hello",
        fr: "Bonjour",
        pt: "Olá",
      });
    
      return c.text(content);
    });

    Descrição

    O middleware executa as seguintes tarefas:

    1. Detecção de Localidade: Analisa a solicitação (cabeçalhos, cookies, etc.) para determinar a localidade preferida do usuário.
    2. Preenchimento do Contexto: Adiciona dados do Intlayer ao contexto Hono, acessíveis via c.get(). Isso inclui:
      • locale: A localidade detectada.
      • t: Uma função de tradução.
      • getIntlayer: Uma função para recuperar dicionários.
      • getDictionary: Uma função para processar objetos de dicionário.
    3. Gerenciamento de Contexto: Usa cls-hooked para gerenciar um contexto assíncrono, permitindo que as funções globais do Intlayer (t, getIntlayer, getDictionary) acessem a localidade específica da solicitação sem passar o objeto de contexto.