bookmarks.move()
La méthode bookmarks.move()
déplace le BookmarkTreeNode
à la destination spécifiée dans l'arborescence des signets. Cela vous permet de déplacer un signet vers un nouveau dossier et / ou une position dans le dossier.
Attention : Si votre extension tente de déplacer 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 déplacement ne sera pas terminé.
C'est une fonction asynchrone qui renvoie une Promise
.
Syntaxe
var movingBookmark = browser.bookmarks.move(
id, // string
destination, // object
);
Paramètres
id
-
Un
string
contenant l'ID du signet ou du dossier à déplacer. destination
-
Un
object
qui spécifie la destination du signet. Cet objet doit contenir un ou les deux champs suivants :parentId
Facultatif-
Un
string
qui spécifie l'ID du dossier de destination. Si cette valeur est omise, le signet est déplacé vers un nouvel emplacement dans son dossier actuel. index
Facultatif-
Un index basé sur 0 spécifiant la position dans le dossier vers lequel déplacer le signet. La valeur 0 déplace le signet vers le haut du dossier. Si cette valeur est omise, le signet est placé à la fin du nouveau dossier parent..
Valeur retournée
Une Promise
qui sera remplie avec un seul objet bookmarks.BookmarkTreeNode
décrivant le noeud déplacé.Si le noeud correspondant au paramètre id
ne peut pas être trouvé, la promesse est rejetée avec un message d'erreur.
Exemples
Cet exemple déplace un signet afin qu'il soit le premier signet dans son dossier actuel.
function onMoved(bookmarkItem) {
console.log(bookmarkItem.index);
}
function onRejected(error) {
console.log(`An error: ${error}`);
}
var bookmarkId = "abcdefghilkl";
var movingBookmark = browser.bookmarks.move(bookmarkId, { index: 0 });
movingBookmark.then(onMoved, 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.