refresh date: 2026-09-25 robots: noindex
شرح
از chrome.topSites API برای دسترسی به سایت‌های برتر (یعنی سایت‌های پربازدید) که در صفحه برگه جدید نمایش داده می‌شوند استفاده کنید. این میان‌برها شامل میان‌برهای سفارشی‌شده توسط کاربر نمی‌شود.
اجازه‌ها
topSitesمانیفست
برای استفاده از این میانای برنامه‌سازی کاربردی، باید اجازه «topSites» را در مانیفست افزونه اعلام کنید.
{
"name": "My extension",
...
"permissions": [
"topSites",
],
...
}
مثال‌ها
برای امتحان کردن این میانای برنامه‌سازی کاربردی، نمونه میانای برنامه‌سازی کاربردی topSites را از مخزن chrome-extension-samples نصب کنید.
انواع
MostVisitedURL
شیئی که پربازدیدترین نشانی وب را کپسوله‌سازی می‌کند، مثل میان‌برهای پیش‌فرض در صفحه برگه جدید.
مشخصات
-
عنوان
رشته
عنوان صفحه
-
نشانی وب
رشته
پربازدیدترین نشانی وب.
روش‌ها
get()
chrome.topSites.get(
callback?: function,
): Promise<MostVisitedURL[]>
فهرستی از سایت‌های برتر را دریافت می‌کند.
پارامترها
-
تماس برگشتی
تابع اختیاری
پارامتر
callbackبه‌صورت زیر است:(data: MostVisitedURL[]) => void
-
داده
-
بازگشتی‌ها
-
Promise<MostVisitedURL[]>
Chrome نسخه ۹۶ به بالاPromises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.