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