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
。