refresh date: 2026-09-25 robots: noindex
תיאור
משתמשים ב-API של chrome.topSites כדי לגשת לאתרים המובילים (כלומר, האתרים שבהם מבקרים הכי הרבה) שמוצגים בדף הכרטיסייה החדשה. הם לא כוללים קיצורי דרך שהמשתמש התאים אישית.
הרשאות
topSitesמניפסט
כדי להשתמש ב-API הזה, צריך להצהיר על ההרשאה "topSites" במניפסט של התוסף.
{
"name": "My extension",
...
"permissions": [
"topSites",
],
...
}
דוגמאות
כדי לנסות את ה-API הזה, מתקינים את הדוגמה של topSites API ממאגר chrome-extension-samples.
סוגים
MostVisitedURL
אובייקט שמכיל כתובת URL של אתר שהמשתמש מבקר בו בתדירות גבוהה, כמו קיצורי הדרך שמופיעים כברירת מחדל בדף הכרטיסייה החדשה.
מאפיינים
-
title
מחרוזת
כותרת הדף
-
url
מחרוזת
כתובת ה-URL שביקרו בה הכי הרבה.
Methods
get()
chrome.topSites.get(
callback?: function,
): Promise<MostVisitedURL[]>
מקבל רשימה של האתרים המובילים.
פרמטרים
-
callback
function optional
הפרמטר
callbackנראה כך:(data: MostVisitedURL[]) => void
-
נתונים
-
החזרות
-
Promise<MostVisitedURL[]>
Chrome מגרסה 96 ואילךהבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).