chrome.search

refresh date: 2026-09-25 robots: noindex

الوصف

استخدِم واجهة برمجة التطبيقات chrome.search للبحث من خلال مقدّم الخدمة التلقائي.

الأذونات

search

مدى التوفّر

الإصدار 87 من Chrome أو الإصدارات الأحدث

الأنواع

Disposition

Enum

"CURRENT_TAB"
تحدّد هذه القيمة أنّه سيتم عرض نتائج البحث في علامة التبويب التي تم إجراء البحث فيها أو علامة التبويب من المتصفّح النشط.

"NEW_TAB"
تحدّد عرض نتائج البحث في علامة تبويب جديدة.

"NEW_WINDOW"
يحدّد هذا الخيار عرض نتائج البحث في نافذة جديدة.

QueryInfo

الخصائص

• disposition

  Disposition اختيارية

  الموقع الجغرافي الذي يجب عرض نتائج البحث فيه ‫CURRENT_TAB هو الخيار التلقائي.

• tabId

  number اختيارية

  الموقع الجغرافي الذي يجب عرض نتائج البحث فيه لا يمكن استخدام "tabId" مع "disposition".

• نصي

  سلسلة

  سلسلة للبحث باستخدام مقدِّم محرّك البحث التلقائي

الطُرق

query()

Promise

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

يُستخدَم للاستعلام عن مقدِّم محرّك البحث التلقائي. في حال حدوث خطأ، سيتم ضبط runtime.lastError.

المعلمات

• queryInfo

  QueryInfo

• callback

  function اختياري

  تظهر المَعلمة callback على النحو التالي:

  () => void

المرتجعات

• وعد<فراغ>

  الإصدار 96 من Chrome أو الإصدارات الأحدث

  لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، وتحتاج المنصات الأخرى إلى استخدام عمليات الاستدعاء.