chrome.search

refresh date: 2026-09-25 robots: noindex

Mô tả

Sử dụng API chrome.search để tìm kiếm thông qua nhà cung cấp mặc định.

Quyền

search

Phạm vi cung cấp

Chrome 87 trở lên

Loại

Disposition

Enum

"CURRENT_TAB"
Chỉ định rằng kết quả tìm kiếm sẽ hiển thị trong thẻ gọi hoặc thẻ của trình duyệt đang hoạt động.

"NEW_TAB"
Chỉ định rằng kết quả tìm kiếm sẽ hiển thị trong một thẻ mới.

"NEW_WINDOW"
Chỉ định rằng kết quả tìm kiếm sẽ hiển thị trong một cửa sổ mới.

QueryInfo

Thuộc tính

• sắp xếp

  Disposition không bắt buộc

  Vị trí nơi kết quả tìm kiếm sẽ xuất hiện. CURRENT_TAB là giá trị mặc định.

• tabId

  number không bắt buộc

  Vị trí nơi kết quả tìm kiếm sẽ xuất hiện. Không thể sử dụng tabId với disposition.

• văn bản

  chuỗi

  Chuỗi để truy vấn bằng nhà cung cấp dịch vụ tìm kiếm mặc định.

Phương thức

query()

Promise

chrome.search.query(
  queryInfo: QueryInfo,
  callback?: function,
): Promise<void>

Dùng để truy vấn nhà cung cấp dịch vụ tìm kiếm mặc định. Trong trường hợp xảy ra lỗi, runtime.lastError sẽ được đặt.

Thông số

• queryInfo

  QueryInfo

• callback

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

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

  () => void

Giá trị trả về

• Promise<void>

  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.