Lighthouseでmeta viewportがないときの直し方
Lighthouse で meta viewport がないと指摘されたときは、HTML の <head> に次の1行を入れると直ります。
<meta name="viewport" content="width=device-width, initial-scale=1">
この1行がないページは、スマホで開くと画面より広い幅(検証では 980px)で描かれ、画面の幅まで縮小されます。スマホで見ると文字が小さく、ページ全体が縮んで表示されるときの原因の1つです。Lighthouse の指摘は、ページがスマホの画面の幅に合わせて描かれる設定になっていないことを知らせるものです。
指摘の文言は Lighthouse のバージョンで違います。Lighthouse 12 までは「ベストプラクティス」の欄に「Does not have a <meta name="viewport"> tag with width or initial-scale」と出ます。Lighthouse 13 では「パフォーマンス」の欄のインサイトに「Optimize viewport for mobile」(日本語のレポートでは「ビューポートをモバイル向けに最適化する」)と出ます。私は検証環境で、meta viewport のないページと直したページに両方のバージョンの Lighthouse を実行し、指摘が出ることと消えることを確かめました。
検証環境は Ubuntu 24.04、Node.js 22.23.4、Lighthouse 13.6.0 と 12.8.2(npm で入れた CLI。13.6.0 の中で使われている axe-core は 4.14.0)、ブラウザは Google Chrome for Testing 153 のヘッドレスです。Lighthouse は初期設定のモバイル向けの条件(画面の幅 412px)で実行しました。ページは手元で作り、127.0.0.1 から配信しました。スマホとしての表示は、Playwright 1.63.0 でスマホの画面を再現して確かめました。Chrome の DevTools の Lighthouse パネルや PageSpeed Insights、実機のスマホでの表示は試していません。
Lighthouse 13 では、パフォーマンスのインサイトに出る
検証に使ったのは、見出しと2つの段落、ボタンだけの小さなページです。<head> には <meta charset="utf-8"> と <title>、<style> だけを入れ、meta viewport は入れていません。
このページを python3 -m http.server で配信し、次のように Lighthouse 13.6.0 を実行しました。
npx lighthouse http://127.0.0.1:8000/none.html \
--only-categories=performance,accessibility \
--output=json --output=html --output-path=./out/none \
--chrome-flags="--headless=new --no-sandbox" --quiet
検証では Chrome for Testing を使うため、環境変数 CHROME_PATH にその実行ファイルの場所(/path/to/chrome のような値)を指定してから実行しました。--no-sandbox は、検証用の環境で Chrome を起動するために付けたものです。
HTML のレポートでは、パフォーマンスの「Insights」の中に、左にオレンジの四角が付いた「Optimize viewport for mobile」が表示されました。

JSON のレポートから、点数と関係する項目を取り出すと次のとおりです(バージョンなどの行は省いています)。
performance score: 100
accessibility score: 100
viewport-insight: score=0.5 | metricSavings | title=Optimize viewport for mobile
metricSavings: {"INP":0}
meta-viewport: score=null | notApplicable | title=`[user-scalable="no"]` is not used in the `<meta name="viewport">` element and the `[maximum-scale]` attribute is not less than 5.
audit "viewport" exists: false
パフォーマンスの点数は100のままでした。レポートの「Unscored」の表示のとおり、このインサイトは点数に入りません。Lighthouse 13.6.0 の設定で、viewport-insight の重みが0になっているためです。点数が100でも、インサイトの欄に出ていれば直す対象です。
インサイトの点数が0ではなく0.5なのは、不合格でも、改善で縮む時間の見積もりがどれも0のときは、Lighthouse が点数を0.5にするためです。このインサイトは、計測中のタップが遅れた時間から、INP(操作への反応の速さの指標)がどれだけ縮むかを見積もります。ページを読み込むだけの計測ではタップがないので、INP の見積もりは0でした。レポートの説明には、ビューポートがモバイル向けに最適化されていないと、タップ操作が最大 300 ミリ秒遅れることがある、と書かれています。
最後の行の audit "viewport" exists: false は、Lighthouse 12 までの viewport という監査がレポートにないことを示しています。Lighthouse 13 の viewport-insight は、viewport の監査に置き換わるものとして作られています。Lighthouse 13.0.0 の変更履歴にも、パフォーマンスのインサイトに置き換わった監査を消したことが書かれています。
Lighthouse 12 では、ベストプラクティスの点数が下がる
同じページに Lighthouse 12.8.2 を実行すると、指摘は「ベストプラクティス」の欄に出て、点数も下がりました(どのカテゴリーに入っているかを示す行は省いています)。
lighthouseVersion: 12.8.2
performance score: 100
accessibility score: 100
best-practices score: 89
seo score: 90
viewport: score=0 | title=Does not have a `<meta name="viewport">` tag with `width` or `initial-scale`
explanation: No `<meta name="viewport">` tag found
ベストプラクティスの89は、viewport のほかに、文字が小さすぎることを指摘する font-size も落ちた結果です。直したページでは96になり、残りは favicon がないことによるコンソールのエラーだけでした。Lighthouse 13 では、13.0.0 の変更履歴にあるとおり font-size の監査も削除されていて、検証でもレポートにありませんでした。
直した後の結果
<head> に <meta name="viewport" content="width=device-width, initial-scale=1"> を入れたページで、同じように実行し直しました。Lighthouse 13.6.0 の結果は次のとおりです(バージョンなどの行は省いています)。
performance score: 100
accessibility score: 100
viewport-insight: score=1 | numeric | title=Optimize viewport for mobile
metricSavings: {"INP":0}
node: <meta name="viewport" content="width=device-width, initial-scale=1">
meta-viewport: score=1 | binary | title=`[user-scalable="no"]` is not used in the `<meta name="viewport">` element and the `[maximum-scale]` attribute is not less than 5.
インサイトは合格(score=1)になり、レポートでは合格した項目の欄にたたまれました。Lighthouse 12.8.2 でも、viewport は合格になりました。
viewport: score=1 | title=Has a `<meta name="viewport">` tag with `width` or `initial-scale`
1行で、スマホでの表示がどう変わるか
width=device-width は、ページを描くときの幅(レイアウトの幅)を画面の幅に合わせる指定です。initial-scale=1 は、開いたときの拡大率を等倍にします(MDN の viewport の説明)。
Playwright でスマホの画面(幅 412px、Lighthouse のモバイル設定と同じ幅)を再現し、2つのページを開いて、レイアウトの幅と拡大率を取り出しました。pOnScreenPx は、CSS で 16px にした段落の文字が、画面上で何 px 相当に見えるかを計算した値です。
none.html {"layoutWidth":980,"innerWidth":981,"scale":0.42,"pFontPx":16,"pOnScreenPx":6.7}
good.html {"layoutWidth":412,"innerWidth":412,"scale":1,"pFontPx":16,"pOnScreenPx":16}
meta viewport がないページは、幅 980px で描かれ、0.42倍に縮小されていました。16px の文字は、画面上では 6.7px 相当です。直したページは、レイアウトの幅が画面と同じ 412px になり、文字は 16px のまま表示されました。
幅 360px のスマホとして開いた画面を並べると、違いがはっきり分かります。

