chrome.mimeHandler

說明

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

可用性

待處理

類型

MimeHandlerOptions

屬性

  • 已啟用

    布林值

    這個處理常式是否適用於指定的 MIME 類型。

StreamInfo

屬性

  • 嵌入

    布林值

    如果載入嵌入式環境 (iframe/embed/object)，則為 True。

  • mimeType

    字串

    攔截內容的 MIME 類型。

  • originalUrl

    字串

    使用者前往的原始網址。

  • responseHeaders

    物件

    HTTP 回應標頭，以鍵/值組合形式表示。

  • streamUrl

    字串

    要從中擷取串流資料的網址。

  • tabId

    數字

    包含文件的分頁 ID。

方法

abortAndFallbackToNativeHandler()

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

中止目前的串流處理作業，並將內容交給使用者代理程式的原生處理常式。呼叫這個方法後，擴充功能框架就會拆除，呼叫端不應預期後續執行作業。

參數

  • callback

    函式 選填

    callback 參數如下： 

    () => void

傳回

  • Promise<void>

    只有資訊清單 V3 以上版本支援 Promise，其他平台則需使用回呼。

getMimeHandlerOptions()

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

讀取 MIME 類型的持續性選項。如果沒有儲存任何預設值，則傳回預設值 (enabled=true)。

參數

傳回

  • Promise 會以 MIME 類型的持續性選項解析。

    只有資訊清單 V3 以上版本支援 Promise，其他平台則需使用回呼。

getStreamInfo()

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

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

參數

傳回

  • Promise<StreamInfo>

    只有資訊清單 V3 以上版本支援 Promise，其他平台則需使用回呼。

setMimeHandlerOptions()

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

為指定的 MIME 類型設定設定選項。

參數

  • mimeType

    字串

    要設定的 MIME 類型。

  • 可用的新選項。

  • callback

    函式 選填

    callback 參數如下： 

    () => void

傳回

  • Promise<void>

    設定完成後，系統會解析 Promise。

    只有資訊清單 V3 以上版本支援 Promise，其他平台則需使用回呼。