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 der ein gegebener Textstring höchstwahrscheinlich geschrieben ist.
Syntax
detect(input)
detect(input, options)
Parameter
input-
Ein String, der den zu analysierenden Text repräsentiert, um seine Sprache zu erkennen.
optionsOptional-
Ein Objekt, das Konfigurationsoptionen für den
detect()Vorgang angibt. Mögliche Werte sind:signal-
Eine Instanz des
AbortSignalObjekts, welches ermöglicht, dendetect()Vorgang ü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, jedoch kann sie niedriger sein, weil sehr niedrige Vertrauenswerte aus den Ergebnissen ausgeschlossen sind.
Das zuletzt zurückgegebene Array-Element wird immer einen detectedLanguage Wert von und haben — dies ist eine Abkürzung 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. QuotaExceededError-
Wird ausgelöst, wenn der Sprachenerkennungsvorgang das verfügbare
inputQuotaüberschreitet.
Beispiele
Grundlegende Nutzung 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…