bookmarks.create()

Crée un signet ou un dossier en tant qu'enfant de BookmarkTreeNode avec parentId spécifié. Pour créer un dossier, omettez ou laissez vide le paramètre CreateDetails#url.

Attention : Si votre extension tente de créer un nouveau signet dans le nœud racine de l'arborescence du signet, une erreur est générée: "La racine du signet ne peut pas être modifiée" et le signet ne sera pas créé.

C'est une fonction asynchrone qui renvoie une Promise.

Syntaxe

js
var createBookmark = browser.bookmarks.create(
  bookmark, // CreateDetails object
);

Paramètres

bookmark

Un objet bookmarks.CreateDetails.

Valeur retournée

Une Promise qui sera remplie avec un BookmarkTreeNode qui décrit le nouveau noeud de marque pages.

Exemples

Cet exemple crée un signet pour cette page, en le plaçant dans le dossier par défaut ("Autres signets" dans Firefox et Chrome).

js
function onCreated(node) {
  console.log(node);
}

var createBookmark = browser.bookmarks.create({
  title: "bookmarks.create() on MDN",
  url: "https://developer.mozilla.org/Add-ons/WebExtensions/API/bookmarks/create",
});

createBookmark.then(onCreated);

Example extensions

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.