توثيق Middleware الخاص بـ intlayer في Express

يقوم الـ middleware الخاص بـ intlayer في Express باكتشاف locale الخاص بالمستخدم ويزوّد دوال الترجمة عبر كائن res.locals. كما يتيح استخدام الدالتين t و getIntlayer في جميع معالجات الطلبات (request handlers) الخاصة بك.

الاستخدام

import express from "express";
import { intlayer } from "express-intlayer";

const app = express();

app.use(intlayer());

app.get("/", (req, res) => {
  const content = res.locals.t({
    ar: "مرحبا",
    en: "Hello",
    fr: "Bonjour",
  });

  res.send(content);
});

الوصف

يقوم الـ middleware بالمهام التالية:

1. كشف اللغة (Locale Detection): يفحص ملفات تعريف الارتباط (cookies)، والرؤوس (مثل Accept-Language)، ومعلمات URL لتحديد لغة المستخدم.
2. إعداد السياق (Context Setup): يقوم بتعبئة res.locals بـ:
   • locale: اللغة المكتشفة.
   • t: دالة ترجمة مرتبطة باللغة المكتشفة.
   • getIntlayer: دالة لاسترجاع القواميس المرتبطة باللغة المكتشفة.
3. التخزين المحلي غير المتزامن: يقوم بإعداد سياق يتيح استخدام الدالتين العالميتين t و getIntlayer المستوردتين من express-intlayer داخل تدفق الطلب.