chrome.readingList

Deskripsi

Gunakan chrome.readingList API untuk membaca dan mengubah item dalam Daftar Bacaan.

Izin

readingList

Untuk menggunakan Reading List API, tambahkan izin "readingList" di file manifest ekstensi:

manifest.json:

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

Ketersediaan

Chrome 120+ MV3+

Chrome memiliki daftar bacaan yang terletak di panel samping. Fitur ini memungkinkan pengguna menyimpan halaman web untuk dibaca nanti atau saat offline. Gunakan Reading List API untuk mengambil item yang ada dan menambahkan atau menghapus item dari daftar.

Daftar bacaan yang menampilkan sejumlah artikel
Daftar bacaan yang menampilkan sejumlah artikel

Konsep dan penggunaan

Pemesanan item

Item dalam daftar bacaan tidak dijamin urutannya.

Keunikan item

Item diberi kunci menurut URL. Ini mencakup hash dan string kueri.

Kasus penggunaan

Bagian berikut menunjukkan beberapa kasus penggunaan umum untuk Reading List API. Lihat Contoh ekstensi untuk contoh ekstensi lengkap.

Tambahkan item

Untuk menambahkan item ke daftar bacaan, gunakan chrome.readingList.addEntry():

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

Menampilkan item

Untuk menampilkan item dari daftar bacaan, gunakan metode chrome.readingList.query() untuk mengambilnya. method.

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

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

Menandai item sebagai sudah dibaca

Anda dapat menggunakan chrome.readingList.updateEntry() untuk memperbarui judul, URL, dan status baca. Kode berikut menandai item sebagai sudah dibaca:

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

Menghapus item

Untuk menghapus item, gunakan chrome.readingList.removeEntry():

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

Contoh ekstensi

Untuk melihat demo ekstensi Reading List API lainnya, lihat contoh Reading List API.

Jenis

AddEntryOptions

Properti

  • hasBeenRead

    boolean

    Akan menjadi true jika entri telah dibaca.

  • judul

    string

    Judul entri.

  • url

    string

    URL entri.

QueryInfo

Properti

  • hasBeenRead

    boolean opsional

    Menunjukkan apakah akan menelusuri item yang sudah dibaca (true) atau belum dibaca (false).

  • judul

    string opsional

    Judul yang akan ditelusuri.

  • url

    string opsional

    URL yang akan ditelusuri.

ReadingListEntry

Properti

  • creationTime

    angka

    Waktu entri dibuat. Direkam dalam milidetik sejak 1 Januari 1970.

  • hasBeenRead

    boolean

    Akan menjadi true jika entri telah dibaca.

  • lastUpdateTime

    angka

    Terakhir kali entri diperbarui. Nilai ini dalam milidetik sejak 1 Januari 1970.

  • judul

    string

    Judul entri.

  • url

    string

    URL entri.

RemoveOptions

Properti

  • url

    string

    URL yang akan dihapus.

UpdateEntryOptions

Properti

  • hasBeenRead

    boolean opsional

    Status baca yang diperbarui. Status yang ada akan tetap ada jika nilai tidak diberikan.

  • judul

    string opsional

    Judul baru. Petak yang ada akan tetap ada jika nilai tidak diberikan.

  • url

    string

    URL yang akan diperbarui.

Metode

addEntry()

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

Menambahkan entri ke daftar bacaan jika belum ada.

Parameter

Hasil

  • Promise<void>

query()

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

Mengambil semua entri yang cocok dengan properti QueryInfo. Properti yang tidak diberikan tidak akan dicocokkan.

Parameter

  • info

    QueryInfo

    Properti yang akan ditelusuri.

Hasil

removeEntry()

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

Menghapus entri dari daftar bacaan jika ada.

Parameter

Hasil

  • Promise<void>

updateEntry()

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

Memperbarui entri daftar bacaan jika ada.

Parameter

Hasil

  • Promise<void>

Acara

onEntryAdded

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

Dipicu saat ReadingListEntry ditambahkan ke daftar bacaan.

Parameter

onEntryRemoved

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

Dipicu saat ReadingListEntry dihapus dari daftar bacaan.

Parameter

onEntryUpdated

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

Dipicu saat ReadingListEntry diperbarui dalam daftar bacaan.

Parameter