chrome.readingList

Description

Utilisez l'API chrome.readingList pour lire et modifier les éléments de la liste de lecture.

Autorisations

readingList

Pour utiliser l'API Reading List, ajoutez l'autorisation "readingList" dans le fichier manifeste de l'extension :

manifest.json:

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

Disponibilité

Chrome 120+ MV3+

Chrome propose une liste de lecture située dans le panneau latéral. Elle permet aux utilisateurs d'enregistrer des pages Web pour les lire plus tard ou hors connexion. Utilisez l'API Liste de lecture pour récupérer des éléments existants, et en ajouter ou en supprimer.

Liste de lecture affichant un certain nombre d'articles
Liste de lecture affichant un certain nombre d'articles

Concepts et utilisation

Ordre des articles

L'ordre des éléments de la liste de lecture n'est pas garanti.

Unicité des articles

Les éléments sont identifiés par leur URL. Cela inclut le hachage et la chaîne de requête.

Cas d'utilisation

Les sections suivantes présentent quelques cas d'utilisation courants de l'API Liste de lecture. Pour obtenir des exemples complets d'extensions, consultez Exemples d'extensions.

Ajouter un élément

Pour ajouter un élément à la liste de lecture, utilisez chrome.readingList.addEntry() :

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

Éléments display

Pour afficher les éléments de la liste de lecture, utilisez la méthode chrome.readingList.query() pour les récupérer.

const items = await chrome.readingList.query({});  for (const item of items) {   // Do something do display the item }

Marquer un élément comme lu

Vous pouvez utiliser chrome.readingList.updateEntry() pour modifier le titre, l'URL et l'état de lecture. Le code suivant marque un élément comme lu :

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

Supprimer un élément

Pour supprimer un élément, utilisez chrome.readingList.removeEntry() :

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

Exemples d'extensions

Pour obtenir d'autres démonstrations d'extensions de l'API Reading List, consultez l'exemple de l'API Reading List.

Types

AddEntryOptions

Propriétés

  • hasBeenRead

    booléen

    La valeur sera true si l'entrée a été lue.

  • titre

    chaîne

    Titre de l'entrée.

  • url

    chaîne

    URL de l'entrée.

QueryInfo

Propriétés

  • hasBeenRead

    booléen facultatif

    Indique s'il faut rechercher les éléments lus (true) ou non lus (false).

  • titre

    chaîne facultative

    Titre à rechercher.

  • url

    chaîne facultative

    URL à rechercher.

ReadingListEntry

Propriétés

  • creationTime

    Total

    Heure de création de l'entrée. Enregistré en millisecondes depuis le 1er janvier 1970.

  • hasBeenRead

    booléen

    La valeur sera true si l'entrée a été lue.

  • lastUpdateTime

    Total

    Date de la dernière mise à jour de l'entrée. Cette valeur est exprimée en millisecondes depuis le 1er janvier 1970.

  • titre

    chaîne

    Titre de l'entrée.

  • url

    chaîne

    URL de l'entrée.

RemoveOptions

Propriétés

  • url

    chaîne

    URL à supprimer.

UpdateEntryOptions

Propriétés

  • hasBeenRead

    booléen facultatif

    État de lecture mis à jour. Si aucune valeur n'est fournie, l'état existant est conservé.

  • titre

    chaîne facultative

    Nouveau titre. Si aucune valeur n'est fournie, la vignette existante est conservée.

  • url

    chaîne

    URL à mettre à jour.

Méthodes

addEntry()

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

Ajoute une entrée à la liste de lecture si elle n'existe pas.

Paramètres

Renvoie

  • Promise<void>

query()

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

Récupère toutes les entrées correspondant aux propriétés QueryInfo. Les propriétés non fournies ne seront pas mises en correspondance.

Paramètres

  • infos

    QueryInfo

    Propriétés à rechercher.

Renvoie

removeEntry()

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

Supprime une entrée de la liste de lecture, le cas échéant.

Paramètres

  • Entrée à supprimer de la liste de lecture.

Renvoie

  • Promise<void>

updateEntry()

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

Met à jour une entrée de liste de lecture si elle existe.

Paramètres

Renvoie

  • Promise<void>

Événements

onEntryAdded

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

Déclenchement lorsqu'un ReadingListEntry est ajouté à la liste de lecture.

Paramètres

onEntryRemoved

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

Déclenché lorsqu'un ReadingListEntry est supprimé de la liste de lecture.

Paramètres

onEntryUpdated

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

Déclenché lorsqu'un ReadingListEntry est mis à jour dans la liste de lecture.

Paramètres