chrome.topSites

refresh date: 2026-09-25 robots: noindex

الوصف

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

الأذونات

topSites

البيان

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

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

أمثلة

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

الأنواع

MostVisitedURL

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

الخصائص

  • title

    سلسلة

    عنوان الصفحة

  • url

    سلسلة

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

الطُرق

get()

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

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

المعلمات

  • callback

    function اختياري

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

    (data: MostVisitedURL[]) => void

المرتجعات

  • Promise<MostVisitedURL[]>

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

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