chrome.topSites

تاریخ به‌روزرسانی: 2026-09-25 ربات‌ها: noindex

توضیحات

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

مجوزها

topSites

مانیفست

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

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

مثال‌ها

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

انواع

MostVisitedURL

یک شیء که یک URL پربازدید را در خود جای داده است، مانند میانبرهای پیش‌فرض در صفحه تب جدید.

خواص

  • عنوان

    رشته

    عنوان صفحه

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

    رشته

    پربازدیدترین آدرس اینترنتی (URL).

روش‌ها

get()

وعده
chrome.topSites.get(
  callback?: function,
)
: Promise<MostVisitedURL[]>

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

پارامترها

بازگشت‌ها

  • کروم ۹۶+

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