bookmarks.create()
作為指定 parentId 的 BookmarkTreeNode 的子項,建立書籤或資料夾。要建立資料夾,請省略或留空 CreateDetails#url 引數。
警告: 如果您的擴充套件程式嘗試在書籤樹的根節點中建立新書籤,它將引發一個錯誤:“無法修改書籤根目錄”,並且該書籤將不會被建立。
這是一個非同步函式,返回一個 Promise。
語法
js
let createBookmark = browser.bookmarks.create(
bookmark // CreateDetails object
)
引數
bookmark-
一個
bookmarks.CreateDetails物件。
返回值
一個 Promise,它將以一個描述新書籤節點的 BookmarkTreeNode 來兌現。
注意: 如果您建立多個書籤,由於此 API 是非同步的,建立呼叫可能會以任何順序處理。因此,每個書籤在 BookmarkTreeNode 中返回的 index 值在所有建立呼叫完成後可能會發生變化或未知。如果與書籤關聯的 index 對您的擴充套件很重要,那麼 – 在建立多個書籤時 – 擴充套件程式應該在建立下一個書籤之前等待每個 bookmarks.create 呼叫完成。等待可確保每個書籤關聯的 index 不受在原始呼叫進行過程中併發執行的建立呼叫的影響。
示例
此示例為本頁面建立一個書籤,並將其放置在預設資料夾中(在 Firefox 和 Chrome 中為“其他書籤”)。
js
function onCreated(node) {
console.log(node);
}
let createBookmark = browser.bookmarks.create({
title: "bookmarks.create() on MDN",
url: "https://mdn.club.tw/Add-ons/WebExtensions/API/bookmarks/create",
});
createBookmark.then(onCreated);
擴充套件程式示例
瀏覽器相容性
載入中…
注意: 此 API 基於 Chromium 的 chrome.bookmarks API。本文件源自 Chromium 程式碼中的 bookmarks.json。