chrome.mimeHandler

refresh date: 2026-09-25 robots: noindex

الوصف

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

مدى التوفّر

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

الأنواع

MimeHandlerOptions

الخصائص

  • canEmbed

    قيمة منطقية اختيارية

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

    ما إذا كان يمكن استخدام هذا المعالج لعمليات التحميل المضمّنة (iframe أو embed أو object). يتم ضبط القيمة تلقائيًا على قيمة can_embed في إدخال البيان. ولن يكون لها أي تأثير عندما تكون قيمة enabled "خطأ".

  • مفعّلة

    قيمة منطقية اختيارية

    ما إذا كان هذا المعالج مفعَّلاً أم لا يتم ضبط القيمة تلقائيًا على قيمة enabled لإدخال البيان.

StreamInfo

الخصائص

  • مضمّنة

    قيمة منطقية

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

  • mimeType

    سلسلة

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

  • originalUrl

    سلسلة

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

  • responseHeaders

    عنصر

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

  • streamUrl

    سلسلة

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

  • tabId

    الرقم

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

الطُرق

abortAndFallbackToNativeHandler()

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

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

المعلمات

  • callback

    function اختياري

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

    () => void

المرتجعات

  • وعد<فراغ>

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

getMimeHandlerOptions()

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

يتيح هذا الإذن قراءة خيارات نوع MIME. كل عضو هو القيمة التي حددتها الإضافة، أو قيمة إدخال البيان إذا لم تحددها الإضافة.

المعلمات

  • mimeType

    سلسلة

    نوع MIME الذي تريد قراءة خياراته ويجب أن يكون نوع MIME الذي تعالجه الإضافة من خلال mime_types_handler.

  • callback

    function اختياري

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

    (options: MimeHandlerOptions) => void

المرتجعات

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

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

getStreamInfo()

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

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

المعلمات

  • callback

    function اختياري

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

    (info: StreamInfo) => void

المرتجعات

  • Promise<StreamInfo>

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

setMimeHandlerOptions()

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

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

المعلمات

  • mimeType

    سلسلة

    نوع MIME المطلوب ضبطه ويجب أن يكون نوع MIME الذي تعالجه الإضافة من خلال mime_types_handler.

  • الخيارات

    MimeHandlerOptions

    الخيارات التي تريد تغييرها

  • callback

    function اختياري

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

    () => void

المرتجعات

  • وعد<فراغ>

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

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