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