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,
)

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

پارامترها

  • queryInfo

    QueryInfo

  • پاسخ به تماس

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

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

    () => void

برمی گرداند

  • قول<باطل>

    Chrome 96+

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