LanguageDetector

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 Experimental

The input quota available to the browser for detecting languages.

expectedInputLanguages Read only Experimental

The expected languages to be detected in the input text.

Static methods

availability() Experimental

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

create() Experimental

Creates a new LanguageDetector instance to detect languages.

Instance methods

destroy() Experimental

Destroys the LanguageDetector instance it is called on.

detect() Experimental

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

measureInputUsage() Experimental

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

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

Detecting languages

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

Browser compatibility

See also

• Using the Translator and Language Detector APIs