allFrames
がの場合true
、「ドキュメント」は最上位のドキュメントのみを参照します。
それ以外の場合は、一致した各フレーム (トップレベル、iframe など) のドキュメントを参照します。
詳細についてrun_at
は、コンテンツ スクリプトのドキュメントを参照してください。
run_at string
オプション。のファイルがいつjs
挿入されるかを制御します。「document_start」、「document_end」、または「document_idle」を指定できます。デフォルトは「document_idle」です。
「document_start」の場合、ファイルは からのファイルの後、css
他の DOM が構築される前、または他のスクリプトが実行される前に挿入されます。
「document_end」の場合、ファイルは DOM が完了した直後に挿入されますが、画像やフレームなどのサブリソースが読み込まれる前に挿入されます。
window.onload
「document_idle」の場合、ブラウザは、「document_end」とイベント発生直後の間でスクリプトを挿入する時間を選択します。挿入の正確なタイミングは、ドキュメントの複雑さと読み込みにかかる時間によって異なり、ページの読み込み速度に合わせて最適化されます。
注: "document_idle" を使用すると、コンテンツ スクリプトは必ずしもwindow.onload
イベントを受け取るとは限りません。onload
ほとんどの場合、コンテンツ スクリプトは DOM の完了後に実行されることが保証されているため、"document_idle" で実行されているコンテンツ スクリプトではイベントをリッスンする必要はありません。スクリプトを の後に実行する必要がwindow.onload
ある場合は、プロパティを使用して onload が既に起動しているかどうかを確認できdocument.readyState
ます。
PS。プロパティ名はキャメルケースchrome.tabs.executeScript
( runAt
, allFrames
) ですが、マニフェスト ファイルではアンダースコアで綴られています ( run_at
, all_frames
)。