translate
Riferimento API per il metodo GT translate
Panoramica
Il metodo translate è la funzione principale di traduzione nella libreria GT.
Traduce i contenuti dalla lingua di origine alla lingua di destinazione specificata utilizzando servizi di traduzione basati sull’IA.
const gt = new GT({
apiKey: 'your-api-key',
projectId: 'your-project-id'
});
const result = await gt.translate('Ciao, mondo!', 'es');
console.log(result); // "¡Hola, mundo!"Il metodo supporta più tipi di contenuto, tra cui testo semplice, messaggi in formato ICU e messaggi in stile i18next, con metadati opzionali per migliorare l’accuratezza della traduzione.
Autenticazione richiesta:
Il metodo translate richiede che apiKey (o devApiKey) e projectId siano configurati nell’istanza di GT.
Riferimenti
Parametri
Il metodo translate offre più overload per diversi tipi di contenuto:
Contenuti di testo
Prop
Type
Contenuto JSX
Prop
Type
Formato dei messaggi ICU
Prop
Type
Formato i18next
Prop
Type
Descrizione dei parametri
| Parametro | Descrizione |
|---|---|
source | Contenuto da tradurre. Può essere testo in chiaro, elementi JSX, messaggi ICU o messaggi i18next |
targetLocale | Codice locale BCP‑47 della lingua di destinazione (es. "es", "fr-CA") |
metadata | Contesto di traduzione opzionale, inclusi contesto, tag e opzioni di formattazione |
Valori restituiti
Promise<TranslationResult | TranslationError>- TranslationResult: Contiene il contenuto tradotto e i metadati
- TranslationError: Contiene le informazioni sull’errore se la traduzione non riesce
Comportamento
Rilevamento del tipo di contenuto
Il metodo rileva automaticamente il tipo di contenuto in base al parametro source:
- String: Considerata come testo semplice o messaggio in formato ICU
- Elementi JSX: Gestiti come contenuto JSX in stile React
- Oggetti: Elaborati come formati di messaggio strutturati
Risoluzione della locale
- La locale di destinazione viene convalidata secondo lo standard BCP‑47
- Se configurate, vengono applicate mappature personalizzate delle locali
- Per le richieste API vengono usati codici locale canonici
Miglioramento del contesto
Quando il mapping personalizzato include codici di regione o di script per la locale di destinazione, questi vengono aggiunti automaticamente ai metadati per migliorare la precisione della traduzione.
Esempi
const gt = new GT({
apiKey: 'your-api-key',
projectId: 'your-project-id'
});
const result = await gt.translate('Benvenuti nella nostra applicazione', 'fr');
console.log(result);
// "Benvenuti nella nostra applicazione"Note
- Traduce una stringa fornita nella locale di destinazione e restituisce una promise
Prossimi passi
Come valuti questa guida?