Spec-Zone.ru › Web Extensions

bookmarks.update()

bookmarks.update() обновляет заголовок и/или URL закладки, или имя папки закладок.

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

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

Синтаксис

let updating = browser.bookmarks.update(
  id,                    // string
  changes                // object
)

Параметры

id

A string определяющий идентификатор закладки или папки закладок для обновления.

changes

An object определяющий изменения, которые нужно применить, используя сочетание следующих полей. Любые отсутствующие элементы не изменяют соответствующую закладку или папку:

title Необязательно

A string содержащий новый заголовок закладки или новое имя папки, если id относится к папке.

url Необязательно

A string содержащий новый URL для закладки.

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

A Promise, который будет выполнен с одиночным объектом bookmarks.BookmarkTreeNode, представляющим обновлённую закладку. Если элемент закладки, соответствующий параметру id, не найден, обещание отклоняется.

Примеры

В этом примере переименовываются все папки с именем "MDN" в "Mozilla Developer Network (MDN)".

function onFulfilled(bookmarkItem) {
  console.log(bookmarkItem.title);
}

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

function updateFolders(items) {
  for (const item of items) {
    // only folders, so skip items with a `url`
    if (!item.url) {
      browser.bookmarks
        .update(item.id, {
          title: "Mozilla Developer Network (MDN)",
        })
        .then(onFulfilled, onRejected);
    }
  }
}

browser.bookmarks.search({ title: "MDN" }).then(updateFolders, onRejected);

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

Рабочий стол Мобильные устройства
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
update Да 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/update

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API