translate
Référence de l’API pour la méthode translate de GT
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 optimisés par l’IA.
const gt = new GT({
apiKey: 'votre-clé-api',
projectId: 'votre-id-projet'
});
const result = await gt.translate('Bonjour, le monde !', '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 des traductions.
Authentification requise :
La méthode translate nécessite que apiKey (ou devApiKey) et projectId soient configurés dans l’instance de GT.
Référence
Paramètres
La méthode translate propose plusieurs surcharges pour 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 mise en forme |
Renvoi
Promise<TranslationResult | TranslationError>- TranslationResult: Contient le contenu traduit et les métadonnées
- TranslationError: Contient les informations sur l’erreur si la traduction échoue
Comportement
Détection du type de contenu
La méthode détecte automatiquement le type de contenu en fonction du paramètre source :
- Chaîne : Traitée comme du texte brut ou comme un format de message ICU
- Éléments JSX : Traités comme du contenu JSX au style React
- Objets : Traités comme des formats de message structurés
Résolution de la locale
- La locale cible est validée conformément aux normes 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 API
Amélioration du contexte
Lorsque le mapping personnalisé inclut des codes de région ou d’écriture pour le 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 dans notre application', 'fr');
console.log(result);
// "Bienvenue dans notre application"Notes
- Traduit une chaîne donnée vers une locale cible et renvoie une promesse
Prochaines étapes
Comment trouvez-vous ce guide ?