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 besten passende Sprache oder Sprachen, in denen ein gegebener Textstring wahrscheinlich 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 beinhalten:signal-
Eine Instanz des
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 language tag, das die erkannte Sprache repräsentiert.
confidence-
Eine Zahl zwischen
0und1, die das Vertrauen 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 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 "unbestimmt" und repräsentiert die Wahrscheinlichkeit, dass der Text nicht in einer dem Modell bekannten Sprache verfasst ist.
Ausnahmen
InvalidStateErrorDOMException-
Wird ausgelöst, wenn das aktuelle
Documentnicht aktiv ist. QuotaExceededError-
Wird ausgelöst, wenn die Sprachenerkennungsoperation das 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 |
Browser-Kompatibilität
Loading…