תיאור
השתמשו ב-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) בשביל תאימות לאחור. לא ניתן להשתמש בשתיהן באותה בקשה להפעלת פונקציה. ההבטחה הזו מצליחה לפתור את הבעיה באותו סוג שמועבר לקריאה החוזרת.