# vue: LoadTranslations
URL: https://generaltranslation.com/fr/docs/vue/reference/types/load-translations.mdx
---

title: LoadTranslations
description: Charge le catalogue complet de traductions pour le paramètre régional demandé. Référence de l’API LoadTranslations.

---

Fournissez ce callback à [`createGT()`](/docs/vue/reference/functions/create-gt) ou [`initializeGTSPA()`](/docs/vue/reference/functions/initialize-gt-spa) lorsque les catalogues cibles sont stockés dans les fichiers de l’application, une base de données, une API ou un autre hôte.

## Vue d’ensemble [#overview]

```ts
type LoadTranslations = (
  locale: string
) => Promise<TranslationCatalog>;
```

Le plugin appelle le loader uniquement pour les paramètres régionaux cibles non mis en cache. Le paramètre régional par défaut utilise le texte source et ne l’appelle jamais.

## Paramètres [#parameters]

| Paramètre | Description                                                     | Type     | Facultatif | Par défaut |
| --------- | --------------------------------------------------------------- | -------- | ---------- | ---------- |
| `locale`  | Paramètre régional dont le catalogue complet doit être renvoyé. | `string` | Non        | —          |

Un plugin [`createGT()`](/docs/vue/reference/functions/create-gt) standard transmet le paramètre régional demandé tel quel. Un plugin [`initializeGTSPA()`](/docs/vue/reference/functions/initialize-gt-spa) résout d’abord le paramètre régional en fonction des `locales` et de `customMapping` configurés, en conservant l’orthographe configurée dans les chemins d’accès.

## Valeur de retour [#returns]

**Type** `Promise<`[`TranslationCatalog`](/docs/vue/reference/types/translation-catalog)`>`

Renvoyez le catalogue complet indexé par hachage pour le `locale`. Renvoyez `{}` lorsqu’aucune traduction n’est disponible et que l’application doit utiliser le contenu source.

Ne renvoyez pas `null`, `undefined` ni de valeur partielle de forme différente. Le type de callback public exige un objet catalogue.

## Comportement de chargement [#loading-behavior]

* Un résultat obtenu avec succès est mis en cache pendant toute la durée de vie de ce plugin.
* Les chargements simultanés pour un même paramètre régional partagent la même promesse.
* `plugin.loadTranslations(locale)` précharge les traductions sans modifier le paramètre régional actif.
* `plugin.setLocale(locale)`, qui est réactif, charge les traductions avant de changer de paramètre régional.
* [`initializeGTSPA()`](/docs/vue/reference/functions/initialize-gt-spa) charge le paramètre régional cible initial avant la résolution de sa promesse.
* L’installation d’un plugin [`createGT()`](/docs/vue/reference/functions/create-gt) lance en arrière-plan le chargement initial du paramètre régional cible, ce qui permet d’afficher d’abord le contenu source.

## Échecs [#failures]

Lorsque le callback échoue, `gt-vue` consigne un diagnostic, propage à nouveau la même erreur, supprime l’entrée en cours et ne met pas le résultat en cache. Un appel ultérieur peut réessayer.

Un appel impératif à `loadTranslations()`, un changement réactif de paramètre régional ou l’initialisation de la SPA échoue donc. Le chargement en arrière-plan lancé par `app.use(createGT(...))` intercepte le rejet après l’avoir consigné afin que l’application puisse continuer avec le contenu source.

## Exemple [#example]

```ts title="src/loadTranslations.ts"
import type { LoadTranslations } from 'gt-vue';

const loadTranslations: LoadTranslations = async (locale) => {
  try {
    return (await import(`./_gt/${locale}.json`)).default;
  } catch (error) {
    console.error(`No translation catalog for ${locale}`, error);
    return {};
  }
};

export default loadTranslations;
```

Le loader ci-dessus traite les fichiers manquants comme un catalogue vide valide. Supprimez le `try`/`catch` si un catalogue manquant ou non valide doit interrompre l’initialisation.