tabs.toggleReaderMode()
切換指定標籤頁的閱讀模式。
此函式用於切換指定標籤頁的閱讀模式。它接受一個標籤頁 ID 作為引數：如果省略此引數，則會切換當前活動標籤頁。
這是一個非同步函式，返回一個 Promise。
閱讀模式，也稱為閱讀檢視，是一項瀏覽器功能，它透過
- 隱藏側邊欄、頁尾和廣告等非必要頁面元素，
- 調整頁面文字大小、對比度和佈局以提高可讀性，從而使使用者更容易專注於文章。
閱讀模式特別適用於文章：也就是說，主要內容是文字的正文的頁面。沒有可識別文章的頁面不符合在閱讀模式下顯示的條件。要確定一個頁面是否為文章，請檢查 tabs.Tab 的 isArticle 屬性。
要確定一個標籤頁是否已處於閱讀模式，請檢查 tabs.Tab 的 isInReaderMode 屬性。要跟蹤標籤頁進入或退出閱讀模式，您需要跟蹤所有標籤頁的當前狀態，並在 isInReaderMode 發生變化時進行檢查。
js
function handleUpdated(tabId, changeInfo, tabInfo) {
if (changeInfo.status === "complete") {
console.log(`Tab ${tabId} reader mode: ${tabInfo.isInReaderMode}`);
}
}
browser.tabs.onUpdated.addListener(handleUpdated);
語法
js
let toggling = browser.tabs.toggleReaderMode(
tabId // optional integer
)
引數
tabId可選-
integer。以閱讀模式顯示的標籤頁的 ID。預設為當前視窗的選定標籤頁。
返回值
一個 Promise，當標籤頁更新後，它將以無引數的形式完成。如果發生任何錯誤（例如，因為該頁面不是文章），Promise 將會因錯誤訊息而被拒絕。
示例
此程式碼將每個新頁面切換到閱讀模式（如果該頁面符合條件）。
js
function switchToReaderMode(tabId, changeInfo, tabInfo) {
if (changeInfo.isArticle) {
browser.tabs.toggleReaderMode(tabId);
}
}
browser.tabs.onUpdated.addListener(switchToReaderMode);
瀏覽器相容性
載入中…