Reactで、回線が遅いときだけ軽い画像を出す方法

​​React​Network Information API,Playwright,TypeScript,useSyncExternalStore,カスタムフック

スマホのモバイル回線が遅いときや、ユーザーがデータセーバー(通信量を減らす設定)をオンにしているときだけ、画像を小さいものに差し替えれば、表示までの時間と通信量を減らせます。ブラウザの Network Information API を使うと、回線の速さの推定値とデータセーバーの設定を JavaScript から読めます。React では、navigator.connection を useSyncExternalStore で読むフックにすると、回線の状態が変わったときにコンポーネントが描き直されます。

ここでは、そのフックと、回線に合わせて画像を選ぶ AdaptiveImage を作り、回線を遅くしたときに読み込まれる画像が変わることを確かめました。

補足

検証環境は Ubuntu 24.04、Node.js 22.23.4 です。使ったのは React 19.3.1、TypeScript 7.0.2、esbuild 0.28.2 です。tsc で型チェックしてから esbuild の開発用ビルドで変換し、<StrictMode> で包んで動かしました。ブラウザは Playwright 1.63.0 から動かした Chromium 153(headless)です。回線の速さは、Chrome DevTools Protocol の Network.emulateNetworkConditions で制限しました。データセーバーは、ブラウザの設定ではなく Emulation.setDataSaverOverride で上書きしました。ページを開いた後に切り替えたときに画像が変わるかどうかは確かめていません。実際のモバイル回線、スマホの実機、Firefox と Safari、サーバーでの描画(SSR)は試していません。

navigator.connection で分かること

navigator.connection が返す NetworkInformation のうち、画像を選ぶのに使えるのは次の4つです。

  • effectiveType:回線の速さを slow-2g、2g、3g、4g のどれかで表した値
  • downlink:下りの速さの推定値(Mbps)
  • rtt:往復の遅延の推定値(ミリ秒、25ms 単位)
  • saveData:ユーザーがブラウザで通信量を減らす設定をしていれば true

effectiveType は、接続の種類(Wi-Fi や固定回線など)ではなく、最近の通信で測った遅延と速さから決まります。MDN の Effective connection type の説明にある表では、3g は遅延が 270ms 以上・下りが 700Kbps 以下、2g は 1400ms 以上・70Kbps 以下とされています。同じ表で、2g は小さい画像を送るのに向いた回線、3g は高解像度の画像も送れる回線と説明されています。どこで区切るかは画像の重さしだいですが、この記事では通信量を減らすほうに寄せて、4g 以外を「遅い回線」として扱いました。

値が変わると、navigator.connection に change イベントが届きます。検証環境で回線の制限を何段階か切り替えたところ、effectiveType が 2g、3g、4g と変わるたびにイベントが届きました。effectiveType が 4g のまま downlink だけが変わったときも届いています。

注意

MDN の互換性データでは、effectiveType と saveData は Chrome と Edge では使えますが、Firefox と Safari(iOS 版を含む)では使えません。値が取れない前提で作っておく必要があります。

回線の状態を読むフックを作る

navigator.connection は React の外にある値なので、useSyncExternalStore で読みます。change イベントに登録する関数(subscribe)と、今の値を返す関数(getSnapshot)を渡します。

ts
// useNetworkInformation.ts
import { useSyncExternalStore } from 'react';

// TypeScript の DOM の型定義には navigator.connection がないので、
// 使う分だけ自分で書く
type EffectiveType = 'slow-2g' | '2g' | '3g' | '4g';
type Connection = EventTarget & {
  effectiveType: EffectiveType;
  downlink: number; // Mbps
  rtt: number; // ミリ秒
  saveData: boolean;
};

export type NetworkInfo = Pick<Connection, 'effectiveType' | 'downlink' | 'rtt' | 'saveData'>;

function getConnection(): Connection | undefined {
  if (typeof navigator === 'undefined') return undefined;
  return (navigator as Navigator & { connection?: Connection }).connection;
}

function subscribe(onChange: () => void) {
  const connection = getConnection();
  if (!connection) return () => {};
  connection.addEventListener('change', onChange);
  return () => connection.removeEventListener('change', onChange);
}

