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 ارسال می شود حل می شود.

،

شرح

از 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 ارسال می شود حل می شود.