chrome.search

คำอธิบาย

ใช้ chrome.search API เพื่อค้นหาผ่านผู้ให้บริการเริ่มต้น

สิทธิ์

search

ความพร้อมใช้งาน

Chrome เวอร์ชัน 87 ขึ้นไป

ประเภท

Disposition

ค่าแจกแจง

"CURRENT_TAB"
ระบุว่าผลการค้นหาจะแสดงในแท็บการโทรหรือแท็บจากเบราว์เซอร์ที่ใช้งานอยู่

"NEW_TAB"
ระบุว่าผลการค้นหาแสดงในแท็บใหม่

"NEW_WINDOW"
ระบุว่าผลการค้นหาจะแสดงในหน้าต่างใหม่

QueryInfo

พร็อพเพอร์ตี้

  • การควบคุม

    การกำจัด ไม่บังคับ

    ตำแหน่งที่ควรแสดงผลการค้นหา CURRENT_TAB คือค่าเริ่มต้น

  • tabId

    หมายเลข ไม่บังคับ

    ตำแหน่งที่ควรแสดงผลการค้นหา ใช้ tabId กับ disposition ไม่ได้

  • ข้อความ

    สตริง

    สตริงที่ต้องการค้นหาด้วยผู้ให้บริการค้นหาเริ่มต้น

เมธอด

query()

สัญญา 
chrome.search.query(
  queryInfo: QueryInfo,
  callback?: function,
)

ใช้เพื่อค้นหาผู้ให้บริการค้นหาเริ่มต้น ในกรณีที่เกิดข้อผิดพลาด ระบบจะตั้งค่า runtime.lastError

พารามิเตอร์

  • queryInfo

    QueryInfo

  • Callback

    ไม่บังคับ

    พารามิเตอร์ callback มีลักษณะดังนี้ 

    () => void

การคืนสินค้า

  • คำมั่นสัญญา<โมฆะ>

    Chrome 96 ขึ้นไป

    Promise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback