translate
Référence de l’API pour la méthode GT translate
Vue d’ensemble
La méthode translate est la fonction de traduction principale de la bibliothèque GT.
Elle traduit le contenu de la locale source vers une locale cible spécifiée à l’aide de services de traduction propulsés par l’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!"La méthode prend en charge plusieurs types de contenu, notamment le texte brut, le format de message ICU et les messages au format i18next, avec des métadonnées facultatives pour améliorer la précision de la traduction.
Authentification requise :
La méthode translate exige que apiKey (ou devApiKey) et projectId soient configurés dans l’instance GT.
Références
Paramètres
La méthode translate propose plusieurs surcharges adaptées à différents types de contenu :
Contenu textuel
Prop
Type
Contenu JSX
Prop
Type
Format de message ICU
Prop
Type
Format i18next
Prop
Type
Description des paramètres
| Paramètre | Description |
|---|---|
source | Contenu à traduire. Peut être du texte brut, des éléments JSX, des messages ICU ou des messages i18next |
targetLocale | Code de locale BCP-47 pour la langue cible (p. ex. « es », « fr-CA ») |
metadata | Contexte de traduction facultatif incluant le contexte, les balises et les options de formatage |
Renvoie
Promise<TranslationResult | TranslationError>- TranslationResult: Contient le contenu traduit et ses métadonnées
- TranslationError: Contient des informations sur l’erreur si la traduction échoue
Fonctionnement
Détection du type de contenu
La méthode détecte automatiquement le type de contenu en fonction du paramètre source :
- Chaîne : Considérée comme du texte brut ou un format de message ICU
- Éléments JSX : Traités comme du contenu JSX à la manière de React
- Objets : Interprétés comme des formats de message structurés
Résolution de la locale
- La locale cible est validée conformément à la norme BCP‑47
- Des mappages de locales personnalisés sont appliqués s’ils sont configurés
- Des codes de locale canoniques sont utilisés pour les requêtes d’API
Enrichissement du contexte
Lorsque le mappage personnalisé inclut des codes de région ou d’écriture pour la locale cible, ils sont automatiquement ajoutés aux métadonnées afin d’améliorer la précision de la traduction.
Exemples
const gt = new GT({
apiKey: 'your-api-key',
projectId: 'your-project-id'
});
const result = await gt.translate('Bienvenue sur notre application', 'fr');
console.log(result);
// "Bienvenue sur notre application"Notes
- Traduit une chaîne donnée vers une locale cible et retourne une promesse
Prochaines étapes
Que pensez-vous de ce guide ?