# gt-node: General Translation Node.js SDK: decodeMsg
URL: https://generaltranslation.com/ja/docs/node/reference/functions/decode-msg.mdx
---

title: decodeMsg
description: General Translation でエンコードされたメッセージから元の文字列を復元します。decodeMsg の API リファレンスです。

---

[`msg`](/docs/node/reference/functions/msg) でエンコードされた値から、元の補間済みメッセージ文字列を取り出します。翻訳結果ではなく、エンコードされたメッセージの人間が読める内容が必要な場合に使用します。

## 概要 [#overview]

エンコードされたメッセージを指定して `decodeMsg` を呼び出します。エンコードされたオプションより前の内容 (最後のコロンまでのすべて) を返します。入力にコロン区切りがない場合は、変更せずそのまま返します。

```ts
import { msg, decodeMsg } from 'gt-node';

const encoded = msg('Hello, {name}!', { name: 'Brian' });
console.log(decodeMsg(encoded)); // 'Hello, Brian!'
```

シグネチャ:

```ts
decodeMsg(encodedMsg: string): string;
decodeMsg<T extends null | undefined>(encodedMsg: T): T;
```

## 動作の仕組み [#how-it-works]

* **区切り文字で分割。** エンコードされたメッセージは `interpolatedContent:encodedOptions` という形式です。`decodeMsg` は最後のコロンより前の内容を返します。
* **そのまま返す。** 値にコロンが含まれない場合、または `null`/`undefined` の場合は、変更せずそのまま返されます。

## パラメーター [#parameters]

| パラメーター                       | 説明                   | 型                             | 任意  | デフォルト |
| ---------------------------- | -------------------- | ----------------------------- | --- | ----- |
| [`encodedMsg`](#encoded-msg) | デコード対象のエンコードされたメッセージ。 | `string \| null \| undefined` | いいえ | —     |

### `encodedMsg` [#encoded-msg]

**型** `string | null | undefined` · **必須**

デコードするメッセージ。通常は [`msg`](/docs/node/reference/functions/msg) の戻り値です。

## 戻り値 [#returns]

**型** `string | null | undefined`

デコードされたメッセージの内容、またはデコードできない場合は変更されていない入力値。

## 例 [#examples]

```ts
import { msg, decodeMsg } from 'gt-node';

const encoded = msg('Welcome, {name}!', { name: 'Alice' });
console.log(decodeMsg(encoded)); // 'Welcome, Alice!'

console.log(decodeMsg('Plain text')); // 'Plain text'（削除するオプションなし）
```

## メモ [#notes]

* `decodeMsg` が返すのは翻訳ではなく、source のコンテンツです。翻訳を解決するには、[`getMessages`](/docs/node/reference/functions/get-messages) を使用してください。
* コンテンツではなく、エンコードされたオプションを読み取るには、[`decodeOptions`](/docs/node/reference/functions/decode-options) を使用してください。