chrome.search

คำอธิบาย

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

สิทธิ์

search

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

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

ประเภท

Disposition

ค่าแจกแจง

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

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

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

QueryInfo

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

  • การควบคุม

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

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

  • tabId

    ตัวเลข ไม่บังคับ

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

  • ข้อความ

    string

    สตริงที่จะค้นหากับผู้ให้บริการค้นหาเริ่มต้น

วิธีการ

query()

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

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

พารามิเตอร์

  • queryInfo

    QueryInfo

  • Callback

    ฟังก์ชัน ไม่บังคับ

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

    ()=>void

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

  • Promise<void>

    Chrome 96 ขึ้นไป

    Manifest V3 ขึ้นไปรองรับคำสัญญา แต่จะใช้โค้ดเรียกกลับเพื่อความเข้ากันได้แบบย้อนหลัง คุณไม่สามารถใช้ทั้ง 2 ฟีเจอร์ในการเรียกใช้ฟังก์ชันเดียวกันได้ คำสัญญาจะยุติด้วยประเภทเดียวกันกับที่ส่งไปยังโค้ดเรียกกลับ