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.

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.

Compatibilité du navigateur

ChromeEdgeFirefoxFirefox for AndroidOpera
Support simple Oui1545 Non Oui

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

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,