chrome.topSites

คำอธิบาย

ใช้ chrome.topSites API เพื่อเข้าถึงเว็บไซต์ยอดนิยม (เช่น เว็บไซต์ที่เข้าชมบ่อยที่สุด) ซึ่งแสดงในหน้าแท็บใหม่ ซึ่งไม่รวมทางลัดที่ผู้ใช้กำหนด

สิทธิ์

topSites

คุณต้องประกาศสิทธิ์ "topSites" ในไฟล์ Manifest ของส่วนขยายเพื่อใช้ API นี้

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

ตัวอย่าง

หากต้องการลองใช้ API นี้ ให้ติดตั้งตัวอย่าง TopSites API จากที่เก็บ chrome-extension-samples

ประเภท

MostVisitedURL

ออบเจ็กต์ที่สรุป URL ที่เข้าชมบ่อยที่สุด เช่น ทางลัดเริ่มต้นในหน้าแท็บใหม่

พร็อพเพอร์ตี้

  • title

    string

    ชื่อของหน้าเว็บ

  • url

    string

    URL ที่มีการเข้าชมมากที่สุด

วิธีการ

get()

สัญญา
chrome.topSites.get(
  callback?: function,
)

รับรายการเว็บไซต์ยอดนิยม

พารามิเตอร์

  • Callback

    ฟังก์ชัน ไม่บังคับ

    พารามิเตอร์ callback มีลักษณะดังนี้

    (data: MostVisitedURL[])=>void

การคืนสินค้า

  • Promise<MostVisitedURL[]>

    Chrome 96 ขึ้นไป

    Manifest V3 ขึ้นไปรองรับคำสัญญา แต่จะใช้โค้ดเรียกกลับเพื่อความเข้ากันได้แบบย้อนหลัง คุณไม่สามารถใช้ทั้ง 2 ฟีเจอร์ในการเรียกใช้ฟังก์ชันเดียวกันได้ คำสัญญาจะยุติด้วยประเภทเดียวกันกับที่ส่งไปยังโค้ดเรียกกลับ