chrome.topSites

คำอธิบาย

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

สิทธิ์

topSites

ไฟล์ Manifest

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

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

ตัวอย่าง

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

ประเภท

MostVisitedURL

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

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

  • title

    สตริง

    ชื่อหน้า

  • URL

    สตริง

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

เมธอด

get()

Promise
chrome.topSites.get(
  callback?: function,
)
: Promise<MostVisitedURL[]>

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

พารามิเตอร์

  • callback

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

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

    (data: MostVisitedURL[]) => void

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

  • Promise<MostVisitedURL[]>

    Chrome 96 ขึ้นไป

    ระบบรองรับ Promise สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