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 del locale de origen a un locale de destino especificado mediante servicios de traducción con 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, el ICU message format y mensajes al estilo i18next, con metadatos opcionales para mejorar la precisión de la traducción.
Autenticación obligatoria:
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
Formato de mensajes ICU
Prop
Type
Formato i18next
Prop
Type
Descripción de 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 de traducción opcional que incluye contexto, etiquetas y opciones de formato |
Valores de retorno
Promise<ResultadoDeTraducción | ErrorDeTraducción>- ResultadoDeTraducción: Contiene el contenido traducido y los metadatos
- TranslationError: Contiene información de 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 en ICU message format
- JSX Elements: Se maneja como contenido JSX al estilo React
- Objects: Se procesa como formatos de mensajes estructurados
Resolución de locales
- El locale de destino se valida conforme a los estándares BCP‑47
- Se aplican asignaciones personalizadas de locales si están configuradas
- Se utilizan códigos de configuración regional canónicos para las solicitudes a la API
Mejora del contexto
Cuando el mapeo personalizado incluye códigos de región o de script para el 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);
// "Bienvenido a nuestra aplicación"Notas
- Traduce una cadena dada a un locale de destino y devuelve una promesa
Próximos pasos
¿Qué te parece esta guía?