chrome.mimeHandler

توضیحات

از API chrome.mimeHandler برای مدیریت جریان‌های نوع MIME در افزونه‌های شخص ثالث استفاده کنید.

در دسترس بودن

در حال بررسی

انواع

MimeHandlerOptions

خواص

  • فعال شده

    بولی

    آیا این کنترل‌کننده برای نوع MIME داده شده فعال است یا خیر.

StreamInfo

خواص

  • جاسازی شده

    بولی

    اگر در یک زمینه تعبیه‌شده (iframe/embed/object) بارگذاری شود، صحیح است.

  • نوع مایم

    رشته

    نوع MIME محتوای رهگیری‌شده.

  • آدرس اصلی

    رشته

    آدرس اینترنتی اصلی که کاربر به آن هدایت شده است.

  • هدرهای پاسخ

    شیء

    هدرهای پاسخ HTTP به عنوان جفت‌های کلید-مقدار.

  • آدرس اینترنتی

    رشته

    آدرس اینترنتی (URL) برای دریافت داده‌های جریان داده.

  • شناسه برگه

    شماره

    شناسه‌ی برگه‌ای که سند در آن قرار دارد.

روش‌ها

abortAndFallbackToNativeHandler()

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

مدیریت جریان فعلی را لغو می‌کند و محتوا را به کنترل‌کننده‌ی بومی عامل کاربر تحویل می‌دهد. پس از این فراخوانی، قاب افزونه از بین می‌رود؛ فراخوانی‌کنندگان نباید انتظار اجرای بیشتر را داشته باشند.

پارامترها

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به شکل زیر است: 

    () => void

بازگشت‌ها

  • قول<void>

    Promiseها فقط برای Manifest V3 و نسخه‌های بعدی پشتیبانی می‌شوند، سایر پلتفرم‌ها باید از callbackها استفاده کنند.

getMimeHandlerOptions()

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

گزینه‌های ذخیره شده برای یک نوع MIME را می‌خواند. اگر هیچ کدام ذخیره نشده باشند، مقادیر پیش‌فرض (enabled=true) را برمی‌گرداند.

پارامترها

  • نوع مایم

    رشته

    نوع MIME که گزینه‌های آن خوانده می‌شود.

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به شکل زیر است: 

    (options: MimeHandlerOptions) => void

بازگشت‌ها

  • قول با گزینه‌های ثابت برای نوع MIME حل شد.

    Promiseها فقط برای Manifest V3 و نسخه‌های بعدی پشتیبانی می‌شوند، سایر پلتفرم‌ها باید از callbackها استفاده کنند.

getStreamInfo()

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

اطلاعات جریان را برای زمینه کنترل‌کننده MIME فعلی بازیابی می‌کند. باید از داخل یک صفحه افزونه کنترل‌کننده MIME فراخوانی شود.

پارامترها

بازگشت‌ها

  • Promiseها فقط برای Manifest V3 و نسخه‌های بعدی پشتیبانی می‌شوند، سایر پلتفرم‌ها باید از callbackها استفاده کنند.

setMimeHandlerOptions()

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

گزینه‌های پیکربندی را برای یک نوع MIME مشخص شده تنظیم می‌کند.

پارامترها

  • نوع مایم

    رشته

    نوع MIME برای پیکربندی.

  • گزینه‌های جدیدی که باید استفاده شوند.

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به شکل زیر است: 

    () => void

بازگشت‌ها

  • قول<void>

    قول داده شده پس از تنظیم پیکربندی، حل شود.

    Promiseها فقط برای Manifest V3 و نسخه‌های بعدی پشتیبانی می‌شوند، سایر پلتفرم‌ها باید از callbackها استفاده کنند.