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