翻訳

manifest.jsonのrun_atプロパティの説明の翻訳しました。

必須ではありません。jsプロパティのファイルを注入するタイミングを制御します。
設定値は次の三つです

cssプロパティのファイルの読込後、DOMが構築されscriptsが実行される前です。

DOMが構築された直後、画像やフレームなどのサブリソースが読込まれる前です。

ブラウザが決定します。document_endから、window.onloadイベントまでの間の任意のタイミングです。
実際のタイミングはdocumentの複雑さによって変わります。
また、documentの読込みに掛かる時間、documentを読込みに最適化しているかにも左右されます。

document_idleでは、content scriptsがwindow.onloadイベントを受信しない可能性があります。イベント発火後にcontent scriptsを実行しているかもしれません。

一般に、document_idleでは、window.onloadイベントを待つ必要はありません。DOM構築完了後の実行を保証しています。

もし、厳密にwindow.onloadの後にcontent scriptsを実行するには、イベントがすでに発火したかチェックします。document.readyStateプロパティを使います。

使い分け

基本的にdocument_idleで十分しょう。初期値なので、run_atプロパティは設定不要です。

巨大な画像を読み込むことなど、サブリソースの読込みに時間が掛かるとわかっている場合は、document_endを設定します。
サブリソースの読込み前に実行されます。ユーザーの待ち時間が気持ち減ります。

document_startは、どういうときに使うのでしょうか？
知っている人がいたら教えてください。