chrome.topSites

الوصف

استخدام واجهة برمجة تطبيقات chrome.topSites للوصول إلى أهم المواقع الإلكترونية (أي المواقع الأكثر زيارة) التي يتم عرضها في صفحة علامة التبويب الجديدة ولا تشمل هذه الاختصارات الاختصارات التي خصّصها المستخدم.

الأذونات

topSites

البيان

يجب الإفصاح عن "topSites" إذن في بيان الإضافة لاستخدام واجهة برمجة التطبيقات هذه.

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

أمثلة

لتجربة واجهة برمجة التطبيقات هذه، يمكنك تثبيت مثال على واجهة برمجة التطبيقاتtopSites من chrome-extension-samples. المستودع.

الأنواع

MostVisitedURL

كائن يغلف عنوان URL الأكثر زيارة، مثل الاختصارات التلقائية في صفحة علامة التبويب الجديدة

أماكن إقامة

  • title

    سلسلة

    عنوان الصفحة

  • url

    سلسلة

    عنوان URL الأكثر زيارة

الطُرق

get()

وعود
chrome.topSites.get(
  callback?: function,
)

الحصول على قائمة بأهم المواقع الإلكترونية

المعلمات

  • رد الاتصال

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي:

    (data: MostVisitedURL[]) => void

المرتجعات

  • Promise<MostVisitedURL[]>

    الإصدار 96 من Chrome أو الإصدارات الأحدث

    لا تتوفّر الوعود إلا مع إصدار Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.