chrome.mimeHandler

refresh date: 2026-09-25 robots: noindex

الوصف

استخدِم واجهة برمجة التطبيقات chrome.mimeHandler للتعامل مع عمليات بث أنواع MIME في الإضافات التابعة لجهات خارجية.

مدى التوفّر

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

الأنواع

MimeHandlerOptions

الخصائص

  • مفعّلة

    قيمة منطقية

    تحديد ما إذا كان هذا المعالج نشطًا لنوع MIME المحدّد

StreamInfo

الخصائص

  • مضمَّن

    قيمة منطقية

    تعرض القيمة "صحيح" إذا تم تحميلها في سياق مضمَّن (iframe/embed/object).

  • mimeType

    سلسلة

    نوع MIME للمحتوى الذي تم اعتراضه

  • originalUrl

    سلسلة

    عنوان URL الأصلي الذي انتقل إليه المستخدِم.

  • responseHeaders

    عنصر

    عناوين استجابة HTTP كأزواج مفتاح/قيمة

  • streamUrl

    سلسلة

    عنوان URL الذي سيتم جلب بيانات البث منه.

  • tabId

    الرقم

    معرّف علامة التبويب التي تحتوي على المستند

الطُرق

abortAndFallbackToNativeHandler()

وعد 
chrome.mimeHandler.abortAndFallbackToNativeHandler(
  callback?: function,
): Promise<void>

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

المعلمات

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

getMimeHandlerOptions()

وعد 
chrome.mimeHandler.getMimeHandlerOptions(
  mimeType: string,
  callback?: function,
): Promise<MimeHandlerOptions>

تقرأ هذه السمة الخيارات الثابتة لنوع MIME. تعرض هذه السمة القيم التلقائية (enabled=true) إذا لم يتم تخزين أي قيم.

المعلمات

  • mimeType

    سلسلة

    نوع MIME الذي سيتم قراءة خياراته.

  • callback

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

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

    (options: MimeHandlerOptions) => void

المرتجعات

  • تم حلّ الوعد باستخدام الخيارات الثابتة لنوع MIME.

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

getStreamInfo()

وعد 
chrome.mimeHandler.getStreamInfo(
  callback?: function,
): Promise<StreamInfo>

تسترد هذه السمة معلومات البث لسياق معالج MIME الحالي. يجب أن يتم استدعاؤها من داخل صفحة إضافة معالجة MIME.

المعلمات

  • callback

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

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

    (info: StreamInfo) => void

المرتجعات

  • Promise<StreamInfo>

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

setMimeHandlerOptions()

وعد 
chrome.mimeHandler.setMimeHandlerOptions(
  mimeType: string,
  options: MimeHandlerOptions,
  callback?: function,
): Promise<void>

تضبط هذه السمة خيارات الإعدادات لنوع MIME محدّد.

المعلمات

  • mimeType

    سلسلة

    نوع MIME المطلوب ضبطه.

  • الخيارات

    MimeHandlerOptions

    الخيارات الجديدة التي يمكنك استخدامها

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

    يتم حلّ الوعد عند ضبط الإعداد.

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