Document.ononline
Document.online
イベントは、ブラウザーがオンラインモードとオフラインモードの間で切り替わったときに、それぞれのページの <body>
で発生します。加えて、イベントは document.body
から document
に向けて、 window
までバブリングします。どちらのイベントもキャンセル不可能です (ユーザーがオンラインになったり、オフラインに移行したりするのを妨げることはできません)。
window.navigator.onLine
は、ブラウザーがオンラインの場合に真偽値の true
を返し、明らかにオフラインの場合 (ネットワークから切断された場合) は false
を返します。 online
および offline
イベントはこの属性の値が変化したときに発生します。
重要なことですが、このイベントおよび属性は本質的に信頼できません。コンピューターはインターネットアクセスなしでネットワークに接続することがあります。
これらのイベントのリスナーは、おなじみの幾つかの方法で登録することができます。
addEventListener
をwindow
,document
,document.body
に使用するdocument
またはdocument.body
の.ononline
または.onoffline
プロパティに、 JavaScript のFunction
オブジェクトを設定する (注:window.ononline
またはwindow.onoffline
の使用は互換性の理由から動作しません。)- HTML マークアップの中で、
ononline="..."
またはonoffline="..."
属性を<body>
タグに指定する。
例
実行するとイベントが動作することを確認することができる単純なテストケースがあります。