chrome.topSites

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) xuất hiện trên trang thẻ mới. Các phím tắt này không bao gồm các lối tắt do người dùng tuỳ chỉnh.

Quyền

topSites

Bạn phải khai báo các thuộc tính "topSites" quyền 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 chrome-extension-samples kho lưu trữ.

Loại

MostVisitedURL

Đối tượng bao gồm một 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

  • tiêu đề

    string

    Tiêu đề của trang

  • url

    string

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

Phương thức

get()

Lời hứa 
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 được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp cho khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Chiến lược phát hành đĩa đơn Promise phân giải cùng loại được truyền đến lệnh gọi lại.