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

  • נתונים

    MostVisitedURL[]

החזרות

• Promise<MostVisitedURL[]>

  Chrome 96 ומעלה

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