browser.readingList

Beschreibung

Mit der chrome.readingList API können Sie Elemente in der Leseliste lesen und ändern.

Berechtigungen

readingList

Wenn Sie die Reading List API verwenden möchten, fügen Sie die Berechtigung "readingList" in der Manifestdatei der Erweiterung hinzu:

manifest.json:

{
  "name": "My reading list extension",
  ...
  "permissions": [
    "readingList"
  ]
}

Verfügbarkeit

Chrome 120+ browser.* seit Chrome 148 MV3+

Chrome bietet eine Leseliste in der Seitenleiste. Nutzer können damit Webseiten speichern, um sie später oder offline zu lesen. Mit der Reading List API können Sie vorhandene Elemente abrufen und Elemente zur Liste hinzufügen oder daraus entfernen.

Leseliste mit mehreren Artikeln
Leseliste mit mehreren Artikeln

Konzepte und Verwendung

Elementreihenfolge

Die Elemente in der Leseliste sind nicht in einer bestimmten Reihenfolge angeordnet.

Eindeutigkeit von Artikeln

Elemente werden nach URL sortiert. Dazu gehören der Hash und der Abfragestring.

Anwendungsfälle

In den folgenden Abschnitten werden einige gängige Anwendungsfälle für die Reading List API beschrieben. Vollständige Beispiele für Erweiterungen finden Sie unter Beispiele für Erweiterungen.

Hinzufügen

So fügen Sie der Leseliste einen Eintrag hinzu: browser.readingList.addEntry()

browser.readingList.addEntry({
  title: "New to the web platform in September | web.dev",
  url: "https://developer.chrome.com/",
  hasBeenRead: false
});

Elemente anzeigen

Wenn Sie Elemente aus der Leseliste anzeigen möchten, rufen Sie sie mit der Methode browser.readingList.query() ab.

const items = await browser.readingList.query({});

for (const item of items) {
  // Do something do display the item
}

Element als gelesen markieren

Mit browser.readingList.updateEntry() können Sie den Titel, die URL und den Lesestatus aktualisieren. Mit dem folgenden Code wird ein Element als gelesen markiert:

browser.readingList.updateEntry({
  url: "https://developer.chrome.com/",
  hasBeenRead: true
});

Elemente entfernen

Verwenden Sie browser.readingList.removeEntry(), um ein Element zu entfernen:

browser.readingList.removeEntry({
  url: "https://developer.chrome.com/"
});

Beispiele für Erweiterungen

Weitere Demos zu Erweiterungen der Reading List API finden Sie im Beispiel für die Reading List API.

Typen

AddEntryOptions

Attribute

  • hasBeenRead

    boolean

    Ist true, wenn der Eintrag gelesen wurde.

  • Titel

    String

    Der Titel des Eintrags.

  • URL

    String

    Die URL des Eintrags.

QueryInfo

Attribute

  • hasBeenRead

    Boolesch optional

    Gibt an, ob nach gelesenen (true) oder ungelesenen (false) Elementen gesucht werden soll.

  • Titel

    String optional

    Ein Titel, nach dem gesucht werden soll.

  • URL

    String optional

    Eine URL, nach der gesucht werden soll.

ReadingListEntry

Attribute

  • creationTime

    Zahl

    Der Zeitpunkt, zu dem der Eintrag erstellt wurde. Aufgezeichnet in Millisekunden seit dem 1. Januar 1970.

  • hasBeenRead

    boolean

    Ist true, wenn der Eintrag gelesen wurde.

  • lastUpdateTime

    Zahl

    Der Zeitpunkt, zu dem der Eintrag zuletzt aktualisiert wurde. Dieser Wert wird in Millisekunden seit dem 1. Januar 1970 angegeben.

  • Titel

    String

    Der Titel des Eintrags.

  • URL

    String

    Die URL des Eintrags.

RemoveOptions

Attribute

  • URL

    String

    Die zu entfernende URL.

UpdateEntryOptions

Attribute

  • hasBeenRead

    Boolesch optional

    Der aktualisierte Lesestatus. Wenn kein Wert angegeben wird, bleibt der vorhandene Status erhalten.

  • Titel

    String optional

    Der neue Titel. Wenn kein Wert angegeben wird, bleibt die vorhandene Kachel erhalten.

  • URL

    String

    Die URL, die aktualisiert wird.

Methoden

addEntry()

browser.readingList.addEntry(
  entry: AddEntryOptions,
): Promise<void>

Fügt der Leseliste einen Eintrag hinzu, falls er noch nicht vorhanden ist.

Parameter

  • Eintrag

    AddEntryOptions

    Der Eintrag, der der Leseliste hinzugefügt werden soll.

Ausgabe

  • Promise<void>

    Wird aufgelöst, sobald der Eintrag hinzugefügt wurde.

query()

browser.readingList.query(
  info: QueryInfo,
): Promise<ReadingListEntry[]>

Ruft alle Einträge ab, die mit den QueryInfo-Attributen übereinstimmen. Nicht angegebene Unterkünfte werden nicht abgeglichen.

Parameter

  • Info

    QueryInfo

    Die Attribute, nach denen gesucht werden soll.

Ausgabe

  • Promise<ReadingListEntry[]>

    Wird aufgelöst, sobald die Einträge abgeglichen wurden.

removeEntry()

browser.readingList.removeEntry(
  info: RemoveOptions,
): Promise<void>

Entfernt einen Eintrag aus der Leseliste, falls vorhanden.

Parameter

  • Der Eintrag, der aus der Leseliste entfernt werden soll.

Ausgabe

  • Promise<void>

    Wird aufgelöst, sobald der Eintrag entfernt wurde.

updateEntry()

browser.readingList.updateEntry(
  info: UpdateEntryOptions,
): Promise<void>

Aktualisiert einen Eintrag in der Leseliste, falls vorhanden.

Parameter

Ausgabe

  • Promise<void>

    Wird aufgelöst, sobald die übereinstimmenden Einträge aktualisiert wurden.

Ereignisse

onEntryAdded

browser.readingList.onEntryAdded.addListener(
  callback: function,
)

Wird ausgelöst, wenn der Leseliste ein ReadingListEntry hinzugefügt wird.

Parameter

onEntryRemoved

browser.readingList.onEntryRemoved.addListener(
  callback: function,
)

Wird ausgelöst, wenn ein ReadingListEntry aus der Leseliste entfernt wird.

Parameter

onEntryUpdated

browser.readingList.onEntryUpdated.addListener(
  callback: function,
)

Wird ausgelöst, wenn ein ReadingListEntry in der Leseliste aktualisiert wird.

Parameter