chrome.readingList

Описание

Разрешения

Чтобы использовать API списка чтения, добавьте разрешение "readingList" в файл манифеста расширения:

manifest.json:

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

Доступность

В Chrome есть список для чтения, расположенный на боковой панели. Он позволяет пользователям сохранять веб-страницы для чтения в будущем или в автономном режиме. Используйте API списка для чтения, чтобы извлекать существующие элементы, а также добавлять или удалять их из списка.

Концепции и использование

заказ товара

Пункты в списке для чтения не имеют гарантированного порядка.

Уникальность предмета

Элементы классифицируются по URL-адресу. Это включает хеш и строку запроса.

Варианты использования

В следующих разделах показаны некоторые распространённые варианты использования API списка чтения. Полные примеры расширений см. в разделе «Примеры расширений».

Добавить элемент

Чтобы добавить элемент в список чтения, используйте chrome.readingList.addEntry() :

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

Выставлять предметы

Чтобы отобразить элементы из списка чтения, используйте метод chrome.readingList.query() для их извлечения.

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

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

Отметить запись как прочитанную

Вы можете использовать chrome.readingList.updateEntry() для обновления заголовка, URL-адреса и статуса прочтения. Следующий код отмечает запись как прочитанную:

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

Удалить элемент

Чтобы удалить элемент, используйте chrome.readingList.removeEntry() :

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

Образцы расширения

Дополнительные демонстрации расширений API списков чтения см. в примере API списков чтения .

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

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

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

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

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

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

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