chrome.extensionTypes

説明

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

型

ColorArray

Chrome 139 以降

タイプ

[数値, 数値, 数値, 数値]

CSSOrigin

Chrome 66 以降

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

列挙型

"author"

"user"

DeleteInjectionDetails

Chrome 87 以降

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

プロパティ

  • allFrames

    ブール値（省略可）

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

  • コード

    文字列 省略可

    削除する CSS コード。

  • cssOrigin

    CSSOrigin 省略可

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

  • ファイル

    文字列 省略可

    削除する CSS ファイル。

  • frameId

    number 省略可

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

  • matchAboutBlank

    ブール値（省略可）

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

DocumentLifecycle

Chrome 106 以降

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

列挙型

"prerender"

"active"

"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 省略可

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

ImageFormat

Chrome 44 以降

画像の形式。

列挙型

"jpeg"

"png"

InjectDetails

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

プロパティ

  • allFrames

    ブール値（省略可）

    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

    ブール値（省略可）

    matchAboutBlank が true の場合、拡張機能が親ドキュメントにアクセスできる場合、コードは about:blank フレームと about:srcdoc フレームにも挿入されます。最上位の about:-frame にコードを挿入することはできません。デフォルトでは 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 がすでにトリガーされているかどうかを確認できます。