# generaltranslation: General Translation Core SDK: requiresTranslation
URL: https://generaltranslation.com/fr/docs/core/functions/locales/requires-translation.mdx
---
title: requiresTranslation
description: Référence de l’API pour la fonction requiresTranslation
---

## Vue d’ensemble

La fonction `requiresTranslation` détermine si une traduction est nécessaire entre le paramètre régional source et le paramètre régional cible, sans nécessiter d’instance de la classe GT.

***

## Référence

### Paramètres

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

### Renvoie

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

***

## Exemples

```typescript
import { requiresTranslation } from 'generaltranslation';

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

// Les langues identiques ne nécessitent pas de traduction
console.log(requiresTranslation('en-US', 'en-US')); // false
console.log(requiresTranslation('en-US', 'en-GB')); // false

// Avec le filtre des paramètres régionaux approuvés
const approved = ['en-US', 'es-ES', 'fr-FR'];
console.log(requiresTranslation('en-US', 'it-IT', approved)); // false (non approuvée)
console.log(requiresTranslation('en-US', 'es-ES', approved)); // true (approuvée et différente)
```

***


## Remarques

* Respecte les contraintes des paramètres régionaux approuvés
* Renvoie `false` si le paramètre régional cible ne figure pas dans la liste approuvée
* Tient compte des mappages personnalisés de paramètres régionaux

## Prochaines étapes

* Utilisez la méthode [`requiresTranslation`](/docs/core/class/methods/locales/requires-translation) de la classe GT
* Comparez les langues avec [`isSameLanguage`](/docs/core/functions/locales/is-same-language)