tabs.reload()

重新加载标签页,可选择性地绕过本地 Web 缓存。

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

语法

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

参数

tabId 可选

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

reloadProperties 可选

具有以下属性的对象:

bypassCache 可选

boolean。绕过本地 Web 缓存。默认为 false

返回值

一个 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);

扩展程序示例

浏览器兼容性

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