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()
chrome.topSites.get(
callback?: function,
): Promise<MostVisitedURL[]>
تعرض هذه السمة قائمة بأهم المواقع الإلكترونية.
المعلمات
-
callback
الدالة اختيارية
تظهر المَعلمة
callbackعلى النحو التالي:(data: MostVisitedURL[]) => void
-
البيانات
-
المرتجعات
-
Promise<MostVisitedURL[]>
Chrome 96 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، بينما تحتاج المنصات الأخرى إلى استخدام عمليات معاودة الاتصال.