// 値が変わらない間は同じ値を返す必要があるので、文字列にまとめる
function getSnapshot() {
  const c = getConnection();
  return c ? JSON.stringify([c.effectiveType, c.downlink, c.rtt, c.saveData]) : '';
}

function getServerSnapshot() {
  return ''; // サーバーでは回線の状態が分からない
}

// 回線の推定値を返す。API がないブラウザでは null
export function useNetworkInformation(): NetworkInfo | null {
  const value = useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
  if (value === '') return null;
  const [effectiveType, downlink, rtt, saveData] = JSON.parse(value);
  return { effectiveType, downlink, rtt, saveData };
}

// データセーバーがオン、または 3g 以下と推定されたら「軽くする」
export function isLowData(info: NetworkInfo | null): boolean {
  if (!info) return false; // 分からないときは普段どおり
  return info.saveData || info.effectiveType !== '4g';
}

検証環境の TypeScript 7.0.2 で、lib に DOM を入れて navigator.connection.effectiveType と書くと、Property 'connection' does not exist on type 'Navigator'. というエラーになりました。そのため、使うプロパティだけを型として書いています。

getSnapshot が4つの値をオブジェクトにせず文字列にまとめているのは、React が前回の値と Object.is で比べて、違えば描き直すからです(公式リファレンスの useSyncExternalStore の引数の説明)。呼ぶたびに新しいオブジェクトを返すと、値が同じでも「変わった」と判断され、描き直しが止まらなくなります(公式リファレンスにある、getSnapshot の結果をキャッシュするよう求めるエラーの説明)。

navigator.connection がないブラウザでは、isLowData は false を返し、いつもの画像を出します。分からないときに小さい画像にすると、速い回線の利用者まで粗い画像を見ることになるからです。サーバーでの描画とハイドレーションでも、getServerSnapshot が空の文字列を返すので、同じく「分からない」として扱います。

回線に合わせて画像を選ぶ

AdaptiveImage は、小さい画像と大きい画像の2つの URL を受け取り、isLowData の結果でどちらを src にするかを決めます。

tsx
// AdaptiveImage.tsx
import { useState } from 'react';
import { isLowData, useNetworkInformation } from './useNetworkInformation';

type Props = {
  small: string; // 回線が遅いとき用の軽い画像
  large: string; // ふだんの画像
  alt: string;
  width: number;
  height: number;
};

export function AdaptiveImage({ small, large, alt, width, height }: Props) {
  const info = useNetworkInformation();
  // 大きい画像を一度読み込んだら、回線が遅くなっても小さい画像に戻さない
  const [largeLoaded, setLargeLoaded] = useState(false);
  const src = largeLoaded || !isLowData(info) ? large : small;

  return (
    <img
      src={src}
      alt={alt}
      width={width}
      height={height}
      onLoad={() => {
        if (src === large) setLargeLoaded(true);
      }}
    />
  );
}

largeLoaded は、大きい画像を読み込み終えたら true になり、それ以降は isLowData の結果にかかわらず large を src にします。なぜ必要かは、後の節で回線を速くしたり遅くしたりして確かめます。

使う側では、次のように回線の状態を表示して、その下に画像を置きました。画像は、幅 1600px(339,280 バイト)と幅 480px(16,592 バイト)の JPEG です。どちらが表示されたかが分かるよう、画像の中に幅を書いています。

tsx
// App.tsx
import { AdaptiveImage } from './AdaptiveImage';
import { isLowData, useNetworkInformation } from './useNetworkInformation';

export function App() {
  const info = useNetworkInformation();
  return (
    <main>
      <p id="status">
        {info
          ? `回線:${info.effectiveType}(下り ${info.downlink}Mbps、RTT ${info.rtt}ms)`
          : '回線:取得できない'}
        <br />
        データセーバー:{info ? (info.saveData ? 'オン' : 'オフ') : '不明'}
        <br />
        軽くする条件:<strong>{isLowData(info) ? 'あてはまる' : 'あてはまらない'}</strong>
      </p>
      <AdaptiveImage
        small="/img/cat-480.jpg"
        large="/img/cat-1600.jpg"
        alt="猫のイラスト"
        width={360}
        height={240}
      />
    </main>
  );
}

