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

Tệp kê khai

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 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.