MDN self-hosted library · e01.org

LanguageDetector

Translator and Language Detector APIs

Translator and Language Detector APIs

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
  • : The input quota available to the browser for detecting languages.
  • expectedInputLanguages
  • : 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()
  • : Releases the resources assigned to the LanguageDetector instance it is called on and stops any further activity on it.
  • 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

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

[!NOTE] Different implementations will likely support different languages.

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