chrome.extensionTypes

説明

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

型

CSSOrigin

Chrome 66 以降

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

列挙型

"author"

DeleteInjectionDetails

Chrome 87 以降

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

プロパティ

  • allFrames

    ブール値（省略可）

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

  • コード

    string（省略可）

    削除する CSS コード。

  • cssOrigin

    CSSOrigin 省略可

    削除する CSS の origin。デフォルトは "author" です。

  • あなた宛てに表示されます。

    string（省略可）

    削除する CSS ファイル。

  • frameId

    number（省略可）

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

  • matchAboutBlank

    ブール値（省略可）

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

DocumentLifecycle

Chrome 106 以降

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

列挙型

"pending_deletion"

ExecutionWorld

Chrome 111 以降

スクリプトが実行される JavaScript の世界。この拡張機能に固有の隔離された世界、ページの JavaScript と共有される DOM のメインの世界、または User Scripts API に登録されているスクリプトでのみ利用可能なユーザー スクリプトの世界です。

列挙型

FrameType

Chrome 106 以降

フレームのタイプ。

列挙型

"outermost_frame"

"sub_frame"

ImageDetails

画像の形式と品質に関する詳細。

プロパティ

  • 形式

    ImageFormat 省略可

    結果の画像の形式。デフォルトは、"jpeg" です。

  • 品質

    number（省略可）

    形式が "jpeg" の場合、生成される画像の品質を制御します。PNG 画像の場合、この値は無視されます。画質が低下すると、画質が悪くなり、保存に必要なバイト数が少なくなります。

ImageFormat

Chrome 44 以降

画像の形式。

列挙型

"jpeg"

"png"

InjectDetails

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

プロパティ

  • allFrames

    ブール値（省略可）

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

  • コード

    string（省略可）

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

    警告: code パラメータは慎重に使用してください。使い方を間違えると、拡張機能がクロスサイト スクリプティング攻撃を受けるおそれがあります

  • cssOrigin

    CSSOrigin 省略可

    Chrome 66 以降

    挿入する CSS の origin。指定できるのは CSS のみで、JavaScript には指定できません。デフォルトは "author" です。

  • あなた宛てに表示されます。

    string（省略可）

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

  • frameId

    number（省略可）

    Chrome 50 以降

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

  • matchAboutBlank

    ブール値（省略可）

    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 がすでに呼び出されているかどうかを確認できます。