chrome.topSites

refresh date: 2026-09-25 robots: noindex

Описание

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

Разрешения

topSites

Манифест

Чтобы использовать этот API, необходимо объявить разрешение topSites в манифесте расширения.

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

Примеры

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

Типы

MostVisitedURL

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

Свойства

  • название

    string

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

  • url

    string

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

Методы

get()

Promise 
chrome.topSites.get(
  callback?: function,
): Promise<MostVisitedURL[]>

Получает список популярных сайтов.

Параметры

  • обратный вызов

    function необязательно

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

    (data: MostVisitedURL[]) => void

Возвраты

  • Promise<MostVisitedURL[]>

    Chrome 96 и более поздних версий;

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