bookmarks.update()

bookmarks.update() met à jour le titre et / ou l'URL d'un signet ou le nom d'un dossier de signets.

Attention : Si votre extension tente de mettre à jour un signet dans le nœud racine de l'arborescence de signets, l'appel déclenche une erreur avec le message suivant: "La racine du signet ne peut pas être modifiée" et le signet ne sera pas mis à jour.

C'est une fonction asynchrone qui renvoie une Promise.

Syntaxe

js
var updating = browser.bookmarks.update(
  id, // string
  changes, // object
);

Paramètres

id

Un string spécifiant l'ID du dossier de signet ou de dossier de signets à mettre à jour.

changes

Un object spécifiant les changements à appliquer, avec une combinaison des champs suivants. Tous les éléments non spécifiés ne sont pas modifiés dans le signet ou le dossier référencé :

title Facultatif

Un string contenant le nouveau titre du signet, ou le nouveau nom du dossier si l'id fait référence à un dossier.

url Facultatif

Un string fournissant une nouvelle URL pour le signet.

Valeur retournée

Une Promise qui sera satisfaite avec un seul objet bookmarks.BookmarkTreeNode représentant le signet mis à jour. Si l'élément de signet correspondant au paramètre id ne peut pas être trouvé, la promesse est rejetée.

Exemples

Cet exemple renomme tous les dossiers nommés "MDN" en "Mozilla Developer Network (MDN)".

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

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

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

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

Compatibilité des navigateurs

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
update

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

Note :

Cette API est basée sur l'API Chromium chrome.bookmarks. Cette documentation provient de bookmarks.json dans le code Chromium.

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.