الوصف
استخدِم 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 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.