bookmarks.getChildren()

bookmarks.getChildren() 用於檢索書籤資料夾的所有直接子級,該資料夾由 BookmarkTreeNode ID 標識。

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

語法

js
let gettingChildren = browser.bookmarks.getChildren(
  id                     // string
)

引數

id

一個 string,指定要檢索其子級的資料夾的 ID。

返回值

一個 Promise,該 Promise 會解析為一個 BookmarkTreeNode 物件陣列。每個條目代表一個子節點。列表的順序與書籤在使用者介面中顯示的順序相同。分隔符包含在結果中。列表包括子資料夾,但不包括子資料夾中包含的任何子級。

如果指定的節點沒有子級,則陣列為空。

如果找不到由 id 標識的節點,則 Promise 會因錯誤訊息而被拒絕。

示例

js
function onFulfilled(children) {
  for (child of children) {
    console.log(child.id);
  }
}

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

let gettingChildren = browser.bookmarks.getChildren("unfiled_____");
gettingChildren.then(onFulfilled, onRejected);

瀏覽器相容性

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