chrome.extensionTypes

説明

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

型

ColorArray

保留中

タイプ

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

CSSOrigin

Chrome 66 以降

挿入された CSS の送信元。

列挙型

"author"

"user"

DeleteInjectionDetails

Chrome 87 以降

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

プロパティ

  • 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」

「キャッシュに保存済み」

"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

保留中

画像のピクセルデータ。ImageData オブジェクトである必要があります（canvas 要素など）。

タイプ

ImageData

ImageDetails

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

プロパティ

  • 形式

    ImageFormat 省略可

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

  • 品質

    number（省略可）

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

ImageFormat

Chrome 44 以降

画像の形式。

列挙型

「jpeg」

「png」

InjectDetails

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

プロパティ

  • allFrames

    ブール値（省略可）

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

  • コード

    文字列 省略可

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

    警告: code パラメータの使用には注意してください。正しく使用しないと、拡張機能がクロスサイト スクリプティング攻撃の対象になる可能性があります

  • cssOrigin

    CSSOrigin 省略可

    Chrome 66 以降

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

  • ファイル

    文字列 省略可

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

  • frameId

    number（省略可）

    Chrome 50 以降

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

  • matchAboutBlank

    ブール値（省略可）

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