chrome.mimeHandler

الوصف

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

مدى التوفّر

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

الأنواع

MimeHandlerOptions

الخصائص

  • مفعّلة

    قيمة منطقية

    ما إذا كان هذا المعالج مفعّلاً لنوع MIME المحدّد

StreamInfo

الخصائص

  • مضمّنة

    قيمة منطقية

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

  • mimeType

    سلسلة

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

  • originalUrl

    سلسلة

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

  • responseHeaders

    عنصر

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

  • streamUrl

    سلسلة

    عنوان URL الذي يتم منه جلب بيانات مصدر البيانات

  • tabId

    الرقم

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

الطُرق

abortAndFallbackToNativeHandler()

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

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

المعلمات

  • callback

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

    تبدو المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • Promise<void>

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

getMimeHandlerOptions()

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

يقرأ هذا الإجراء الخيارات المحفوظة لنوع MIME. ويعرض الإعدادات التلقائية (enabled=true) إذا لم يتم تخزين أي خيارات.

المعلمات

  • mimeType

    سلسلة

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

  • callback

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

    تبدو المَعلمة callback على النحو التالي: 

    (options: MimeHandlerOptions) => void

المرتجعات

  • وعد يتم تنفيذه باستخدام الخيارات المحفوظة لنوع MIME

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

getStreamInfo()

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

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

المعلمات

  • callback

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

    تبدو المَعلمة callback على النحو التالي: 

    (info: StreamInfo) => void

المرتجعات

  • Promise<StreamInfo>

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

setMimeHandlerOptions()

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

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

المعلمات

  • mimeType

    سلسلة

    نوع MIME الذي سيتم إعداده

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

  • callback

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

    تبدو المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • Promise<void>

    وعد يتم تنفيذه عند ضبط الإعداد

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