translate
API-Referenz für die GT-Methode translate
Überblick
Die Methode translate ist die primäre Übersetzungsfunktion in der GT‑Bibliothek.
Sie übersetzt Inhalte von der Quell-Locale in eine angegebene Ziel-Locale mithilfe KI-gestützter Übersetzungsdienste.
const gt = new GT({
apiKey: 'your-api-key',
projectId: 'your-project-id'
});
const result = await gt.translate('Hallo, Welt!', 'es');
console.log(result); // "¡Hola, mundo!"Die Methode unterstützt mehrere Inhaltstypen, darunter Klartext, das ICU Message Format und i18next‑Stil‑Nachrichten, mit optionalen Metadaten zur Verbesserung der Übersetzungsgenauigkeit.
Authentifizierung erforderlich:
Die Methode translate setzt voraus, dass sowohl apiKey (oder devApiKey) als auch projectId in der GT‑Instanz konfiguriert sind.
Referenzen
Parameter
Die Methode translate bietet mehrere Überladungen für verschiedene Inhaltstypen:
Textinhalt
Prop
Type
JSX-Inhalte
Prop
Type
ICU MessageFormat
Prop
Type
i18next-Format
Prop
Type
Parameterbeschreibung
| Parameter | Beschreibung |
|---|---|
source | Der zu übersetzende Inhalt. Kann Klartext, JSX-Elemente, ICU-Nachrichten oder i18next-Nachrichten sein |
targetLocale | BCP-47-Locale-Code für die Zielsprache (z. B. „es“, „fr-CA“) |
metadata | Optionaler Übersetzungskontext, einschließlich Kontext, Tags und Formatierungsoptions |
Rückgabewerte
Promise<TranslationResult | TranslationError>- TranslationResult: Enthält den übersetzten Inhalt und zugehörige Metadaten
- TranslationError: Enthält Fehlermeldungen, falls die Übersetzung fehlschlägt
Verhalten
Erkennung des Inhaltstyps
Die Methode erkennt den Inhaltstyp automatisch anhand des Parameters source:
- String: Als Klartext oder im ICU-Message-Format
- JSX Elements: Als React‑typischer JSX‑Inhalt
- Objects: Als strukturierte Nachrichtenformate
Locale-Resolution
- Ziel-locale wird anhand der BCP-47-Standards validiert
- Benutzerdefinierte locale-Mappings werden angewendet, wenn konfiguriert
- Kanonische locale codes werden für API-Anfragen verwendet
Kontextverbesserung
Wenn ein benutzerdefiniertes Mapping Regions- oder Skriptcodes für die Ziel-locale enthält, werden diese automatisch den Metadaten hinzugefügt, um die Übersetzungsgenauigkeit zu verbessern.
Beispiele
const gt = new GT({
apiKey: 'Ihr apiKey',
projectId: 'Ihre projectId'
});
const result = await gt.translate('Willkommen in unserer Anwendung', 'fr');
console.log(result);
// "Willkommen in unserer Anwendung"Hinweise
- Übersetzt eine angegebene Zeichenfolge in eine Ziel-Locale und gibt ein Promise zurück
Nächste Schritte
Wie ist diese Anleitung?