LanguageDetector: detect() Methode
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 detect() Methode der LanguageDetector Schnittstelle erkennt die am wahrscheinlichsten zutreffende Sprache oder Sprachen, in der ein gegebener Text geschrieben ist.
Syntax
detect(input)
detect(input, options)
Parameter
input-
Ein String, der den Text darstellt, dessen Sprache erkannt werden soll.
optionsOptional-
Ein Objekt, das Konfigurationsoptionen für die
detect()-Operation angibt. Mögliche Werte sind unter anderem:signal-
Ein
AbortSignal-Objekt, das es ermöglicht, diedetect()-Operation über den dazugehörigenAbortControllerabzubrechen.
Rückgabewert
Ein Promise, das mit einem Array von Objekten erfüllt wird, die die erkannten Sprachen darstellen. Jedes Objekt enthält die folgenden Eigenschaften:
detectedLanguage-
Ein BCP 47-Sprachentag, der die erkannte Sprache darstellt.
confidence-
Eine Zahl zwischen
0und1, die die Zuversicht des KI-Modells angibt, dass die erkannte Sprache korrekt ist.
Die Summe aller zurückgegebenen confidence-Werte sollte theoretisch 1 betragen, kann jedoch niedriger sein, da sehr niedrige Zuversichtswerte von den Ergebnissen ausgeschlossen werden.
Das letzte zurückgegebene Array-Element wird immer einen detectedLanguage Wert von und haben — dies steht für "undetermined" (unbestimmt) und repräsentiert die Wahrscheinlichkeit, dass der Text nicht in einer Sprache geschrieben ist, die das Modell kennt.
Ausnahmen
InvalidStateErrorDOMException-
Wird ausgelöst, wenn das aktuelle
Documentnicht aktiv ist. QuotaExceededErrorDOMException-
Wird ausgelöst, wenn die Sprachenerkennungsoperation die verfügbare
inputQuotaüberschreitet.
Beispiele
Grundlegende Verwendung von detect()
const detector = await LanguageDetector.create({
expectedInputLanguages: ["en-US", "zh"],
});
const results = await detector.detect(myTextString);
results.forEach((result) => {
console.log(`${result.detectedLanguage}: ${result.confidence}`);
});
// Results in logs like this:
// la: 0.8359838724136353
// es: 0.017705978825688362
// sv: 0.012977192178368568
// en: 0.011148443445563316
// und: 0.0003214875760022551
Spezifikationen
| Specification |
|---|
| Translator and Language Detector APIs # dom-languagedetector-detect |