i18n.detectLanguage()

使用 Compact Language Detector (CLD) 检测提供的文本的语言。

这是一个异步函数,返回一个 Promise

有关使用此函数的指南,请参阅国际化页面。

语法

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

参数

文本

string。用户输入的待翻译字符串。

返回值

一个 Promise,它将以一个结果对象来 fulfilled。该结果对象有两个属性:

isReliable

boolean。语言是否被可靠地检测出来。

languages

对象数组,每个对象有两个属性:

language

i18n.LanguageCode。检测到的语言。

percentage

integer。输入字符串中属于检测到的语言的百分比。

示例

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);

浏览器兼容性

注意:此 API 基于 Chromium 的 chrome.i18n API。本文档源自 Chromium 代码中的 i18n.json