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

C'est une fonction asynchrone qui renvoie une Promise.

Syntaxe

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.

Compatibilité du navigateur

ChromeEdgeFirefoxFirefox for AndroidOpera
Support simple Oui1545 Non Oui

Exemples

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

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);

Remerciements :

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.

Étiquettes et contributeurs liés au document

Contributeurs à cette page : hellosct1
Dernière mise à jour par : hellosct1,