Translator and Language Detector APIs

Eingeschränkt verfügbar

Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Die Translator- und Sprachenerkennungs-APIs bieten Funktionen zur Erkennung der Sprache, in der ein Text geschrieben ist, sowie zur Übersetzung von Texten in verschiedene Sprachen über ein internes KI-Modell des Browsers (das sich zwischen den Browsern unterscheiden kann).

Konzepte und Nutzung

Die Übersetzung eines Textkörpers ist eine gängige Aufgabe im heutigen Web. Typische Anwendungsfälle umfassen:

Sofortige Übersetzung eines Artikels, der nicht in Ihrer Sprache verfügbar ist.
Übersetzung von Kundenanfragen in eine Sprache, die der Support-Mitarbeiter versteht.
Ermöglichung von Chats zwischen Benutzern, die nicht die Sprache des jeweils anderen sprechen.

Die Erkennung der Sprache eines Textkörpers ist ein wichtiger Vorläufer für eine erfolgreiche automatisierte Übersetzung, hat jedoch auch andere Verwendungszwecke jenseits der direkten Übersetzung. Zum Beispiel ermöglicht sie die automatische Konfiguration der Benutzeroberfläche basierend auf der Texteingabe des Benutzers, angefangen vom Aktualisieren von Benutzeroberfläche und Fehlermeldungen bis hin zum automatischen Laden geeigneter Wörterbücher zur Rechtschreibprüfung oder zur Erkennung von Schimpfwörtern.

KI eignet sich hervorragend zur Unterstützung der Sprachenerkennung und Übersetzung. Die Translator- und Sprachenerkennungs-APIs bieten asynchrone (Promise-basierte) Mechanismen für eine Website, um Sprachen zu erkennen und Texte über das interne KI-Modell des Browsers zu übersetzen. Dies ist nützlich und effizient, da der Browser den Dienst verwaltet, anstatt dass der Entwickler darauf angewiesen ist, dass der Benutzer KI-Modelle herunterlädt oder einen cloudbasierten Übersetzungsdienst hostet oder dafür bezahlt.

Die Sprachenerkennung erfolgt über das LanguageDetector-Interface. Eine Instanz des Objekts LanguageDetector wird mit der statischen Methode LanguageDetector.create() erstellt, dann wird die Instanzmethode detect() mit dem Textstring übergeben, für den die Sprache erkannt werden soll.
Die Übersetzung erfolgt über das Translator-Interface. Eine Instanz des Objekts Translator wird mit der statischen Methode Translator.create() erstellt, dann wird die Instanzmethode translate() mit dem zu übersetzenden Textstring übergeben.

Sie können eine ausstehende create(), detect(), oder translate()-Operation mit einem AbortController abbrechen.

Nachdem eine Instanz von LanguageDetector oder Translator erstellt wurde, können Sie die zugewiesenen Ressourcen freigeben und jegliche weitere Aktivität stoppen, indem Sie die Methode LanguageDetector.destroy()/Translator.destroy() aufrufen. Es wird empfohlen, dies zu tun, nachdem Sie mit dem Objekt fertig sind, da es viele Ressourcen verbrauchen kann.

Siehe Verwendung der Translator- und Sprachenerkennungs-APIs für eine Schritt-für-Schritt-Anleitung zur Nutzung der APIs.

Schnittstellen

LanguageDetector: Beinhaltet alle Funktionen zur Sprachenerkennung, einschließlich der Überprüfung der Verfügbarkeit von KI-Modellen, der Erstellung einer neuen LanguageDetector-Instanz, der Nutzung zur Erkennung einer Sprache und mehr.
Translator: Beinhaltet alle Übersetzungsfunktionen, einschließlich der Überprüfung der Verfügbarkeit von KI-Modellen, der Erstellung einer neuen Translator-Instanz, der Nutzung zur Erstellung einer Übersetzung und mehr.

HTTP-Header

Permissions-Policy; die language-detector-Direktive: Steuert den Zugriff auf die Sprachenerkennungs-Funktionalität. Wenn eine Richtlinie deren Nutzung ausdrücklich verbietet, wird die statische Methode LanguageDetector.availability() unavailable zurückgeben, und jegliche Versuche, andere LanguageDetector-Methoden aufzurufen, werden mit einem NotAllowedError-DOMException fehlschlagen.
Permissions-Policy; die translator-Direktive: Steuert den Zugriff auf die Übersetzungs-Funktionalität. Wenn eine Richtlinie deren Nutzung ausdrücklich verbietet, wird die statische Methode Translator.availability() unavailable zurückgeben, und jegliche Versuche, andere Translator-Methoden aufzurufen, werden mit einem NotAllowedError-DOMException fehlschlagen.