الوصف
استخدِم chrome.topSites API للوصول إلى أهم المواقع الإلكترونية (أي المواقع الإلكترونية الأكثر زيارة) التي يتم عرضها في صفحة علامة التبويب الجديدة. لا تشمل هذه الاختصارات الاختصارات التي خصَّصها المستخدم.
الأذونات
topSitesيجب تعريف إذن "topSites" في بيان الإضافة لاستخدام واجهة برمجة التطبيقات هذه.
{
"name": "My extension",
...
"permissions": [
"topSites",
],
...
}
أمثلة
لتجربة واجهة برمجة التطبيقات هذه، يُرجى تثبيت مثال واجهة برمجة التطبيقاتtopSites من مستودع chrome-extension-pattern.
الأنواع
MostVisitedURL
عنصر يغلب على عنوان URL الأكثر زيارة، مثل الاختصارات التلقائية في صفحة علامة تبويب جديدة.
أماكن إقامة
-
title
سلسلة
عنوان الصفحة
-
url
سلسلة
عنوان URL الأكثر زيارة
الطُرق
get()
chrome.topSites.get(
callback?: function,
)
الحصول على قائمة بأهم المواقع الإلكترونية.
المَعلمات
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callbackعلى النحو التالي:(data: MostVisitedURL[])=>void
-
البيانات
-
المرتجعات
-
Promise<MostVisitedURL[]>
Chrome 96 والإصدارات الأحدثتتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.