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