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
var updating = browser.bookmarks.update(
id, // string
changes, // object
);
Paramètres
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)".
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
BCD tables only load in the browser
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.