chrome.search

شرح

از chrome.search API برای جستجو از طریق ارائه دهنده پیش فرض استفاده کنید.

مجوزها

search

دسترسی

Chrome 87+

انواع

Disposition

Enum

"CURRENT_TAB"
مشخص می کند که نتایج جستجو در برگه تماس یا برگه مرورگر فعال نمایش داده شود.

"NEW_TAB"
مشخص می کند که نتایج جستجو در یک برگه جدید نمایش داده شود.

"پنجره جدید"
مشخص می کند که نتایج جستجو در یک پنجره جدید نمایش داده شود.

QueryInfo

خواص

  • وضع

    تنظیم اختیاری

    مکانی که نتایج جستجو باید در آن نمایش داده شود. CURRENT_TAB پیش فرض است.

  • tabId

    شماره اختیاری

    مکانی که نتایج جستجو باید در آن نمایش داده شود. tabId نمی توان با disposition استفاده کرد.

  • متن

    رشته

    رشته ای برای پرس و جو با ارائه دهنده جستجوی پیش فرض.

مواد و روش ها

query()

وعده
chrome.search.query(
  queryInfo: QueryInfo,
  callback?: function,
)

برای پرس و جو از ارائه دهنده جستجوی پیش فرض استفاده می شود. در صورت بروز خطا، runtime.lastError تنظیم می شود.

مولفه های

  • queryInfo
  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد:

    ()=>void

برمی گرداند

  • قول<باطل>

    Chrome 96+

    Promises فقط برای Manifest V3 و نسخه‌های جدیدتر پشتیبانی می‌شود، پلتفرم‌های دیگر باید از callback استفاده کنند.