Translator and Language Detector APIs

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 Language Detector-APIs bieten Funktionen zur Erkennung der Sprache, in der ein Text geschrieben ist, und zur Übersetzung von Texten in verschiedene Sprachen über das interne KI-Modell eines Browsers (was je nach Browser unterschiedlich sein kann).

Konzepte und Nutzung

Die Übersetzung von Texten ist eine häufige Aufgabe im heutigen Web. Typische Anwendungsfälle sind:

Spontane Übersetzung eines Artikels, der in Ihrer Sprache nicht verfügbar ist.
Übersetzung von Supportanfragen eines Benutzers in eine Sprache, die der Support-Mitarbeiter versteht.
Erleichterung von Chats zwischen Benutzern, die nicht die gleiche Sprache sprechen.

Die Erkennung der Sprache eines Textes ist ein wichtiger Schritt für eine erfolgreiche automatisierte Übersetzung, hat jedoch auch andere Anwendungen jenseits der direkten Übersetzung. So ermöglicht sie zum Beispiel die automatische Konfiguration der Benutzeroberfläche basierend auf der Texteintragung des Benutzers, von der Aktualisierung der UI- und Fehlermeldungen bis hin zum automatischen Laden geeigneter Wörterbücher für die Rechtschreibprüfung oder Schimpfworterkennung.

KI eignet sich hervorragend zur Unterstützung bei der Spracherkennung und Übersetzung. Die Translator- und Language Detector-APIs bieten asynchrone (Promise-basierte) Mechanismen, um auf einer Website 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 übernimmt, anstatt dass der Entwickler darauf angewiesen ist, dass der Benutzer KI-Modelle herunterlädt oder einen cloudbasierten Übersetzungsdienst hosten oder bezahlen muss.

Die Spracherkennung erfolgt über die LanguageDetector Schnittstelle. Ein LanguageDetector-Objekt wird mit der statischen Methode LanguageDetector.create() erstellt, dann wird die detect() Instanzmethode aufgerufen und der zu erkennende Text übergeben.
Die Übersetzung erfolgt über die Translator Schnittstelle. Ein Translator-Objekt wird mit der statischen Methode Translator.create() erstellt, dann wird die translate() Instanzmethode aufgerufen und der zu übersetzende Text übergeben.

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

Nachdem eine LanguageDetector- oder Translator-Instanz erstellt wurde, können Sie ihre zugewiesenen Ressourcen freigeben und jegliche weitere Aktivität stoppen, indem Sie die LanguageDetector.destroy()/Translator.destroy() Methode aufrufen. Es wird empfohlen, dies zu tun, nachdem Sie das Objekt nicht mehr benötigen, da es viele Ressourcen verbrauchen kann.

Siehe Nutzung der Translator- und Language Detector-APIs für eine Schritt-für-Schritt-Anleitung zur Nutzung der APIs.

Schnittstellen

LanguageDetector Experimentell: Beinhaltet alle Funktionen zur Spracherkennung, einschließlich der Überprüfung der Verfügbarkeit des KI-Modells, der Erstellung einer neuen LanguageDetector-Instanz, der Verwendung zur Spracherkennung und mehr.
Translator Experimentell: Beinhaltet alle Funktionen zur Übersetzung, einschließlich der Überprüfung der Verfügbarkeit des KI-Modells, der Erstellung einer neuen Translator-Instanz, der Nutzung zur Übersetzung und mehr.

HTTP-Header

Permissions-Policy; die Direktive language-detector: Kontrolliert den Zugriff auf die Spracherkennungsfunktion. Wo eine Richtlinie ihre Nutzung ausdrücklich untersagt, wird jeder Versuch, die LanguageDetector-Methoden aufzurufen, mit einem NotAllowedError DOMException fehlschlagen.
Permissions-Policy; die Direktive translator: Kontrolliert den Zugriff auf die Übersetzungsfunktion. Wo eine Richtlinie ihre Nutzung ausdrücklich untersagt, wird jeder Versuch, die Translator-Methoden aufzurufen, mit einem NotAllowedError DOMException fehlschlagen.