LanguageDetector

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 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(): 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

Translator and Language Detector APIs