大网数据广告活动
Web 标准与前端开发

LanguageDetector: detect() method

· 52CE 我爱测

The **`detect()`** method of the LanguageDetector interface detects the closest matching language or languages that a given text string is most likely to be written in.

Translator and Language Detector APIs

The detect() method of the LanguageDetector interface detects the closest matching language or languages that a given text string is most likely to be written in.

Syntax

detect(input)
detect(input, options)

Parameters

  • input
    • : A string representing the text to have its language detected.
  • options
    • : An object specifying configuration options for the detect() operation. Possible values include:
      • signal
        • : An AbortSignal object instance, which allows the detect() operation to be aborted via the associated AbortController.

Return value

A Promise that fulfills with an array of objects representing the detected languages. Each object contains the following properties:

  • detectedLanguage
    • : A BCP 47 language tag representing the detected language.
  • confidence
    • : A number between 0 and 1 representing the AI model's confidence that the detected language is correct.

The sum of all the returned confidence values should theoretically be 1, however, it may be lower because very low confidence values are excluded from the results.

The last array element returned will always have a detectedLanguage value of und — this is an abbreviation of "undetermined", and represents the probability that the text is not written in a language the model knows.

Exceptions

  • AbortError DOMException
    • : Thrown if the LanguageDetector was previously destroyed (had LanguageDetector.destroy() called on it, or was aborted via its abort signal after creation).
  • InvalidStateError DOMException
    • : Thrown if the current Document is not active.
  • QuotaExceededError
    • : Thrown if the language detection operation exceeds the available LanguageDetector.inputQuota.

Examples

Basic detect() usage

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

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
// und: 0.0003214875760022551

Specifications

Browser compatibility

See also

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。