bookmarks.search()

query

Ein string oder object, das die durchzuführende Abfrage beschreibt.

Wenn query ein string ist, besteht es aus null oder mehr durch Leerzeichen getrennte Suchbegriffe. Jeder Suchbegriff stimmt überein, wenn er ein Substring in der URL oder dem Titel des Lesezeichens ist. Die Übereinstimmung ist nicht case-sensitiv. Damit ein Lesezeichen der Abfrage entspricht, müssen alle Suchbegriffe der Abfrage übereinstimmen.

Wenn query ein object ist, besteht es aus null oder mehr der 3 Eigenschaften: query, title und url, die unten beschrieben sind. Damit ein Lesezeichen der Abfrage entspricht, müssen alle Begriffe der Eigenschaften übereinstimmen.

query Optional

Ein string, das ein oder mehrere Begriffe angibt, die abgeglichen werden sollen; das Format ist identisch mit der String-Form des query-Parameters. Wenn dies kein String ist, wird eine Ausnahme ausgelöst.

url Optional

Ein string, das genau mit der URL des Lesezeichens übereinstimmen muss. Die Übereinstimmung ist nicht case-sensitiv, und abschließende Schrägstriche werden ignoriert.

Wenn Sie eine ungültige URL übergeben, wird die Funktion eine Ausnahme auslösen.

title Optional

Ein string, das genau mit dem Titel des Lesezeichen-Baumknotens übereinstimmen muss. Die Übereinstimmung ist case-sensitiv.

Ein Promise, das mit einem Array von bookmarks.BookmarkTreeNode-Objekten erfüllt wird, wobei jedes Objekt einen einzelnen übereinstimmenden Lesezeichen-Baumknoten darstellt. Die Ergebnisse werden in der Reihenfolge zurückgegeben, in der die Knoten erstellt wurden. Das Array ist leer, wenn keine Ergebnisse gefunden wurden.

Die von bookmarks.search() zurückgegebenen BookmarkTreeNodes – selbst Knoten des Typs "folder" – fehlen die children-Eigenschaft. Um einen vollständigen BookmarkTreeNode zu erhalten, verwenden Sie bookmarks.getSubTree().

Dieses Beispiel protokolliert die IDs aller Lesezeichen:

function onFulfilled(bookmarkItems) {
  for (const item of bookmarkItems) {
    console.log(item.id);
  }
}

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

browser.bookmarks.search({}).then(onFulfilled, onRejected);

Dieses Beispiel prüft, ob der aktuell aktive Tab ein Lesezeichen ist:

function onFulfilled(bookmarkItems) {
  if (bookmarkItems.length) {
    console.log("active tab is bookmarked");
  } else {
    console.log("active tab is not bookmarked");
  }
}

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

function checkActiveTab(tab) {
  browser.bookmarks.search({ url: tab.url }).then(onFulfilled, onRejected);
}

browser.browserAction.onClicked.addListener(checkActiveTab);

• bookmark-it