chrome.search

refresh date: 2026-09-25 robots: noindex

شرح

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

اجازه‌ها

search

دردسترس بودن

Chrome نسخه ۸۷ به بالا

انواع

Disposition

شمارشی

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

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

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

QueryInfo

مشخصات

• disposition

  Disposition اختیاری

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

• tabId

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

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

• نوشتار

  رشته

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

روش‌ها

query()

قول

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

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

پارامترها

• queryInfo

  QueryInfo

• تماس برگشتی

  تابع اختیاری

  پارامتر callback به‌صورت زیر است:

  () => void

بازگشتی‌ها

• Promise<void>

  Chrome نسخه ۹۶ به بالا

  ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.