chrome.topSites

คำอธิบาย

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

สิทธิ์

topSites

ไฟล์ Manifest

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

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

ตัวอย่าง

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

ประเภท

MostVisitedURL

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

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

  • title

    สตริง

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

  • URL

    สตริง

    URL ที่เข้าชมบ่อยที่สุด

เมธอด

get()

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

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

พารามิเตอร์

  • Callback

    ไม่บังคับ

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

    (data: MostVisitedURL[]) => void

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

  • Promise<MostVisitedURL[]>

    Chrome 96 ขึ้นไป

    Promise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback