chrome.search

تاریخ به‌روزرسانی: 2026-09-25 ربات‌ها: noindex

توضیحات

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

مجوزها

search

در دسترس بودن

کروم ۸۷+

انواع

Disposition

شمارشی

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

«تب_جدید»
مشخص می‌کند که نتایج جستجو در یک تب جدید نمایش داده شوند.

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

QueryInfo

خواص

  • وضع

    اختیار اختیاری

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

  • شناسه برگه

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

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

  • متن

    رشته

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

روش‌ها

query()

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

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

پارامترها

  • اطلاعات پرس و جو
  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به شکل زیر است:

    () => void

بازگشت‌ها

  • قول<void>

    کروم ۹۶+

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