bookmarks.create()

Создаёт закладку или папку как дочерний элемент BookmarkTreeNode с указанными parentId. Чтобы создать папку, опустите или оставьте пустым параметр CreateDetails.url.

Предупреждение: Если ваше расширение пытается создать новую закладку в корневом узле дерева закладок, возникает ошибка: «Корень закладок изменить нельзя», и закладка не будет создана.

Это асинхронная функция, которая возвращает Promise.

Синтаксис

let createBookmark = browser.bookmarks.create(
  bookmark                  // CreateDetails object
)

Параметры

bookmark: Объект bookmarks.CreateDetails.

Возвращаемое значение

Объект Promise, который будет выполнен с BookmarkTreeNode, описывающим новый узел закладки.

Примечание: Если вы создаёте несколько закладок, из-за асинхронности API вызовы create могут обрабатываться в произвольном порядке. Следовательно, значение индекса каждой закладки, возвращаемое в BookmarkTreeNode, может измениться или быть неизвестным до завершения всех вызовов create. Если индекс, связанный с закладкой, важен для вашего расширения, при создании нескольких закладок расширение должно дождаться завершения каждого вызова bookmarks.create перед созданием следующей закладки. Ожидание гарантирует, что индекс, связанный с каждой закладкой, не повлияет на вызов create, выполняемый одновременно, пока исходный вызов не завершён.

Примеры

В этом примере создаётся закладка на эту страницу и размещается она в папке по умолчанию ("Другие закладки" в Firefox и Chrome).

function onCreated(node) {
  console.log(node);
}

let createBookmark = browser.bookmarks.create({
  title: "bookmarks.create() on MDN",
  url: "https://developer.mozilla.org/Add-ons/WebExtensions/API/bookmarks/create",
});

createBookmark.then(onCreated);

Примеры расширений

bookmark-it

Совместимость с браузерами

	Рабочий стол						Мобильные устройства
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox для Android	Opera Android	Safari на IOS	Samsung Internet
`create`	Да	15	45	?	Да	Нет	?	?	Нет	?	Нет	?

Примечание: Этот API основан на API chrome.bookmarks Chromium. Данная документация взята из bookmarks.json кода Chromium.

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/bookmarks/create