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 des LanguageDetector Interface erkennt die am ehesten passende Sprache oder Sprachen, in denen ein gegebener Text geschrieben ist.
Syntax
detect(input)
detect(input, options)
Parameter
input-
Ein String, der den zu analysierenden Text repräsentiert, um dessen Sprache erkannt zu werden.
optionsOptional-
Ein Objekt, das Konfigurationsoptionen für die
detect()Operation spezifiziert. Mögliche Werte sind:signal-
Eine Instanz eines
AbortSignalObjekts, die es ermöglicht, diedetect()Operation über den zugehörigenAbortControllerabzubrechen.
Rückgabewert
Ein Promise, das mit einem Array von Objekten erfüllt wird, 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 darstellt, dass die erkannte Sprache korrekt ist.
Die Summe aller zurückgegebenen confidence Werte sollte theoretisch 1 sein, kann aber niedriger sein, da sehr niedrige Vertrauenswerte aus 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 "undetermined" und repräsentiert die Wahrscheinlichkeit, dass der Text nicht in einer vom Modell bekannten Sprache geschrieben ist.
Ausnahmen
AbortErrorDOMException-
Wird ausgelöst, wenn der
LanguageDetectorzuvor zerstört wurde (es wurdeLanguageDetector.destroy()darauf aufgerufen oder er wurde über sein Abbruch-signalabgebrochen)signalnach Erstellung). InvalidStateErrorDOMException-
Wird ausgelöst, wenn das aktuelle
Documentnicht aktiv ist. QuotaExceededError-
Wird ausgelöst, wenn die Sprachenerkennungsoperation das verfügbare
inputQuotaüberschreitet.
Beispiele
Grundlegende detect() Nutzung
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 |