chrome.topSites

תיאור

אפשר להשתמש ב-chrome.topSites API כדי לגשת לאתרים המובילים (כלומר, האתרים שבהם מבקרים הכי הרבה) שמוצגים בדף הכרטיסייה החדשה. הם לא כוללים קיצורי דרך שהמשתמש התאים אישית.

הרשאות

topSites

מניפסט

כדי להשתמש ב-API הזה, צריך להצהיר על ההרשאה topSites במניפסט של התוסף.

{
  "name": "My extension",
  ...
  "permissions": [
    "topSites",
  ],
  ...
}

דוגמאות

כדי לנסות את ה-API הזה, מתקינים את הדוגמה ל-topSites API ממאגר chrome-extension-samples.

סוגים

MostVisitedURL

אובייקט שמכיל כתובת URL של אתר שבו ביקרתם הכי הרבה פעמים, כמו קיצורי הדרך שמופיעים כברירת מחדל בדף הכרטיסייה החדשה.

מאפיינים

  • title

    מחרוזת

    כותרת הדף

  • כתובת אתר

    מחרוזת

    כתובת ה-URL שקיבלה הכי הרבה ביקורים.

Methods

get()

Promise 
chrome.topSites.get(
  callback?: function,
): Promise<MostVisitedURL[]>

קבלת רשימה של אתרים מובילים.

פרמטרים

  • callback

    פונקציה אופציונלית

    הפרמטר callback נראה כך: 

    (data: MostVisitedURL[]) => void

החזרות

  • Promise<MostVisitedURL[]>

    ‫Chrome 96 ואילך

    ההבטחות נתמכות רק ב-Manifest V3 ובגרסאות מאוחרות יותר. בפלטפורמות אחרות צריך להשתמש בפונקציות Callback.