LanguageDetector: detect() Methode
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Die detect()-Methode des LanguageDetector-Interfaces erkennt die am besten passende Sprache oder Sprachen, in denen ein gegebener Textstring höchstwahrscheinlich 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 den
detect()-Vorgang angibt. Mögliche Werte sind:signal-
Eine
AbortSignal-Objektinstanz, die es ermöglicht, dendetect()-Vorgang über den zugehörigenAbortControllerabzubrechen.
Rückgabewert
Ein Promise, das ein Array von Objekten zurückgibt, die die erkannten Sprachen repräsentieren. Jedes Objekt enthält die folgenden Eigenschaften:
detectedLanguage-
Ein BCP 47 Sprach-Tag, das die erkannte Sprache repräsentiert.
confidence-
Eine Zahl zwischen
0und1, die das Vertrauen des KI-Modells anzeigt, dass die erkannte Sprache korrekt ist.
Die Summe aller zurückgegebenen confidence-Werte sollte theoretisch 1 betragen, kann jedoch geringer sein, da sehr niedrige Vertrauenswerte von den Ergebnissen ausgeschlossen werden.
Das letzte zurückgegebene Array-Element wird immer einen detectedLanguage-Wert von und haben – dies ist eine Abkürzung für "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 der Sprachenerkennungsvorgang das verfügbare
inputQuotaüberschreitet.
Beispiele
Grundlegende detect()-Verwendung
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 |