# gt-next: General Translation Next.js SDK: loadDictionary
URL: https://generaltranslation.com/es/docs/next/api/config/load-dictionary.mdx
---
title: loadDictionary
description: Referencia de API para la función loadDictionary()
---

## Descripción general

`loadDictionary` carga un archivo JSON de traducción para una configuración regional determinada.

Esta función está pensada para quienes desean usar `gt-next` como una biblioteca de i18n independiente.

Esta función se usa principalmente para migrar proyectos existentes con i18n a General Translation sin perder sus traducciones actuales.
Sigue [esta guía](/docs/next/guides/migration) para configurarlo.

Si existen varias traducciones, las traducciones de los diccionarios cargados con `loadDictionary` siempre tendrán prioridad sobre las demás.
`loadDictionary` solo admite archivos JSON con traducciones de cadenas.

## Referencia

### Parámetros

<TypeTable
  type={{
  "locale": {
      type: 'string',
      optional: false,
  },
}}
/>

### Descripción

| Tipo     | Descripción                                                   |
| -------- | ------------------------------------------------------------- |
| `locale` | La configuración regional cuyas traducciones se deben cargar. |

### Devuelve

Una `Promise<any>` que se resuelve con un diccionario que asigna `id` a sus traducciones para la configuración regional indicada.

***

## Setup

Por lo general, cargarás el diccionario desde el directorio `./public/locales`.

Define `loadDictionary` como la exportación predeterminada de un archivo llamado `loadDictionary.js` o `loadDictionary.ts`, ya sea en el directorio `src/` o en la raíz.
Asegúrate de que la función devuelva una promesa que se resuelva en un objeto con las traducciones para la configuración regional indicada.

```jsx title="src/loadDictionary.js"
export default async function loadDictionary(locale) {
  const translations = await import(`../public/locales/${locale}.json`);
  return translations.default;
}
```

<Callout>
  **Pregunta:** ¿Cuál es la diferencia entre [`loadTranslations`](/docs/next/api/config/load-translations) y [`loadDictionary`](/docs/next/api/config/load-dictionary)?

  * [`loadTranslations`](/docs/next/api/config/load-translations) se usa para definir un comportamiento de carga personalizado para obtener las traducciones de tu aplicación.
    Esto puede implicar cargar traducciones desde una CDN, una base de datos o el bundle de tu aplicación.
    Normalmente, son traducciones generadas por máquina, administradas por la herramienta CLI y poco prácticas de editar manualmente.
  * [`loadDictionary`](/docs/next/api/config/load-dictionary) está pensado para implementaciones de `gt-next` como biblioteca autónoma.
    Los usuarios aportan sus propias traducciones y no se utiliza ninguna infraestructura de traducción.
</Callout>

***


## Notas

* `loadDictionary` se usa para cargar traducciones personalizadas para tu aplicación.
* Los diccionarios cargados por `loadDictionary` tendrán prioridad sobre las traducciones cargadas por [`loadTranslations`](/docs/next/api/config/load-translations).

## Próximos pasos

* Si quieres escribir tus propias traducciones, consulta [traducciones personalizadas](/docs/next/concepts/stand-alone).
* Consulta [`loadTranslations`](/docs/next/api/config/load-translations) para obtener más información sobre cómo crear un cargador de traducciones personalizado.