chrome.mimeHandler

更新日: 2026-09-25 robots: noindex

説明

chrome.mimeHandler API を使用して、サードパーティの拡張機能で MIME タイプ ストリームを処理します。

対象

Chrome 151 以降

型

MimeHandlerOptions

プロパティ

  • canEmbed

    boolean 省略可

    Chrome 157 以降

    このハンドラを埋め込み読み込み（iframe、embed、object）に使用できるかどうか。デフォルトは、マニフェスト エントリの can_embed 値です。enabled が false の場合は無効です。

  • 有効

    boolean 省略可

    このハンドラが有効かどうか。デフォルトは、マニフェスト エントリの enabled 値です。

StreamInfo

プロパティ

  • 組み込み型

    ブール値

    埋め込みコンテキスト（iframe / 埋め込み / オブジェクト）で読み込まれた場合は true。

  • mimeType

    文字列

    インターセプトされたコンテンツの MIME タイプ。

  • originalUrl

    文字列

    ユーザーが移動した元の URL。

  • responseHeaders

    オブジェクト

    Key-Value ペアとしての HTTP レスポンス ヘッダー。

  • streamUrl

    文字列

    ストリーム データを取得する URL。

  • tabId

    数値

    ドキュメントを含むタブの ID。

メソッド

abortAndFallbackToNativeHandler()

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

現在のストリーム処理を中止し、コンテンツをユーザー エージェントのネイティブ ハンドラに渡します。この呼び出しの後、拡張機能フレームは破棄されます。呼び出し元は、それ以上の実行を期待すべきではありません。

パラメータ

  • callback

    function 省略可

    callback パラメータは次のようになります。 

    () => void

戻り値

  • Promise<void>

    Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

getMimeHandlerOptions()

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

MIME タイプのオプションを読み取ります。各メンバーは、拡張機能が設定した値です。拡張機能が設定していない場合は、マニフェスト エントリの値です。

パラメータ

  • mimeType

    文字列

    オプションを読み取る MIME タイプ。拡張機能が mime_types_handler を介して処理する MIME タイプである必要があります。

  • callback

    function 省略可

    callback パラメータは次のようになります。 

    (options: MimeHandlerOptions) => void

戻り値

  • MIME タイプのオプションで解決された Promise。

    Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

getStreamInfo()

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

現在の MIME ハンドラ コンテキストのストリーム情報を取得します。MIME ハンドラ拡張機能ページ内から呼び出す必要があります。

パラメータ

  • callback

    function 省略可

    callback パラメータは次のようになります。 

    (info: StreamInfo) => void

戻り値

  • 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 タイプである必要があります。

  • オプション

    MimeHandlerOptions

    変更するオプション。

  • callback

    function 省略可

    callback パラメータは次のようになります。 

    () => void

戻り値

  • Promise<void>

    構成が設定されると、Promise が解決されます。

    Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。