width と initial-scale はどちらか1つでもよいか
content の書き方を変えたページも用意し、両方のバージョンで試しました。
content の値 |
Lighthouse 13 のインサイト | Lighthouse 12 の viewport |
スマホでのレイアウトの幅 |
|---|---|---|---|
| (meta viewport なし) | 不合格(0.5) | 不合格 | 980px |
width=device-width, initial-scale=1 |
合格 | 合格 | 412px |
initial-scale=1 |
合格 | 合格 | 412px |
width=600 |
不合格(0.5) | 合格 | 600px |
initial-scale=1 だけでも、レイアウトの幅は画面の幅になり、どちらのバージョンでも合格しました。
width=600 のように幅を数字で固定したページは、バージョンによって結果が分かれました。Lighthouse 12 は、width か initial-scale のどちらかが書かれていれば合格にする作りなので、合格になります。Lighthouse 13 のインサイトは、Chrome が描いた画面をモバイル向けとみなしたかどうかで判定するので、不合格になりました。実際の表示も、幅 600px で描いて 0.687 倍に縮小され、16px の文字は 11px 相当でした。
fixed.html {"layoutWidth":600,"innerWidth":600,"scale":0.687,"pFontPx":16,"pOnScreenPx":11}
迷ったら、冒頭の width=device-width, initial-scale=1 をそのまま使えば、どちらのバージョンでも合格します。
拡大を禁止すると、アクセシビリティで落ちる
meta viewport を書くときに、maximum-scale=1 や user-scalable=no を足して、ピンチ操作での拡大を止めているページもあります。この書き方を試すと、viewport のインサイトは合格しましたが、アクセシビリティの meta-viewport が落ち、点数は100から86に下がりました(バージョンなどの行と、viewport のインサイトの細かい行は省いています)。
<meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1, user-scalable=no">
performance score: 100
accessibility score: 86
viewport-insight: score=1 | numeric | title=Optimize viewport for mobile
meta-viewport: score=0 | binary | title=`[user-scalable="no"]` is used in the `<meta name="viewport">` element or the `[maximum-scale]` attribute is less than 5.
node: <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1, user-scalable=no">
Fix any of the following:
user-scalable=no on <meta> tag disables zooming on mobile devices
拡大できないと、画面を拡大して読む弱視の人がページを読めなくなります。meta viewport の指摘を直すときは、user-scalable=no と maximum-scale を足さないでおくのが安全です。
監査の題名には「maximum-scale が5未満」とありますが、検証では maximum-scale=2 のページも合格しました。Lighthouse が使っている axe-core の meta-viewport の判定は、拡大の上限が2倍未満のときに落とす設定(scaleMinimum: 2)です。MDN の viewport の説明にも、WCAG が求めるのは少なくとも2倍まで拡大できることで、5倍まで拡大できるのが望ましいと書かれています。





