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 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.