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 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوعی که به callback ارسال می شود حل می شود.