# generaltranslation: General Translation Core SDK: requiresTranslation
URL: https://generaltranslation.com/es/docs/core/class/methods/locales/requires-translation.mdx
---
title: requiresTranslation
description: Referencia de la API del método requiresTranslation de GT
---

## Resumen

El método `requiresTranslation` determina si es necesaria una traducción en función de las configuraciones regionales de origen y destino.
Comprueba si el contenido de origen debe traducirse comparando los códigos de configuración regional y teniendo en cuenta la lista de configuraciones regionales aprobadas.

***

## Referencia

### Parámetros

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

### Descripción de los parámetros

| Parámetro         | Descripción                                                                                                       |
| ----------------- | ----------------------------------------------------------------------------------------------------------------- |
| `sourceLocale`    | El código de la configuración regional de origen. Si no se proporciona, se usa el `sourceLocale` de la instancia  |
| `targetLocale`    | El código de la configuración regional de destino. Si no se proporciona, se usa el `targetLocale` de la instancia |
| `approvedLocales` | Array de configuraciones regionales de destino aprobadas. Si no se proporciona, se usa el array `locales` de la instancia          |
| `customMapping`   | Asignación personalizada opcional para la resolución de la configuración regional                                 |

### Devuelve

`boolean`: `true` si se requiere una traducción; `false` en caso contrario

### Lanza

* `Error` - Si no se proporciona ninguna configuración regional de origen y la instancia no tiene `sourceLocale` configurado
* `Error` - Si no se proporciona ninguna configuración regional de destino y la instancia no tiene `targetLocale` configurado

***

## Ejemplos

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

// Idiomas diferentes requieren traducción
console.log(gt.requiresTranslation('en-US', 'es-ES')); // true
console.log(gt.requiresTranslation('en-US', 'fr-FR')); // true

// El mismo idioma no requiere traducción
console.log(gt.requiresTranslation('en-US', 'en-US')); // false
console.log(gt.requiresTranslation('es-ES', 'es-ES')); // false

// Dialectos diferentes del mismo idioma no requieren traducción
console.log(gt.requiresTranslation('en-US', 'en-GB')); // false
console.log(gt.requiresTranslation('es-ES', 'es-MX')); // false

// El destino no está en la configuración regional aprobada
console.log(gt.requiresTranslation('en-US', 'it-IT')); // false (it-IT no está en la configuración regional aprobada)
```

***


## Notas

* Tiene en cuenta las familias de idiomas de las configuraciones regionales, no solo las coincidencias exactas
* Respeta las listas de configuraciones regionales aprobadas
* Devuelve `false` si la configuración regional de destino no figura entre las configuraciones regionales aprobadas (si se proporcionan)

## Siguientes pasos

* Comprueba las relaciones entre configuraciones regionales con [`isSameLanguage`](/docs/core/class/methods/locales/is-same-language)
* Determina la mejor configuración regional con [`determineLocale`](/docs/core/class/methods/locales/determine-locale)
* Valida las configuraciones regionales con [`isValidLocale`](/docs/core/class/methods/locales/is-valid-locale)