chrome.mimeHandler

refresh date: 2026-09-25 robots: noindex

說明

使用 chrome.mimeHandler API 處理第三方擴充功能中的 MIME 類型串流。

可用性

Chrome 151 以上版本

類型

MimeHandlerOptions

屬性

  • canEmbed

    布林值 選填

    Chrome 157 以上版本

    這個處理常式是否可用於嵌入式載入 (iframe、嵌入、物件)。預設為資訊清單項目的 can_embed 值。如果 enabled 為 false，則不會生效。

  • 已啟用

    布林值 選填

    這個處理常式是否已啟用。預設為資訊清單項目的 enabled 值。

StreamInfo

屬性

  • embedded

    布林值

    如果是在嵌入式情境 (iframe/embed/object) 中載入，則為 True。

  • mimeType

    字串

    攔截內容的 MIME 類型。

  • originalUrl

    字串

    使用者前往的來源網址。

  • responseHeaders

    物件

    HTTP 回應標頭 (鍵/值組合)。

  • streamUrl

    字串

    要擷取串流資料的網址。

  • tabId

    數字

    含有文件的分頁 ID。

方法

abortAndFallbackToNativeHandler()

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

中止目前的串流處理，並將內容交給使用者代理程式的原生處理常式。呼叫後，擴充功能框架會遭到拆除，呼叫端不應預期進一步執行。

參數

  • callback

    函式 選填

    callback 參數如下： 

    () => void

傳回

  • 承諾<void>

    Promise 僅適用於 Manifest V3 以上版本，其他平台則須使用回呼。

getMimeHandlerOptions()

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

讀取 MIME 類型的選項。每個成員都是擴充功能設定的值，如果擴充功能未設定，則為資訊清單項目的值。

參數

  • mimeType

    字串

    要讀取選項的 MIME 類型。必須是擴充功能透過 mime_types_handler 處理的 MIME 類型。

  • callback

    函式 選填

    callback 參數如下： 

    (options: MimeHandlerOptions) => void

傳回

  • Promise 已解析，並提供 MIME 類型的選項。

    Promise 僅適用於 Manifest V3 以上版本，其他平台則須使用回呼。

getStreamInfo()

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

擷取目前 MIME 處理常式內容的串流資訊。必須從 MIME 處理常式擴充功能頁面內呼叫。

參數

傳回

  • Promise<StreamInfo>

    Promise 僅適用於 Manifest V3 以上版本，其他平台則須使用回呼。

setMimeHandlerOptions()

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

設定指定 MIME 類型的設定選項。如果擴充功能在分割無痕模式下執行，從無痕模式設定的選項只會套用至無痕模式，並在無痕模式工作階段結束後失效。未在無痕模式中設定的選項，會沿用無痕模式外的設定值。

參數

  • mimeType

    字串

    要設定的 MIME 類型。必須是擴充功能透過 mime_types_handler 處理的 MIME 類型。

  • 要變更的選項。

  • callback

    函式 選填

    callback 參數如下： 

    () => void

傳回

  • 承諾<void>

    設定完成後，Promise 就會解析。

    Promise 僅適用於 Manifest V3 以上版本，其他平台則須使用回呼。