W3cubDocs

/Web APIs

LanguageDetector: expectedInputLanguages property

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

The expectedInputLanguages read-only property of the LanguageDetector interface returns the expected languages to be detected in the input text. Specifying expected input languages helps improve the accuracy of the language detection.

A LanguageDetector instance's expectedInputLanguages are set when creating it via a create() call.

Value

An array of strings specifying the expected input languages. These will be valid BCP 47 language tags (as specified in RFC 5646).

Examples

const detector = await LanguageDetector.create({
  expectedInputLanguages: ["en-US", "zh"],
});

// Logs ["en-US", "zh"]
console.log(detector.expectedInputLanguages);

Specifications

Specification
Translator and Language Detector APIs>
# dom-languagedetector-expectedinputlanguages>

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet WebView Android WebView on iOS
expectedInputLanguages
138Availability may be subject to geographical restrictions.
 No No
122Availability may be subject to geographical restrictions.
 No No No No No No No No

See also

© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/LanguageDetector/expectedInputLanguages