# General Translation Platform: TranslationResult
URL: https://generaltranslation.com/fr/docs/platform/core/reference/types/translation-result.mdx
---
title: TranslationResult
description: Résultat de réussite ou d’erreur renvoyé par les méthodes de traduction de General Translation. Référence d’API pour le type TranslationResult.

---

Résultat d’une méthode de traduction comme [`translate`](/docs/platform/core/reference/gt-class-methods/translation/translate) ou [`translateMany`](/docs/platform/core/reference/gt-class-methods/translation/translate-many). Il s’agit d’une union discriminée entre un résultat de réussite et un résultat d’erreur.

## Vue d’ensemble [#overview]

`TranslationResult` est une union discriminée par le booléen `success`. Testez `success` pour accéder soit à la traduction, soit à l’erreur.

```typescript
type TranslationResult = RequestSuccess | TranslationError;
```

## Membres [#members]

| Membre                                   | Description                                                           | Type     |
| ---------------------------------------- | --------------------------------------------------------------------- | -------- |
| [`RequestSuccess`](#request-success)     | Traduction réussie, avec le contenu traduit et le paramètre régional. | `object` |
| [`TranslationError`](#translation-error) | Échec de la traduction, avec un message d’erreur et un code d’état.   | `object` |

### `RequestSuccess` [#request-success]

**Type** `object`

Renvoyé lorsque `success` vaut `true`. Inclut le contenu traduit ainsi que le `paramètre régional` cible résolu.

```typescript
type RequestSuccess = TypedResult & {
  success: true;
  locale: string; // paramètre régional cible résolu
};
```

### `TranslationError` [#translation-error]

**Type** `object`

Renvoyé lorsque `success` vaut `false`. Inclut un message d’`error` compréhensible par un humain et un `code` numérique.

```typescript
type TranslationError = {
  success: false;
  error: string; // message d'erreur
  code: number; // code d'état
};
```

## Exemple [#example]

```typescript
import { GT } from 'generaltranslation';
import { TranslationResult } from 'generaltranslation/types';

const gt = new GT({ apiKey: 'your-api-key', projectId: 'your-project-id' });

const result: TranslationResult = await gt.translate('Hello', 'es');

if (result.success) {
  console.log(`Translation: ${result.translation}`); // result.translation et result.locale sont disponibles
} else {
  console.error(`Translation failed: ${result.error} (${result.code})`); // result.error et result.code sont disponibles
}
```