תיאור
השתמשו ב-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).