chrome.topSites

תיאור

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

הרשאות

topSites

עליך להצהיר על "אתרים מובילים" במניפסט של התוסף להשתמש ב-API הזה.

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

דוגמאות

כדי לנסות את ה-API הזה, צריך להתקין את הדוגמה של TopSites API מchrome-extension-samples של מאגר הנתונים.

סוגים

MostVisitedURL

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

מאפיינים

  • title

    מחרוזת

    כותרת הדף

  • כתובת אתר

    מחרוזת

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

שיטות

get()

הבטחה
chrome.topSites.get(
  callback?: function,
)

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

פרמטרים

  • קריאה חוזרת (callback)

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

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

    (data: MostVisitedURL[]) => void

החזרות

  • Promise<MostVisitedURL[]>

    Chrome מגרסה 96 ואילך

    הבטחות נתמכות במניפסט מגרסה V3 ואילך, אבל ניתנות קריאות חוזרות (callback) בשביל תאימות לאחור. לא ניתן להשתמש בשתיהן באותה בקשה להפעלת פונקציה. ההבטחה הזו מצליחה לפתור את הבעיה באותו סוג שמועבר לקריאה החוזרת.