bookmarks.search()

query

Ein string oder object, der die auszuführende Abfrage beschreibt.

Wenn query ein string ist, besteht er aus null oder mehr durch Leerzeichen getrennten Suchbegriffen. Jeder Suchbegriff stimmt überein, wenn es sich um eine Teilzeichenkette in der URL oder dem Titel des Lesezeichens handelt. Die Übereinstimmung erfolgt ohne Berücksichtigung der Groß-/Kleinschreibung. Damit ein Lesezeichen mit der Abfrage übereinstimmt, müssen alle Suchbegriffe der Abfrage erfüllt sein.

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 mit der Abfrage übereinstimmt, müssen alle Begriffe der Eigenschaften erfüllt sein.

query Optional

Ein string, der einen oder mehrere Begriffe zum Abgleich angibt; 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, der genau mit der URL des Lesezeichens übereinstimmen muss. Die Übereinstimmung erfolgt ohne Berücksichtigung der Groß-/Kleinschreibung, 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, der genau mit dem Titel des Lesezeichenelements übereinstimmen muss. Die Übereinstimmung erfolgt mit Berücksichtigung der Groß-/Kleinschreibung.

Ein Promise, das mit einem Array von bookmarks.BookmarkTreeNode Objekten erfüllt wird, die jeweils ein einzelnes übereinstimmendes Lesezeichenelement darstellen. Die Ergebnisse werden in der Reihenfolge zurückgegeben, in der die Knoten erstellt wurden. Das Array ist leer, wenn keine Ergebnisse gefunden wurden.

Die BookmarkTreeNodes — selbst Knoten vom Typ "folder" — die von bookmarks.search() zurückgegeben werden, fehlen die children-Eigenschaft. Um ein vollständiges 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 überprü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