# generaltranslation: General Translation Core SDK: requiresTranslation
URL: https://generaltranslation.com/fr/docs/core/class/methods/locales/requires-translation.mdx
---
title: requiresTranslation
description: Référence API de la méthode requiresTranslation de GT
---

## Vue d’ensemble

La méthode `requiresTranslation` détermine si une traduction est nécessaire en fonction des paramètres régionaux source et cible.
Elle vérifie si le contenu source doit être traduit en comparant les codes de langue et en tenant compte de la liste des paramètres régionaux approuvés.

***

## Référence

### Paramètres

<TypeTable
  type={{
  "sourceLocale?": {
    type: 'string',
    optional: true,
    default: 'this.sourceLocale'
  },
  "targetLocale?": {
    type: 'string', 
    optional: true,
    default: 'this.targetLocale'
  },
  "approvedLocales?": {
    type: 'string[]',
    optional: true,
    default: 'this.locales'
  },
  "customMapping?": {
    type: 'CustomMapping',
    optional: true,
    default: 'this.customMapping'
  }
}}
/>

### Description des paramètres

| Paramètre         | Description                                                                                                                          |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| `sourceLocale`    | Le code de langue source. S&#39;il n&#39;est pas fourni, la valeur `sourceLocale` de l&#39;instance est utilisée                     |
| `targetLocale`    | Le code de langue cible. S&#39;il n&#39;est pas fourni, la valeur `targetLocale` de l&#39;instance est utilisée                      |
| `approvedLocales` | Tableau des paramètres régionaux cibles approuvés. S&#39;il n&#39;est pas fourni, le tableau `locales` de l&#39;instance est utilisé |
| `customMapping`   | Mappage personnalisé facultatif pour la détermination du paramètre régional                                                          |

### Renvoie

`boolean` - `true` si une traduction est nécessaire, `false` sinon

### Erreurs

* `Error` - Si aucun paramètre régional source n’est fourni et qu’aucun `sourceLocale` n’est configuré pour l’instance
* `Error` - Si aucun paramètre régional cible n’est fourni et qu’aucun `targetLocale` n’est configuré pour l’instance

***

## Exemples

```typescript
const gt = new GT({
  sourceLocale: 'en-US',
  targetLocale: 'es-ES',
  locales: ['en-US', 'es-ES', 'fr-FR', 'de-DE']
});

// Des langues différentes nécessitent une traduction
console.log(gt.requiresTranslation('en-US', 'es-ES')); // true
console.log(gt.requiresTranslation('en-US', 'fr-FR')); // true

// La même langue ne nécessite pas de traduction
console.log(gt.requiresTranslation('en-US', 'en-US')); // false
console.log(gt.requiresTranslation('es-ES', 'es-ES')); // false

// Des dialectes différents de la même langue ne nécessitent pas de traduction
console.log(gt.requiresTranslation('en-US', 'en-GB')); // false
console.log(gt.requiresTranslation('es-ES', 'es-MX')); // false

// La cible n'est pas dans les paramètres régionaux approuvés
console.log(gt.requiresTranslation('en-US', 'it-IT')); // false (it-IT n'est pas dans les paramètres régionaux approuvés)
```

***


## Remarques

* Prend en compte les familles linguistiques des paramètres régionaux, pas seulement les correspondances exactes
* Respecte les listes de paramètres régionaux approuvés
* Renvoie `false` si le paramètre régional cible ne figure pas dans la liste des paramètres régionaux approuvés (si fournie)

## Étapes suivantes

* Vérifiez les correspondances entre paramètres régionaux avec [`isSameLanguage`](/docs/core/class/methods/locales/is-same-language)
* Déterminez le paramètre régional le plus approprié avec [`determineLocale`](/docs/core/class/methods/locales/determine-locale)
* Validez les paramètres régionaux avec [`isValidLocale`](/docs/core/class/methods/locales/is-valid-locale)