bookmarks.get()

Étant donné l'ID d'un bookmarks.BookmarkTreeNode ou d'un tableau de ces ID, la méthode bookmarks.get() récupère les nœuds correspondants.

C'est une fonction asynchrone qui renvoie une promise.

Syntaxe

js
var getBookmarks = browser.bookmarks.get(
  idOrIdList, // string or string array
);

Paramètres

idOrIdList

string Une string ou un array de chaînes spécifiant les ID d'un ou plusieurs objets BookmarkTreeNode à récupérer.

Valeur retournée

Une promise qui sera remplie avec un tableau de BookmarkTreeNode, un pour chaque nœud correspondant. Les séparateurs ne sont pas inclus dans les résultats. Si aucun noeud n'a pu être trouvé, la promesse sera rejetée avec un message d'erreur.

Exemples

Cet exemple essaie d'obtenir le signet dont l'ID est bookmarkAAAA. Si aucun signet avec cet ID n'existe, onRejected est appelé :

js
function onFulfilled(bookmarks) {
  console.log(bookmarks);
}

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

var gettingBookmarks = browser.bookmarks.get("bookmarkAAAA");
gettingBookmarks.then(onFulfilled, 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.