bookmarks.removeTree()

bookmarks.removeTree() 方法會遞迴地刪除書籤資料夾及其所有內容。

警告: 如果您的擴充套件程式嘗試從書籤樹根節點刪除書籤樹,該呼叫將引發一個錯誤,訊息為:“書籤根目錄無法修改”,並且書籤不會被刪除。

這是一個非同步函式,返回一個 Promise

語法

js
let removingTree = browser.bookmarks.removeTree(
  id                // string
)

引數

id

一個 string,指定要刪除的資料夾節點的 ID 及其後代。

返回值

一個 Promise,當樹已被移除時,它將以無引數的形式 fulfilled。

如果找不到與 id 引數對應的節點,Promise 將以錯誤訊息被 rejected。

示例

此示例將找到一個名為“MDN”的書籤資料夾,並將其連同所有內容一起刪除。

js
function onRemoved() {
  console.log("bookmark item removed!");
}

function onRejected(error) {
  console.log(`An error: ${error}`);
}

function removeMDN(searchResults) {
  if (searchResults.length) {
    let removing = browser.bookmarks.removeTree(searchResults[0].id);
    removing.then(onRemoved, onRejected);
  }
}

let searchingBookmarks = browser.bookmarks.search({ title: "MDN" });
searchingBookmarks.then(removeMDN, onRejected);

瀏覽器相容性

注意: 此 API 基於 Chromium 的 chrome.bookmarks API。本文件來源於 Chromium 程式碼中的 bookmarks.json