chrome.mimeHandler

refresh date: 2026-09-25 robots: noindex

شرح

از chrome.mimeHandler API برای مدیریت جاری‌سازی‌های نوع MIME در افزونه‌های طرف سوم استفاده کنید.

دردسترس بودن

Chrome نسخه ۱۵۱ و بالاتر

انواع

MimeHandlerOptions

مشخصات

  • canEmbed

    بولی اختیاری

    Chrome نسخه ۱۵۷ و بالاتر

    اینکه آیا این کنترل‌کننده می‌تواند برای بارهای جاسازی‌شده (iframe، جاسازی، شیء) استفاده شود یا نه. به‌طور پیش‌فرض روی مقدار can_embed ورودی مانیفست تنظیم شده است. وقتی enabled نادرست باشد، تأثیری ندارد.

  • فعال شد

    بولی اختیاری

    اینکه این گرداننده فعال است یا نه. به‌طور پیش‌فرض روی مقدار enabled ورودی مانیفست تنظیم شده است.

StreamInfo

مشخصات

  • جاسازی‌شده

    بولی

    اگر در بافت جاسازی‌شده (iframe/embed/object) بار شده باشد، درست است.

  • mimeType

    رشته

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

  • originalUrl

    رشته

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

  • responseHeaders

    شیء

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

  • streamUrl

    رشته

    نشانی وبی که داده‌های جاری‌سازی از آن واکشی می‌شود.

  • tabId

    شماره

    شناسه زبانه‌ای که حاوی سند است.

روش‌ها

abortAndFallbackToNativeHandler()

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

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

پارامترها

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به‌صورت زیر است: 

    () => void

بازگشتی‌ها

  • Promise<void>

    ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.

getMimeHandlerOptions()

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

گزینه‌های نوع MIME را می‌خواند. هر عضو مقداری است که افزونه تنظیم کرده است، یا مقدار ورودی مانیفست است اگر افزونه آن را تنظیم نکرده باشد.

پارامترها

  • mimeType

    رشته

    نوع MIME که گزینه‌های آن خوانده می‌شود. باید نوع MIME باشد که افزونه ازطریق mime_types_handler مدیریت می‌کند.

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به‌صورت زیر است: 

    (options: MimeHandlerOptions) => void

بازگشتی‌ها

  • Promise resolved with the options for the MIME type.

    ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.

getStreamInfo()

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

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

پارامترها

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به‌صورت زیر است: 

    (info: StreamInfo) => void

بازگشتی‌ها

  • Promise<StreamInfo>

    ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.

setMimeHandlerOptions()

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

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

پارامترها

  • mimeType

    رشته

    نوع MIME برای پیکربندی. باید نوع MIME باشد که افزونه ازطریق mime_types_handler مدیریت می‌کند.

  • گزینه‌ها

    MimeHandlerOptions

    گزینه‌هایی که باید تغییر کند.

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به‌صورت زیر است: 

    () => void

بازگشتی‌ها

  • Promise<void>

    وقتی پیکربندی تنظیم شد، Promise حل شد.

    ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.