回線を遅くして読み込まれる画像を比べる

回線を制限せずにページを開くと、effectiveType は 4g で、読み込まれた画像は 1600px のものだけでした。

回線の状態の表示が「回線:4g(下り 9.9Mbps、RTT 0ms)」「データセーバー:オフ」「軽くする条件:あてはまらない」で、その下に「1600px」と書かれた猫のイラストが出ている画面
回線を制限しないで開いたとき。1600px の画像が出る

次に、遅延 2000ms、下り 50,000 バイト/秒(400Kbps)に制限してから開きました。effectiveType は 2g になり、読み込まれた画像は 480px のものだけです。

回線の状態の表示が「回線:2g(下り 0.4Mbps、RTT 2100ms)」「データセーバー:オフ」「軽くする条件:あてはまる」で、その下に「480px」と書かれた猫のイラストが出ている画面
回線を遅くして開いたとき。480px の画像が出る

同じ制限で、1600px の画像も別に読み込ませ、読み込みにかかった時間を performance.getEntriesByType('resource') で測りました。480px は 2,338ms、1600px は 8,813ms です。この回線では、小さい画像に替えると、画像の読み込みにかかる時間が4分の1ほどになります。

遅延 562.5ms、下り 200,000 バイト/秒に制限したときは、effectiveType は 3g になり、こちらも 480px の画像が出ました。

downlink と rtt は推定値なので、同じ条件でも開くたびに少しずつ違いました。回線を制限していないときの downlink は、9.1Mbps から 10Mbps の間で変わっています。MDN の互換性データの注記によると、Chrome では、利用者の識別に使われないよう、downlink は 10Mbps、rtt は 3000ms が上限になっていて、それより大きい値は返しません。画像を選ぶ条件には、細かく揺れる数字ではなく、effectiveType の区分を使うほうが扱いやすいです。

途中で回線が速くなったときと遅くなったとき

遅い回線で 480px の画像を出した後に、回線の制限を外しました。change イベントでフックが新しい値を返し、effectiveType が 4g になって、1600px の画像が読み込まれて差し替わりました。ページを読み込み直す必要はありません。

そのまま、もう一度回線を遅くしました。表示は 2g に戻り、「軽くする条件」も「あてはまる」になりましたが、画像は 1600px のままで、480px の画像へのリクエストは新しく出ませんでした。

比べるために、src を !isLowData(info) ? large : small だけで決める(largeLoaded を使わない)版で同じ操作をしました。こちらは、もう一度遅くしたときに画像が 480px に戻り、すでに一度読み込んだ 480px の画像へのリクエストがもう一度出ました。通信量を減らしたいのに、表示中の大きい画像を捨てて読み込みを1回増やしたことになります。なお、検証用のサーバーは画像をキャッシュさせない設定(Cache-Control: no-store)で返しています。

ポイント

回線が速くなったら大きい画像に切り替え、遅くなっても、読み込み済みの大きい画像を小さい画像に戻さない。こうすると、回線が揺れても同じ画像を何度も読み込みません。

データセーバーがオンのとき

saveData が true の場合は、回線が速くても小さい画像にします。検証環境では、Chrome DevTools Protocol の Emulation.setDataSaverOverride で saveData を true にしてからページを開きました。effectiveType は 4g のままでしたが、表示は「データセーバー:オン」になり、読み込まれた画像は 480px のものだけでした。

ただし、この上書きでは、ページを開いた後に true にしても saveData が変わるだけで、change イベントは届きませんでした。

navigator.connection がないブラウザでの動き

Firefox や Safari のように navigator.connection がないブラウザの代わりに、ページのスクリプトより先に Navigator.prototype.connection を消して開きました。'connection' in navigator は false になり、表示は「回線:取得できない」「データセーバー:不明」で、画像は 1600px のものが出ました。API がなくてもエラーにはならず、ふだんどおりの画像になります。

​Posted by 86