browserAction.getUserSettings()

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

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

语法

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

参数

此函数不接受参数。

返回值

一个 Promise,它会完成并返回一个具有以下属性的对象

userSettings

包含浏览器操作用户指定设置的对象,具有以下属性

isOnToolbar 可选

boolean。用户是否已将操作图标固定到浏览器 UI。此设置不表示操作图标是否可见。图标的可见性取决于浏览器窗口的大小和浏览器 UI 的布局。

示例

此代码将记录一条消息,指示浏览器操作是否已固定。

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

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

浏览器兼容性

BCD 表仅在启用了 JavaScript 的浏览器中加载。