translate
Referencia de API del método translate de GT
Descripción general
El método translate es la función principal de traducción en la biblioteca de GT.
Traduce contenido desde el locale de origen a un locale de destino especificado utilizando servicios de traducción impulsados por IA.
const gt = new GT({
apiKey: 'your-api-key',
projectId: 'your-project-id'
});
const result = await gt.translate('Hello, world!', 'es');
console.log(result); // "¡Hola, mundo!"El método admite varios tipos de contenido, incluidos texto sin formato, ICU message format y mensajes al estilo de i18next, con metadatos opcionales para mejorar la precisión de la traducción.
Autenticación requerida:
El método translate requiere que tanto apiKey (o devApiKey) como projectId estén configurados en la instancia de GT.
Referencias
Parámetros
El método translate ofrece varias sobrecargas para distintos tipos de contenido:
Contenido de texto
Prop
Type
Contenido JSX
Prop
Type
ICU message format
Prop
Type
Formato de i18next
Prop
Type
Descripción de los parámetros
| Parámetro | Descripción |
|---|---|
source | Contenido a traducir. Puede ser texto sin formato, elementos JSX, mensajes ICU o mensajes de i18next |
targetLocale | Código de configuración regional BCP-47 para el idioma de destino (p. ej., 'es', 'fr-CA') |
metadata | Contexto opcional de traducción que incluye contexto, etiquetas y opciones de formato |
Valores devueltos
Promise<ResultadoDeTraducción | ErrorDeTraducción>- ResultadoDeTraducción: Contiene el contenido traducido y los metadatos
- TranslationError: Contiene información del error si la traducción falla
Comportamiento
Detección del tipo de contenido
El método detecta automáticamente el tipo de contenido según el parámetro source:
- String: Se trata como texto sin formato o ICU message format
- JSX Elements: Se maneja como contenido JSX al estilo React
- Objects: Se procesa como formatos de mensaje estructurados
Resolución de la configuración regional
- Se valida la configuración regional de destino según el estándar BCP-47
- Se aplican asignaciones personalizadas de configuración regional si están definidas
- Se utilizan códigos canónicos de configuración regional en las solicitudes a la API
Mejora del contexto
Cuando el mapeo personalizado incluye códigos de región o de script para la locale de destino, estos se añaden automáticamente a los metadatos para mejorar la precisión de la traducción.
Ejemplos
const gt = new GT({
apiKey: 'your-api-key',
projectId: 'your-project-id'
});
const result = await gt.translate('Bienvenido a nuestra aplicación', 'fr');
console.log(result);
// "Bienvenue dans notre application"Notas
- Traduce una cadena dada a un locale de destino y devuelve una promesa
Próximos pasos
¿Qué te ha parecido esta guía?