chrome.readingList

Beschreibung

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

Berechtigungen

readingList

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

manifest.json:

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

Verfügbarkeit

Chrome 120+ MV3+

In Chrome gibt es eine Leseliste in der Seitenleiste. Damit können Nutzer 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 einer Reihe von Artikeln
Leseliste mit einer Reihe von Artikeln

Konzepte und Verwendung

Artikelreihenfolge

Die Elemente in der Leseliste werden nicht in einer bestimmten Reihenfolge angezeigt.

Eindeutigkeit von Artikeln

Elemente werden nach URL verschlüsselt. 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

Verwenden Sie chrome.readingList.addEntry(), um der Leseliste ein Element hinzuzufügen:

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

Elemente anzeigen

Verwenden Sie zum Anzeigen von Elementen aus der Leseliste die Methode chrome.readingList.query(), um sie abzurufen.

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

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

Element als gelesen markieren

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

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

Elemente entfernen

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

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

Beispiele für Erweiterungen

Weitere Demos für Reading List API-Erweiterungen finden Sie im Reading List API-Beispiel.

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

    boolean 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. Wird in Millisekunden seit dem 1. Januar 1970 aufgezeichnet.

  • 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

    boolean 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()

chrome.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>

query()

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

Ruft alle Einträge ab, die mit den QueryInfo-Attributen übereinstimmen. Properties, die nicht angegeben werden, werden nicht abgeglichen.

Parameter

  • Info

    QueryInfo

    Die Eigenschaften, nach denen gesucht werden soll.

Ausgabe

removeEntry()

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

Entfernt einen Eintrag aus der Leseliste, falls er vorhanden ist.

Parameter

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

Ausgabe

  • Promise<void>

updateEntry()

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

Aktualisiert einen Eintrag in der Leseliste, sofern er vorhanden ist.

Parameter

Ausgabe

  • Promise<void>

Ereignisse

onEntryAdded

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

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

Parameter

onEntryRemoved

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

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

Parameter

onEntryUpdated

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

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

Parameter