tabs.reload()

重新加载选项卡，可以选择绕过本地 Web 缓存。

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

语法

js
let reloading = browser.tabs.reload(
  tabId,            // optional integer
  reloadProperties  // optional object
)

参数

tabId 可选

整数。要重新加载的选项卡的 ID。默认为当前窗口的选定选项卡。

reloadProperties 可选

具有以下属性的对象

bypassCache 可选

布尔值。绕过本地 Web 缓存。默认为 false。

返回值

一个Promise，当选项卡已重新加载时，该 Promise 将以无参数的方式 fulfilled。如果发生任何错误，则该 Promise 将以错误消息的形式 rejected。

示例

重新加载当前窗口的活动选项卡

js
browser.tabs.reload();

重新加载当前窗口的活动选项卡，并绕过缓存

js
browser.tabs.reload({ bypassCache: true });

重新加载 ID 为 2 的选项卡，绕过缓存并在完成后调用回调函数

js
function onReloaded() {
  console.log(`Reloaded`);
}

function onError(error) {
  console.log(`Error: ${error}`);
}

let reloading = browser.tabs.reload(2, { bypassCache: true });
reloading.then(onReloaded, onError);

扩展示例

浏览器兼容性

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

注意：此 API 基于 Chromium 的chrome.tabs API。本文档源自 Chromium 代码中的tabs.json。