chrome.search

الوصف

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

الأذونات

search

مدى توفّر الخدمة

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

الأنواع

Disposition

التعداد

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

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

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

QueryInfo

أماكن إقامة

• التصرف

  الترتيب اختياري

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

• tabId

  الرقم اختياري

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

• text

  سلسلة

  سلسلة لطلب البحث باستخدام مزود البحث التلقائي.

الطُرق

query()

وعد

chrome.search.query(
  queryInfo: QueryInfo,
  callback?: function,
)

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

المَعلمات

• queryInfo

  QueryInfo

• معاودة الاتصال

  الدالة اختيارية

  تبدو معلَمة callback على النحو التالي:

  ()=>void

المرتجعات

• Promise<void>

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

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