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

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 được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp để có 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. Lời hứa sẽ được phân giải bằng cùng một loại được truyền đến lệnh gọi lại.