express-intlayer : Package JavaScript pour internationaliser (i18n) une application Express.js

Intlayer est une suite de packages conçue spécifiquement pour les développeurs JavaScript. Il est compatible avec des frameworks comme React, Next.js et Express.js.

Le package express-intlayer vous permet d’internationaliser votre application Express.js. Il fournit un middleware pour détecter la locale préférée de l’utilisateur, et retourne le dictionnaire approprié pour cet utilisateur.

Pourquoi internationaliser votre backend ?

Internationaliser votre backend est essentiel pour servir efficacement une audience mondiale. Cela permet à votre application de délivrer du contenu et des messages dans la langue préférée de chaque utilisateur. Cette capacité améliore l’expérience utilisateur et élargit la portée de votre application en la rendant plus accessible et pertinente pour des personnes issues de différents horizons linguistiques.

Cas d’utilisation pratiques

• Afficher les erreurs du backend dans la langue de l’utilisateur : Lorsqu’une erreur survient, afficher les messages dans la langue maternelle de l’utilisateur améliore la compréhension et réduit la frustration. Ceci est particulièrement utile pour les messages d’erreur dynamiques qui pourraient être affichés dans des composants frontaux tels que des toasts ou des modales.

• Récupérer du contenu multilingue : Pour les applications qui extraient du contenu d’une base de données, l’internationalisation garantit que vous pouvez fournir ce contenu en plusieurs langues. Cela est crucial pour des plateformes comme les sites e-commerce ou les systèmes de gestion de contenu qui doivent afficher des descriptions de produits, des articles et d’autres contenus dans la langue préférée de l’utilisateur.

• Envoyer des e-mails multilingues : Qu’il s’agisse d’e-mails transactionnels, de campagnes marketing ou de notifications, envoyer des e-mails dans la langue du destinataire peut considérablement augmenter l’engagement et l’efficacité.

• Notifications push multilingues : Pour les applications mobiles, envoyer des notifications push dans la langue préférée de l’utilisateur peut améliorer l’interaction et la rétention. Cette touche personnelle rend les notifications plus pertinentes et exploitables.

• Autres communications : Toute forme de communication provenant du backend, comme les messages SMS, les alertes système ou les mises à jour de l’interface utilisateur, bénéficie d’être dans la langue de l’utilisateur, garantissant ainsi la clarté et améliorant l’expérience utilisateur globale.

En internationalisant le backend, votre application respecte non seulement les différences culturelles, mais s’aligne également mieux sur les besoins du marché mondial, ce qui en fait une étape clé pour étendre vos services à l’échelle mondiale.

Pourquoi intégrer Intlayer ?

• Environnement typé : Profitez de TypeScript pour garantir que toutes vos définitions de contenu sont précises et sans erreur.

Installation

Installez le package nécessaire en utilisant votre gestionnaire de paquets préféré :

npm install express-intlayer

yarn add express-intlayer

pnpm add express-intlayer

Configurer Intlayer

Intlayer fournit un fichier de configuration pour configurer votre projet. Placez ce fichier à la racine de votre projet.

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

Pour une liste complète des paramètres disponibles, référez-vous à la documentation de configuration.

Exemple d'utilisation

Configurez votre application Express pour utiliser express-intlayer :

import express, { type Express } from "express";import { intlayer, t } from "express-intlayer";const app: Express = express();// Charge le gestionnaire de requêtes d'internationalisationapp.use(intlayer());// Routesapp.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)",    })  );});// Démarrer le serveurapp.listen(3000, () => console.log(`Écoute sur le port 3000`));

Compatibilité

express-intlayer est entièrement compatible avec :

• react-intlayer pour les applications React
• next-intlayer pour les applications Next.js
• vite-intlayer pour les applications Vite

Il fonctionne également parfaitement avec toute solution d'internationalisation dans divers environnements, y compris les navigateurs et les requêtes API. Vous pouvez personnaliser le middleware pour détecter la locale via les en-têtes ou les cookies :

import { Locales, type IntlayerConfig } from "intlayer";const config: IntlayerConfig = {  // ... Autres options de configuration  middleware: {    headerName: "my-locale-header",    cookieName: "my-locale-cookie",  },};export default config;

Par défaut, express-intlayer interprétera l'en-tête Accept-Language pour déterminer la langue préférée du client.

Fonctions fournies par le package express-intlayer

• t()

Historique de la documentation

• 5.5.10 - 2025-06-29 : Historique initial