# generaltranslation: General Translation Core SDK: downloadFile
URL: https://generaltranslation.com/fr/docs/core/class/methods/translation/download-file.mdx
---
title: downloadFile
description: Référence API de la méthode downloadFile pour télécharger des fichiers sources ou traduits
---

## Vue d’ensemble

La méthode `downloadFile` télécharge le contenu d’un fichier unique sous forme de chaîne de caractères UTF-8.
Selon qu’un paramètre régional est spécifié ou non, elle télécharge soit le fichier source, soit la traduction correspondante.

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

// Télécharger une traduction
const translatedContent = await gt.downloadFile({
  fileId: 'file-123',
  branchId: 'branch-456',
  locale: 'es',
  versionId: 'version-789'
});

// Télécharger le fichier source (aucun paramètre régional spécifié)
const sourceContent = await gt.downloadFile({
  fileId: 'file-123',
  branchId: 'branch-456'
});
```

<Callout>
  **Statut de la traduction :**
  Lors du téléchargement des traductions, cette méthode ne fonctionne qu’avec des traductions finalisées.
  Utilisez d’abord [`queryFileData`](/docs/core/class/methods/translation/query-file-data) pour vérifier que les traductions sont bien finalisées avant d’essayer de les télécharger.
</Callout>


## Référence

### Paramètres

| Nom        | Type                  | Description                                                            |
| ---------- | --------------------- | ---------------------------------------------------------------------- |
| `file`     | `FileInfo`            | Objet d’informations sur le fichier indiquant quel fichier télécharger |
| `options?` | `DownloadFileOptions` | Configuration facultative de la requête de téléchargement              |

#### Structure de FileInfo

| Nom                          | Type      | Description                                                                                                                                                            |
| ---------------------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `fileId`                     | `string`  | Identifiant unique du fichier à télécharger                                                                                                                            |
| `branchId?`                  | `string`  | ID de la branche depuis laquelle télécharger. S&#39;il n&#39;est pas fourni, la branche par défaut sera utilisée                                                       |
| `locale?`                    | `string`  | Paramètre régional cible de la traduction à télécharger. S&#39;il n&#39;est pas fourni, le fichier source sera téléchargé                                              |
| `versionId?`                 | `string`  | ID de version facultatif du fichier. S&#39;il n&#39;est pas fourni, la dernière version sera utilisée                                                                  |
| `useLatestAvailableVersion?` | `boolean` | Si `true` et que le `versionId` spécifié est introuvable, la dernière version disponible est utilisée au lieu de renvoyer une erreur. La valeur par défaut est `false` |

#### DownloadFileOptions

| Nom        | Type     | Description                                        |
| ---------- | -------- | -------------------------------------------------- |
| `timeout?` | `number` | Délai d’expiration de la requête, en millisecondes |

### Renvoie

`Promise<string>` - Le contenu du fichier sous forme de chaîne de caractères UTF-8.

La chaîne de caractères renvoyée contient le contenu du fichier dans le même format que le fichier source d’origine. Pour les traductions, tout le texte traduisible est converti dans le paramètre régional cible.

***

## Exemple

```typescript title="index.ts" copy
// (1) Créer une instance GT
const targetLocales = ['es', 'fr', 'de'];
const gt = new GT({
  projectId: 'your-project-id',
  apiKey: 'your-api-key',
});

// (2) Envoyer le fichier
const fileUpload = {
  content: fileContents,
  fileName: filePath,
  fileFormat: 'JSON',
  locale: 'en',
};
const files = [ { source: fileUpload } ];
const { uploadedFiles } = await gt.uploadSourceFiles(
  files,
  { sourceLocale: 'en' }
);

// (3) Mettre en file d'attente la tâche de traduction du fichier
const enqueueResult = await gt.enqueueFiles(
  uploadedFiles,
  {
    sourceLocale: 'en',
    targetLocales: targetLocales,
  }
);

// (4) Attendre que toutes les traductions soient terminées
const { fileId, versionId, branchId } = uploadedFiles[0];
const result = await gt.awaitJobs(enqueueResult);

if (!result.complete) {
  console.error('Certaines tâches ne se sont pas terminées à temps');
}

// (5) Télécharger un fichier
const spanishContent = await gt.downloadFile({
  fileId,
  branchId,
  locale: 'es'
});

console.log('Traduction espagnole :', spanishContent);
```

***


## Remarques

* Récupère le fichier téléchargé sous forme de chaîne de caractères UTF-8
* Lorsqu’un paramètre régional est fourni, le fichier doit avoir une traduction finalisée pour ce paramètre régional
* Lorsqu’aucun paramètre régional n’est fourni, le fichier source est renvoyé
* Échoue si le fichier est introuvable

## Étapes suivantes

* Consultez [`queryFileData`](/docs/core/class/methods/translation/query-file-data) pour vérifier l’état de la traduction avant de télécharger
* Consultez [`downloadFileBatch`](/docs/core/class/methods/translation/download-file-batch) pour télécharger efficacement plusieurs fichiers
* Consultez [`uploadSourceFiles`](/docs/core/class/methods/translation/upload-source-files) pour le processus d’envoi des fichiers
* Consultez [`enqueueFiles`](/docs/core/class/methods/translation/enqueue-files) pour lancer des tâches de traduction
* Consultez [`awaitJobs`](/docs/core/class/methods/translation/await-jobs) pour attendre la fin des tâches avant de télécharger