الوصف
استخدام واجهة برمجة تطبيقات 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 والإصدارات الأحدث، ولكن يتم توفير معاودة الاتصال. التوافق مع الأنظمة القديمة. لا يمكنك استخدام كلتيهما في نفس استدعاء الدالة. تشير رسالة الأشكال البيانية يتم حل الوعد بنفس النوع الذي يتم إرساله إلى معاودة الاتصال.