refresh date: 2026-09-25 robots: noindex
الوصف
استخدِم واجهة برمجة التطبيقات chrome.search للبحث من خلال مقدّم الخدمة التلقائي.
الأذونات
searchمدى التوفّر
الأنواع
Disposition
تعداد
"CURRENT_TAB"
تحدّد هذه السمة أنّ نتائج البحث ستظهر في علامة التبويب التي تم استدعاء الدالة منها أو علامة التبويب من المتصفّح النشط.
استبدِل "NEW_TAB"
بالقيمة التي تحدّد عرض نتائج البحث في علامة تبويب جديدة.
"NEW_WINDOW"
تحدّد هذه السمة أنّ نتائج البحث ستظهر في نافذة جديدة.
QueryInfo
الخصائص
-
التصرف
التصرف اختياري
الموقع الجغرافي الذي يجب عرض نتائج البحث فيه
CURRENT_TABهي القيمة التلقائية. -
tabId
number اختياري
الموقع الجغرافي الذي يجب عرض نتائج البحث فيه لا يمكن استخدام
tabIdمعdisposition. -
نصي
سلسلة
سلسلة للبحث باستخدام مقدّم خدمة البحث التلقائي
الطُرق
query()
chrome.search.query(
queryInfo: QueryInfo,
callback?: function,
): Promise<void>
تُستخدَم للاستعلام عن مقدّم خدمة البحث التلقائي. في حال حدوث خطأ، سيتم ضبط runtime.lastError.
المعلمات
-
queryInfo
-
callback
الدالة اختيارية
تظهر المَعلمة
callbackعلى النحو التالي:() => void
المرتجعات
-
Promise<void>
Chrome 96 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، بينما تحتاج المنصات الأخرى إلى استخدام عمليات معاودة الاتصال.