# gt-node: General Translation Node.js SDK: decodeOptions
URL: https://generaltranslation.com/fr/docs/node/reference/functions/decode-options.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Récupère l’objet d’options encodé à partir d’un message encodé par General Translation. Référence de l’API pour decodeOptions.

Décode l’objet d’options que [`msg`](/docs/node/reference/functions/msg) a intégré dans un message encodé. Utilisez-le pour inspecter les métadonnées et les variables d’interpolation contenues dans un message encodé.

## Vue d’ensemble [#overview]

Appelez `decodeOptions` avec un message encodé. La fonction l’analyse et renvoie l’objet d’options, ou `null` si le message ne contient pas d’options encodées ou s’il est impossible de l’analyser.

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

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

Signature :

```ts
decodeOptions(encodedMsg: string): TranslationOptions | null
```

## Fonctionnement [#how-it-works]

* **Découpage par séparateur.** Un message encodé se présente sous la forme `interpolatedContent:encodedOptions`. `decodeOptions` lit le segment situé après le dernier deux-points, le décode en base64 et analyse les options JSON.
* **Résultat nul.** Si le message ne contient pas de séparateur deux-points, ou si le segment encodé ne peut pas être analysé, la fonction renvoie `null`.

## Paramètres [#parameters]

| Paramètre                    | Description                                             | Type     | Facultatif | Défaut |
| ---------------------------- | ------------------------------------------------------- | -------- | ---------- | ------ |
| [`encodedMsg`](#encoded-msg) | Le message encodé à partir duquel extraire les options. | `string` | Non        | —      |

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

**Type** `string` · **Obligatoire**

Le message à décoder ; il s’agit généralement d’une valeur renvoyée par [`msg`](/docs/node/reference/functions/msg).

## Retourne [#returns]

**Type** `TranslationOptions | null`

L’objet d’options décodé, y compris les variables d’interpolation et les métadonnées telles que `$_source` et `$_hash`, ou `null` s’il n’y a aucune option à décoder.

## Exemples [#examples]

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

const encoded = msg('You have {count} messages', { count: 3 });
const options = decodeOptions(encoded);
console.log(options?.count); // 3

console.log(decodeOptions('Plain text')); // null
```

## Notes [#notes]

* Pour lire le contenu du message plutôt que ses options, utilisez [`decodeMsg`](/docs/node/reference/functions/decode-msg).

## Sitemap

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