# General Translation Changelog: gt-node 0.2.0: Node.js 向けのサーバーサイド翻訳
URL: https://generaltranslation.com/ja/blog/gt-node_v0_2_0.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: 
Authors: Ernest McCarter
Published: 2026-02-17

## 概要

**重要** このライブラリはまだ実験的な段階にあり、互換性のない変更が加わる可能性があります。

`gt-node` を使うと、General Translation をサーバーサイド JavaScript で利用できます。**Node.js**、**Bun**、**Deno** で動作します。

`AsyncLocalStorage` によって per-request コンテキストを確立することで、`gt-node` ではライブラリから翻訳関数を直接インポートできます。

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

これは、非同期関数を扱う際の `gt-next` など他のライブラリの API と同じです。

***


## 含まれるもの

* **[`initializeGT()`](/docs/node/reference/functions/initialize-gt)** — i18n シングルトンを設定します。サーバーの起動時に 1 回だけ呼び出します。
* **`withGT(locale, fn)`** — リクエストハンドラーをラップして、そのスコープ内のロケールを設定します。コールバック内のすべての翻訳呼び出しは、指定したロケールを使用します。すべてのルートは [`withGT`](/docs/node/reference/functions/with-gt) でラップする必要があります。
* **[`getGT()`](/docs/node/reference/functions/get-gt)** — インライン文字列用の翻訳関数を返します。変数補間と ICU メッセージ形式をサポートします。

***

## クイックスタート (Express)

### インストール

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


### 初期化

```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();
```


### ロケール用ミドルウェアを追加する

リクエストヘッダー (または Cookie、クエリパラメータなど、アプリでロケールを判定する方法) からロケールを取得し、各リクエストを [`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());
});
```

### 翻訳

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

app.listen(3000);
```


### 翻訳とデプロイ

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

以上です。文字列はビルド時に GT コンパイラによって検出され、CD 中に翻訳され、runtime ではリクエストごとに解決されます。

***

## 今後について

`gt-node` と `gt-tanstack-start` は、`gt-i18n` のシングルトンアーキテクチャを採用した最初の 2 つのライブラリです。今後は、同じパターンに従うフレームワークアダプターがさらに増える予定です。

フィードバックは [Discord](https://discord.gg/SjQwPjZaGa) または [GitHub](https://github.com/generaltranslation/gt/issues) までお寄せください。

## Sitemap

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