chrome.mimeHandler

説明

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

対象

Chrome 151 以降

型

MimeHandlerOptions

プロパティ

  • 有効

    ブール値

    このハンドラが指定された MIME タイプに対してアクティブかどうか。

StreamInfo

プロパティ

  • 組み込み型

    ブール値

    埋め込みコンテキスト（iframe/embed/object）で読み込まれた場合は 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 タイプの永続化されたオプションを読み取ります。保存されていない場合はデフォルト値（enabled=true）を返します。

パラメータ

  • mimeType

    文字列

    オプションを読み取る 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 タイプ。

  • オプション

    MimeHandlerOptions

    使用する新しいオプション。

  • callback

    function 省略可

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

    () => void

戻り値

  • Promise<void>

    構成が設定されたときに解決される Promise。

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