chrome.topSites

توضیحات

از chrome.topSites API برای دسترسی به سایت های برتر (یعنی سایت های پربازدید) که در صفحه برگه جدید نمایش داده می شوند، استفاده کنید. این شامل میانبرهای سفارشی شده توسط کاربر نمی شود.

مجوزها

topSites

آشکار

برای استفاده از این API باید مجوز "topSites" را در مانیفست برنامه افزودنی خود اعلام کنید.

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

نمونه ها

برای امتحان این API، نمونه topSites API را از مخزن chrome-extension-samples نصب کنید.

انواع

MostVisitedURL

شیئی که یک URL پربازدید را محصور می کند، مانند میانبرهای پیش فرض در صفحه برگه جدید.

خواص

  • عنوان

    رشته

    عنوان صفحه

  • آدرس اینترنتی

    رشته

    پربازدیدترین URL.

روش ها

get()

قول بده
chrome.topSites.get(
  callback?: function,
)

لیستی از سایت های برتر را دریافت می کند.

پارامترها

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد:

    (data: MostVisitedURL[]) => void

برمی گرداند

  • Promise< MostVisitedURL []>

    Chrome 96+

    Promises فقط برای Manifest V3 و نسخه‌های جدیدتر پشتیبانی می‌شود، پلتفرم‌های دیگر باید از callback استفاده کنند.