chrome.search

الوصف

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

الأذونات

search

مدى التوفّر

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

الأنواع

Disposition

Enum

"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

المرتجعات

  • وعود <باطلة>

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

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