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
  • معاودة الاتصال

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

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

    ()=>void

المرتجعات

  • Promise<void>

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

    تتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.