chrome.search

الوصف

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

الأذونات

search

مدى التوفّر

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

الأنواع

Disposition

Enum

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

استبدِل "NEW_TAB"
بالقيمة التي تحدّد ما إذا كان سيتم عرض نتائج البحث في علامة تبويب جديدة.

‫"NEW_WINDOW"
تحدّد هذه السمة أنّ نتائج البحث ستظهر في نافذة جديدة.

QueryInfo

الخصائص

  • disposition

    حالة الطلب اختيارية

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

  • tabId

    number اختياري

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

  • نص

    سلسلة

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

الطُرق

query()

الوعد 
chrome.search.query(
  queryInfo: QueryInfo,
  callback?: function,
): Promise<void>

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

المعلمات

  • queryInfo

    QueryInfo

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

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