chrome.extensionTypes

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

説明

chrome.extensionTypes API には、Chrome 拡張機能の型宣言が含まれています。

型

ColorArray

Chrome 139 以降

タイプ

[number, number, number, number]

CSSOrigin

Chrome 66 以降

挿入された CSS のオリジン。

列挙型

"author"

"user"

DeleteInjectionDetails

Chrome 87 以降

削除する CSS の詳細。code プロパティまたは file プロパティのいずれかを設定する必要がありますが、両方を同時に設定することはできません。

プロパティ

  • allFrames

    boolean 省略可

    allFrames がtrueの場合、現在のページのすべてのフレームから CSS を削除する必要があることを意味します。デフォルトでは false で、トップフレームからのみ削除されます。true と frameId が設定されている場合、選択したフレームとそのすべての子フレームからコードが削除されます。

  • コード

    文字列 省略可

    削除する CSS コード。

  • cssOrigin

    CSSOrigin 省略可

    削除する CSS のオリジン。デフォルトは "author" です。

  • ファイル

    文字列 省略可

    削除する CSS ファイル。

  • frameId

    number 省略可

    CSS を削除するフレーム。デフォルトは 0(最上位フレーム)です。

  • matchAboutBlank

    boolean 省略可

    matchAboutBlank が true の場合、拡張機能が親ドキュメントにアクセスできる場合は、about:blank フレームと about:srcdoc フレームからもコードが削除されます。デフォルトは false です。

DocumentLifecycle

Chrome 106 以降

フレームのドキュメント ライフサイクル。

列挙型

"prerender"

「有効」

"cached"

"pending_deletion"

ExecutionWorld

Chrome 111 以降

スクリプトを実行する JavaScript ワールド。この拡張機能に固有の分離されたワールド、ページの JavaScript と共有される DOM のメインワールド、または User Scripts API に登録されたスクリプトでのみ使用できるユーザースクリプト ワールドのいずれかです。

列挙型

"ISOLATED"

"MAIN"

"USER_SCRIPT"

FrameType

Chrome 106 以降

フレームのタイプ。

列挙型

"outermost_frame"

"fenced_frame"

"sub_frame"

ImageDataType

Chrome 139 以降

画像のピクセルデータ。ImageData オブジェクト(canvas 要素など)を指定する必要があります。

タイプ

ImageData

ImageDetails

画像の形式、品質、領域に関する詳細。

プロパティ

  • 形式

    ImageFormat 省略可

    生成される画像の形式。デフォルトは、"jpeg" です。

  • 品質

    number 省略可

    format が "jpeg" の場合、生成される画像の品質を制御します。この値は PNG 画像では無視されます。品質が低下すると、結果の画像に視覚的なアーティファクトが増え、保存に必要なバイト数が減少します。

ImageFormat

Chrome 44 以降

画像の形式。

列挙型

"jpeg"

"png"

InjectDetails

挿入するスクリプトまたは CSS の詳細。code プロパティまたは file プロパティのいずれかを設定する必要がありますが、両方を同時に設定することはできません。

プロパティ

  • allFrames

    boolean 省略可

    allFrames がtrueの場合、JavaScript または CSS を現在のページのすべてのフレームに挿入する必要があることを意味します。デフォルトでは false で、最上位フレームにのみ挿入されます。true と frameId が設定されている場合、コードは選択したフレームとそのすべての子フレームに挿入されます。

  • コード

    文字列 省略可

    挿入する JavaScript または CSS コード。

    警告: code パラメータは慎重に使用してください。不適切に使用すると、拡張機能がクロスサイト スクリプティング攻撃にさらされる可能性があります。

  • cssOrigin

    CSSOrigin 省略可

    Chrome 66 以降

    挿入する CSS のオリジン。これは CSS にのみ指定できます。JavaScript には指定できません。デフォルトは "author" です。

  • ファイル

    文字列 省略可

    挿入する JavaScript または CSS ファイル。

  • frameId

    number 省略可

    Chrome 50 以降

    スクリプトまたは CSS を挿入するフレーム。デフォルトは 0(最上位フレーム)です。

  • matchAboutBlank

    boolean 省略可

    matchAboutBlank が true の場合、拡張機能が親ドキュメントにアクセスできると、コードは about:blank フレームと about:srcdoc フレームにも挿入されます。コードを最上位の about:-frames に挿入することはできません。デフォルトは false です。

  • runAt

    RunAt 省略可

    JavaScript または CSS がタブに挿入される最も早いタイミング。デフォルトは "document_idle" です。

RunAt

Chrome 44 以降

JavaScript または CSS がタブに挿入される最も早いタイミング。

列挙型

"document_start"
スクリプトは、CSS のファイルの後に挿入されますが、他の DOM が構築される前、または他のスクリプトが実行される前に挿入されます。

"document_end"
スクリプトは、DOM の完了直後、画像やフレームなどのサブリソースが読み込まれる前に挿入されます。

"document_idle"
ブラウザは、"document_end" と window.onload イベントの発生直後の間にスクリプトを挿入するタイミングを選択します。挿入の正確なタイミングは、ドキュメントの複雑さと読み込みにかかる時間によって異なり、ページの読み込み速度に合わせて最適化されます。「document_idle」で実行されるコンテンツ スクリプトは、window.onload イベントをリッスンする必要はありません。DOM の完了後に実行されることが保証されています。スクリプトを window.onload の後に実行する必要がある場合、拡張機能は document.readyState プロパティを使用して onload がすでに呼び出されているかどうかを確認できます。