LanguageDetector

Limited availabilitySecure context

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
  • : Releases the resources assigned to the LanguageDetector instance it is called on and stops any further activity on it.
• 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"],
});

[!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

• Using the Translator and Language Detector APIs