LanguageDetector: create() 靜態方法

實驗性: 這是一項實驗性技術
在生產中使用此技術之前,請仔細檢查瀏覽器相容性表格

安全上下文: 此功能僅在安全上下文(HTTPS)中可用,且支援此功能的瀏覽器數量有限。

LanguageDetector 介面的 create() 靜態方法用於建立一個新的 LanguageDetector 例項來檢測語言。

注意: create() 方法需要 瞬時啟用,也就是說,它必須在響應使用者操作(如滑鼠點選或按鈕按下)時呼叫。

語法

js
LanguageDetector.create(options)

引數

options

一個用於配置 LanguageDetector 的選項物件。可能的值包括:

expectedInputLanguages

一個字串陣列,指定輸入文字的預期語言,這有助於提高語言檢測的準確性。這些應該是有效的 BCP 47 語言標籤。預設為 ["en"]

monitor 可選

一個帶有 CreateMonitor 引數的回撥函式,該函式允許監控 AI 模型的下載進度。

signal 可選

一個 AbortSignal 物件例項,允許透過關聯的 AbortController 中止 create() 操作。

返回值

一個 Promise,它會在解析時返回一個 LanguageDetector 物件例項。

異常

InvalidStateError DOMException

如果頁面的 Document 尚未啟用,則丟擲此異常。

NetworkError DOMException

在以下情況下丟擲

  • 網路不可用,無法下載 AI 模型。
  • 使用者已取消 AI 模型下載。
NotAllowedError DOMException

在以下情況下丟擲

NotSupportedError DOMException

在以下情況下丟擲

  • expectedInputLanguages 中指定的語言標籤無效或不受支援。
  • 不支援指定 expectedInputLanguages 的 AI 模型不可用。
OperationError DOMException

LanguageDetector 建立因任何其他原因失敗時丟擲的通用異常。

示例

基本 LanguageDetector 建立

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

規範

規範
翻譯器和語言檢測器 API
# dom-languagedetector-create

瀏覽器相容性

另見