chrome.topSites

Nội dung mô tả

Dùng API chrome.topSites để truy cập vào các trang web hàng đầu (tức là các trang web được truy cập nhiều nhất) được hiển thị trên trang thẻ mới. Các phím tắt này không bao gồm lối tắt do người dùng tuỳ chỉnh.

Quyền

topSites

Tệp kê khai

Bạn phải khai báo quyền "topSites" trong tệp kê khai của tiện ích để sử dụng API này.

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

Ví dụ

Để dùng thử API này, hãy cài đặt ví dụ về API topSites trong kho lưu trữ chrome-extension-samples.

Loại

MostVisitedURL

Một đối tượng đóng gói URL được truy cập nhiều nhất, chẳng hạn như các lối tắt mặc định trên trang thẻ mới.

Thuộc tính

  • title

    string

    Tiêu đề của trang

  • url

    string

    URL được truy cập nhiều nhất.

Phương thức

get()

Cam kết 
chrome.topSites.get(
  callback?: function,
)

Lấy danh sách các trang web hàng đầu.

Tham số

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    (data: MostVisitedURL[])=>void

Giá trị trả về

  • Promise<MostVisitedURL[]>

    Chrome 96 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.