생성:2026-01-21마지막 업데이트:2026-01-21

    intlayer Express 미들웨어 문서

    Express용 intlayer 미들웨어는 사용자의 로케일을 감지하고 res.locals 객체를 통해 번역 함수를 제공합니다. 또한 요청 핸들러 전반에서 tgetIntlayer 함수를 사용할 수 있게 해줍니다.

    사용법

    import express from "express";
    import { intlayer } from "express-intlayer";
    
    const app = express();
    
    app.use(intlayer());
    
    app.get("/", (req, res) => {
      const content = res.locals.t({
        en: "Hello",
        fr: "Bonjour",
      });
    
      res.send(content);
    });

    설명

    이 미들웨어는 다음 작업을 수행합니다:

    1. 로케일 감지: 쿠키, 헤더(Accept-Language 등), 및 URL 매개변수를 확인하여 사용자의 로케일을 결정합니다.
    2. 컨텍스트 설정: res.locals를 다음으로 채웁니다:
      • locale: 감지된 로케일.
      • t: 감지된 로케일에 바인딩된 번역 함수.
      • getIntlayer: 감지된 로케일에 바인딩된 사전을 가져오는 함수.
    3. Async Local Storage: 요청 흐름 내에서 express-intlayer에서 가져온 전역 tgetIntlayer 함수를 사용할 수 있도록 컨텍스트를 설정합니다.