# General Translation Changelog: gt-node 0.2.0: Traduction côté serveur pour Node.js
URL: https://generaltranslation.com/fr/blog/gt-node_v0_2_0.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: 
Authors: Ernest McCarter
Published: 2026-02-17

## Vue d’ensemble

**IMPORTANT** Cette bibliothèque est encore expérimentale et peut faire l’objet de changements incompatibles.

`gt-node` apporte General Translation à l’environnement JavaScript côté serveur. Il fonctionne avec **Node.js**, **Bun** et **Deno**.

En établissant un contexte par requête via `AsyncLocalStorage`, `gt-node` vous permet d’importer directement les fonctions de traduction depuis la bibliothèque :

```js
const gt = await getGT();
```

Cela reprend l’API de nos autres bibliothèques, comme `gt-next`, lorsque vous travaillez avec des fonctions asynchrones.

***


## Ce qui est inclus

* **[`initializeGT()`](/docs/node/reference/functions/initialize-gt)** — Configure le singleton i18n. Appelez-le une seule fois au démarrage du serveur.
* **`withGT(locale, fn)`** — Enveloppe un gestionnaire de requêtes pour lui associer un paramètre régional. Tous les appels de traduction à l’intérieur du callback utilisent le paramètre régional fourni. Toutes les routes doivent être enveloppées dans [`withGT`](/docs/node/reference/functions/with-gt).
* **[`getGT()`](/docs/node/reference/functions/get-gt)** — Renvoie une fonction de traduction pour les chaînes intégrées. Prend en charge l’interpolation de variables et le format de message ICU.

***

## Prise en main (Express)

### Installer

```bash
npm install gt-node
```


### Initialisez

```js title="server.js"
import express from 'express';
import { initializeGT, withGT, getGT } from 'gt-node';

initializeGT({
  defaultLocale: 'en-US',
  locales: ['en-US', 'es', 'fr'],
  projectId: process.env.GT_PROJECT_ID,
});

const app = express();
```


### Ajouter le middleware de paramètre régional

Extrayez le paramètre régional à partir des en-têtes de la requête (ou des cookies, des paramètres de requête — selon la façon dont votre application le détermine) et enveloppez chaque requête avec [`withGT`](/docs/node/reference/functions/with-gt) :

```js title="server.js"
app.use((req, res, next) => {
  const locale = req.headers['accept-language']?.split(',')[0] || 'en-US';
  withGT(locale, () => next());
});
```

### Traduire

```js title="server.js"
app.get('/api/greeting', async (req, res) => {
  const gt = await getGT();
  res.json({ message: gt('Hello, world!') });
});

app.listen(3000);
```


### Traduire et déployer

```bash
npx gt translate --publish
```

C'est tout. Les chaînes sont détectées par le compilateur GT au moment de la compilation, traduites pendant le CD, puis résolues à l’exécution pour chaque requête.

***

## À venir

`gt-node` et `gt-tanstack-start` sont les deux premières bibliothèques construites sur l’architecture singleton `gt-i18n`. Attendez-vous à voir d’autres adaptateurs de framework suivre le même modèle.

Vos retours sont les bienvenus sur [Discord](https://discord.gg/SjQwPjZaGa) ou [GitHub](https://github.com/generaltranslation/gt/issues).

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.