JavaScript

A feature that checks if the user is currently online.

navigator.onLine

navigator.onLineプロパティは、ユーザーがオンラインかオフラインかを示す真偽値を取得します。これにより、アプリケーションはネットワーク接続の状態に応じて動作を変更できます。

この値は true または false を返します。

true
オンライン状態(インターネットに接続されている)
false
オフライン状態(インターネットに接続されていない)

このプロパティを使えば、「オフライン時に警告を表示する」「オンラインになったら自動で同期する」などの機能を実装できます。

ただし、注意点として navigator.onLine はネットワーク機器(Wi-FiやLAN)の接続状況を見ており、実際にインターネットにアクセスできるかまでは正確にわからないこともあります。たとえば、Wi-Fiにはつながっているがインターネットが遮断されている場合でも true を返すことがあります。

オンライン状態の変化を検知するには、以下のようにイベントリスナーを使います:

JavaScript

window.addEventListener('online', () => {
    console.log('オンラインになりました');
});

window.addEventListener('offline', () => {
    console.log('オフラインになりました');
});

これらを組み合わせることで、リアルタイムな接続状況の対応が可能になります。