i18n.detectLanguage()

Detects the language of the provided text using the Compact Language Detector (CLD).

This is an asynchronous function that returns a Promise.

See the Internationalization page for a guide on using this function.

Syntax

js
let detectingLanguages = browser.i18n.detectLanguage(
  text                  // string
)

Parameters

text

string. User input string to be translated.

Return value

A Promise that will be fulfilled with a result object. The result object has two properties:

isReliable

boolean. Whether the language was detected reliably.

languages

array of objects, each of which has two properties:

language

i18n.LanguageCode. The detected language.

percentage

integer. The percentage of the input string that was in the detected language.

Browser compatibility

Examples

js
function onLanguageDetected(langInfo) {
  for (const lang of langInfo.languages) {
    console.log(`Language is: ${lang.language}`);
    console.log(`Percentage is: ${lang.percentage}`);
  }
}

let text = "L'homme est né libre, et partout il est dans les fers.";

let detecting = browser.i18n.detectLanguage(text);
detecting.then(onLanguageDetected);

Note: This API is based on Chromium's chrome.i18n API. This documentation is derived from i18n.json in the Chromium code.