chrome.topSites

תאריך הרענון: 2026-09-25 robots: noindex

תיאור

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

הרשאות

topSites

מניפסט

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

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

דוגמאות

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

סוגים

MostVisitedURL

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

מאפיינים

  • title

    מחרוזת

    כותרת הדף

  • url

    מחרוזת

    כתובת ה-URL שבה ביקרתם הכי הרבה פעמים.

Methods

get()

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

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

פרמטרים

  • callback

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

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

    (data: MostVisitedURL[]) => void

החזרות

  • Promise<MostVisitedURL[]>

    ‫Chrome 96 ואילך

    התמיכה ב-Promises קיימת רק ב-Manifest V3 ואילך. בפלטפורמות אחרות צריך להשתמש ב-callbacks.