chrome.search

توضیحات

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

مجوزها

search

در دسترس بودن

Chrome 87+

انواع

Disposition

Enum

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

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

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

QueryInfo

خواص

  • منش

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

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

  • tabId

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

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

  • متن

    رشته

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

روش ها

query()

قول بده
chrome.search.query(
  queryInfo: QueryInfo,
  callback?: function,
): Promise<void>

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

پارامترها

  • queryInfo

    QueryInfo

  • پاسخ به تماس

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

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

    () => void

برمی گرداند

  • قول<باطل>

    Chrome 96+

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