express-intlayer: JavaScript Пакет для интернационализации (i18n) приложения Express.js

Intlayer — это набор пакетов, специально разработанных для JavaScript-разработчиков. Он совместим с такими фреймворками, как React, Next.js и Express.js.

Пакет express-intlayer позволяет интернационализировать ваше приложение Express.js. Он предоставляет middleware для определения предпочтительного языка пользователя и возвращает соответствующий словарь для пользователя.

Зачем интернационализировать ваш бэкенд?

Интернационализация вашего бэкенда необходима для эффективного обслуживания глобальной аудитории. Это позволяет вашему приложению предоставлять контент и сообщения на предпочтительном языке каждого пользователя. Эта возможность улучшает пользовательский опыт и расширяет охват вашего приложения, делая его более доступным и релевантным для людей с разным языковым фоном.

Практические примеры использования

Отображение ошибок бэкенда на языке пользователя: Когда происходит ошибка, отображение сообщений на родном языке пользователя улучшает понимание и снижает уровень разочарования. Это особенно полезно для динамических сообщений об ошибках, которые могут отображаться в компонентах фронтенда, таких как тосты или модальные окна.
Получение многоязычного контента: Для приложений, извлекающих контент из базы данных, интернационализация гарантирует, что вы можете предоставлять этот контент на нескольких языках. Это важно для таких платформ, как сайты электронной коммерции или системы управления контентом, которые должны отображать описания продуктов, статьи и другой контент на языке, предпочитаемом пользователем.
Отправка многоязычных писем: Будь то транзакционные письма, маркетинговые кампании или уведомления, отправка писем на языке получателя может значительно повысить вовлеченность и эффективность.
Многоязычные push-уведомления: Для мобильных приложений отправка push-уведомлений на предпочтительном языке пользователя может повысить взаимодействие и удержание. Этот персонализированный подход делает уведомления более релевантными и действенными.
Другие виды коммуникации: Любая форма коммуникации с бэкенда, такая как SMS-сообщения, системные оповещения или обновления пользовательского интерфейса, выигрывает от использования языка пользователя, обеспечивая ясность и улучшая общий пользовательский опыт.

Интернационализируя бэкенд, ваше приложение не только уважает культурные различия, но и лучше соответствует потребностям глобального рынка, что делает это ключевым шагом в масштабировании ваших услуг по всему миру.

Почему стоит интегрировать Intlayer?

Среда с типобезопасностью: Используйте TypeScript, чтобы гарантировать, что все ваши определения контента точны и не содержат ошибок.

Установка

Установите необходимый пакет с помощью предпочитаемого менеджера пакетов:

bash

npm install express-intlayer

bash

yarn add express-intlayer

bash

pnpm add express-intlayer

Настройка Intlayer

Intlayer предоставляет файл конфигурации для настройки вашего проекта. Разместите этот файл в корневой директории вашего проекта.

intlayer.config.ts

import { Locales, type IntlayerConfig } from "intlayer";const config: IntlayerConfig = {  internationalization: {    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],    defaultLocale: Locales.ENGLISH,  },};export default config;

Для полного списка доступных параметров обратитесь к документации по конфигурации.

Пример использования

Настройте ваше приложение Express для использования express-intlayer:

src/index.ts

// Импорт библиотекimport express, { type Express } from "express";import { intlayer, t } from "express-intlayer";const app: Express = express();// Загрузка обработчика запросов интернационализацииapp.use(intlayer());// Маршрутыapp.get("/", (_req, res) => {  res.send(    t({      en: "Example of returned content in English",      fr: "Exemple de contenu renvoyé en français",      "es-ES": "Ejemplo de contenido devuelto en español (España)",      "es-MX": "Ejemplo de contenido devuelto en español (México)",      ru: "Пример возвращаемого контента на русском",    })  );});// Запуск сервераapp.listen(3000, () => console.log(`Слушаем порт 3000`));

Совместимость

express-intlayer полностью совместим с:

react-intlayer для React приложений
next-intlayer для Next.js приложений
vite-intlayer для Vite приложений

Он также бесшовно работает с любым решением для интернационализации в различных средах, включая браузеры и API-запросы. Вы можете настроить middleware для определения языка через заголовки или cookies:

intlayer.config.ts

import { Locales, type IntlayerConfig } from "intlayer";const config: IntlayerConfig = {  // ... Другие параметры конфигурации  middleware: {    headerName: "my-locale-header",    cookieName: "my-locale-cookie",  },};export default config;

По умолчанию express-intlayer будет интерпретировать заголовок Accept-Language для определения предпочтительного языка клиента.

Функции, предоставляемые пакетом express-intlayer

t()

Если у вас есть идея по улучшению этой документации, не стесняйтесь внести свой вклад, подав запрос на вытягивание на GitHub.

Ссылка на документацию GitHub

getHTMLTextDir t