tabs.reload()

重新加载一个标签页,可选择是否绕过本地 web 缓存。

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

语法

js
let reloading = browser.tabs.reload(
  tabId,            // 可选的整数
  reloadProperties  // 可选的对象
)

参数

tabId 可选

integer。要重新加载的标签页的 ID。默认为当前窗口中选定的标签页。

reloadProperties 可选

一个包含以下属性的对象:

bypassCache 可选

boolean。是否绕过本地 web 缓存。默认为 false

返回值

一个 Promise,当标签页重新加载完成时其会被兑现且不带有参数。如果发生任何错误,promise 会错误信息拒绝。

示例

重新加载当前窗口中的活动标签页:

js
browser.tabs.reload();

重新加载当前窗口中的活动标签页,并绕过缓存:

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

重新加载 ID 为 2 的标签页,并绕过缓存,完成后调用回调函数:

js
function onReloaded() {
  console.log(`已重新加载`);
}

function onError(error) {
  console.log(`发生错误:${error}`);
}

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

示例扩展

浏览器兼容性

BCD tables only load in the browser

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