LanguageDetector

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

The LanguageDetector interface of the Translator and Language Detector APIs contains all the language detection functionality, including checking AI model availability, creating a new LanguageDetector instance, using it to detect a language, and more.

Instance properties

inputQuota Read only

The input quota available to the browser for detecting languages.

expectedInputLanguages Read only

The expected languages to be detected in the input text.

Static methods

availability()

Returns an enumerated value that indicates whether the browser AI model supports a given LanguageDetector configuration.

create()

Creates a new LanguageDetector instance to detect languages.

Instance methods

destroy()

Destroys the LanguageDetector instance it is called on.

detect()

Detects the closest matching language or languages that a given text string is most likely to be written in.

measureInputUsage()

Reports how much input quota would be used by a language detection operation for a given text input.

Examples

See Using the Translator and Language Detector APIs for a complete example.

Creating a LanguageDetector instance

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

Note: Different implementations will likely support different languages.

Detecting languages

js
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

Specifications

No specification found

No specification data found for api.LanguageDetector.
Check for problems with this page or contribute a missing spec_url to mdn/browser-compat-data. Also make sure the specification is included in w3c/browser-specs.

See also