action.getUserSettings()

获取浏览器操作的用户设置。

备注： 该 API 在 Manifest V3 或更高版本中可用。

这是一个返回 Promise 的异步函数。

语法

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

参数

无参数。

返回值

一个 Promise，会兑现包含下列属性的对象：

userSettings

包含由用户指定的浏览器操作设置的对象，具有下列属性：

isOnToolbar 可选

boolean，用户是否将该操作的图标固定到浏览器 UI。这一设置并不能指示操作图标是否可见。可见性取决于浏览器窗口的尺寸以及浏览器 UI 布局。

示例

以下代码输出指示操作是否被固定的信息：

js
function gotSettings(userSettings) {
  if (userSettings.isOnToolbar) {
    console.log("操作被固定到工具栏");
  } else {
    console.log("操作未被固定到工具栏。");
  }
}

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

浏览器兼容性

BCD tables only load in the browser

备注： 该 API 基于 Chromium 的 chrome.action API。