# generaltranslation: General Translation Core SDK: requiresTranslation
URL: https://generaltranslation.com/it/docs/core/class/methods/locales/requires-translation.mdx
---
title: requiresTranslation
description: Riferimento API per il metodo requiresTranslation di GT
---

## Panoramica

Il metodo `requiresTranslation` determina se è necessaria una traduzione in base alle impostazioni regionali di origine e di destinazione.
Verifica se il contenuto di origine deve essere tradotto confrontando i codici locale e tenendo conto dell'elenco delle impostazioni regionali approvate.

***

## Guida di riferimento

### Parametri

<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'
  }
}}
/>

### Descrizione dei parametri

| Parametro         | Descrizione                                                                                                                  |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| `sourceLocale`    | Il codice locale di origine. Se non specificato, usa `sourceLocale` dell&#39;istanza                                         |
| `targetLocale`    | Il codice locale di destinazione. Se non specificato, usa `targetLocale` dell&#39;istanza                                    |
| `approvedLocales` | Array delle impostazioni regionali di destinazione approvate. Se non specificato, usa l&#39;array `locales` dell&#39;istanza |
| `customMapping`   | Mapping personalizzato facoltativo per determinare l&#39;impostazione regionale                                              |

### Restituisce

`boolean`: `true` se la traduzione è necessaria, `false` altrimenti

### Eccezioni

* `Error` - Se non viene specificata alcuna impostazione regionale di origine e l&#39;istanza non ha `sourceLocale` configurato
* `Error` - Se non viene specificata alcuna impostazione regionale di destinazione e l&#39;istanza non ha `targetLocale` configurato

***

## Esempi

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

// Lingue diverse richiedono la traduzione
console.log(gt.requiresTranslation('en-US', 'es-ES')); // true
console.log(gt.requiresTranslation('en-US', 'fr-FR')); // true

// Lingue uguali non richiedono la traduzione
console.log(gt.requiresTranslation('en-US', 'en-US')); // false
console.log(gt.requiresTranslation('es-ES', 'es-ES')); // false

// Dialetti diversi della stessa lingua non richiedono la traduzione
console.log(gt.requiresTranslation('en-US', 'en-GB')); // false
console.log(gt.requiresTranslation('es-ES', 'es-MX')); // false

// Target non presente nelle impostazioni regionali approvate
console.log(gt.requiresTranslation('en-US', 'it-IT')); // false (it-IT non è nelle impostazioni regionali approvate)
```

***


## Note

* Considera le famiglie linguistiche delle impostazioni regionali, non solo le corrispondenze esatte
* Rispetta gli elenchi delle impostazioni regionali approvate
* Restituisce `false` quando l&#39;impostazione regionale di destinazione non rientra tra quelle approvate (se fornite)

## Passaggi successivi

* Verifica le relazioni tra le impostazioni regionali con [`isSameLanguage`](/docs/core/class/methods/locales/is-same-language)
* Determina l&#39;impostazione regionale migliore con [`determineLocale`](/docs/core/class/methods/locales/determine-locale)
* Convalida le impostazioni regionali con [`isValidLocale`](/docs/core/class/methods/locales/is-valid-locale)