browser.topSites

الوصف

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

الأذونات

topSites

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

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

أمثلة

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

الأنواع

MostVisitedURL

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

الخصائص

  • title

    سلسلة

    عنوان الصفحة

  • url

    سلسلة

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

الطُرق

get()

browser.topSites.get(): Promise<MostVisitedURL[]>

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

المرتجعات

  • Promise<MostVisitedURL[]>

    الإصدار 96 من Chrome والإصدارات الأحدث browser.* ‎ منذ الإصدار 148 من Chrome