chrome.topSites

дата обновления: 2026-09-25 robots: noindex

Описание

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

Разрешения

topSites

Манифест

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

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

Примеры

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

Типы

MostVisitedURL

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

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

  • заголовок

    нить

    Заголовок страницы

  • url

    нить

    Наиболее посещаемый URL-адрес.

Методы

get()

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

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

Параметры

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

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

    Параметр callback выглядит следующим образом: 

    (data: MostVisitedURL[]) => void

Возвраты

  • Promise< MostVisitedURL []>

    Chrome 96+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.