topSites

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

Браузеры хранят эту информацию, чтобы помочь пользователю легко возвращаться к этим местам. Например, по умолчанию Firefox предоставляет список наиболее посещаемых страниц на странице "Новая вкладка".

Для использования API topSites необходимо разрешение "topSites" API permission.

Типы

topSites.MostVisitedURL: Объект, содержащий заголовок и URL сайта.

Методы

topSites.get(): Получает массив, содержащий все сайты, перечисленные на странице "Новая вкладка" в браузере. Обратите внимание, что количество возвращаемых сайтов зависит от браузера, а конкретные возвращаемые сайты, вероятно, будут специфичны для пользователя на основе его истории посещений.

Совместимость с браузерами

	Рабочий стол						Мобильные устройства
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox for Android	Opera Android	Safari на IOS	Samsung Internet
`MostVisitedURL`	Да	79	52	?	Да	Нет	?	?	52–79	?	Нет	?
`get`	Да	79	52 С Firefox 78 пользователь может отключить функцию "Основные сайты" браузера, переключившись на настройку "browser.newtabpage.activity-stream.feeds.system.topsites". В этом случае `topSites.get()` всегда будет возвращать список наиболее посещаемых сайтов независимо от значения параметра `newtab`.	?	Да	Нет	?	?	52–79	?	Нет	?

Примеры расширений

top-sites

Примечание: Этот API основан на API chrome.topSites Chromium.

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/topSites