action.getUserSettings()

獲取使用者為瀏覽器操作指定的設定。

注意:此 API 在 Manifest V3 或更高版本中可用。

這是一個非同步函式,返回一個 Promise

語法

js
let userSettings = await browser.action.getUserSettings();

引數

此函式不接受任何引數。

返回值

一個 Promise,它將以具有這些屬性的物件解析

userSettings

一個包含瀏覽器操作使用者指定設定的物件,具有以下屬性:

isOnToolbar 可選

boolean。使用者是否已將操作的圖示固定到瀏覽器介面。此設定不表示圖示是否可見。圖示的可見性取決於瀏覽器視窗的大小和瀏覽器介面的佈局。

示例

此程式碼記錄一條訊息,指示操作是否已固定

js
function gotSettings(userSettings) {
  if (userSettings.isOnToolbar) {
    console.log("Action is pinned to toolbar.");
  } else {
    console.log("Action is not pinned to toolbar.");
  }
}

let gettingUserSettings = browser.action.getUserSettings();
gettingUserSettings.then(gotSettings);

瀏覽器相容性

注意:此 API 基於 Chromium 的 chrome.action API。