chrome.topSites

Описание

Используйте API chrome.topSites для доступа к самым популярным сайтам (т. е. наиболее посещаемым), отображаемым на странице новой вкладки. В их число не входят ярлыки, настроенные пользователем.

Разрешения

topSites

Манифест

Для использования этого API необходимо объявить разрешение «topSites» в манифесте вашего расширения .

{
  "name": "My extension",
  ...
  "permissions": [
    "topSites",
  ],
  ...
}

Примеры

Чтобы опробовать этот API, установите пример API topSites из репозитория chrome-extension-samples .

Типы

MostVisitedURL

Объект, инкапсулирующий наиболее посещаемый URL-адрес, например ярлыки по умолчанию на странице новой вкладки.

Характеристики

  • заголовок

    нить

    Название страницы

  • URL-адрес

    нить

    Самый посещаемый URL.

Методы

get()

Обещать
chrome.topSites.get(
  callback?: function,
): Promise<MostVisitedURL[]>

Получает список лучших сайтов.

Параметры

  • перезвонить

    функция необязательна

    Параметр callback выглядит так: 

    (data: MostVisitedURL[]) => void

Возврат

  • Обещание< MostVisitedURL []>

    Хром 96+

    Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.