CSS以外で先月のブラウザに入った画像や通知まわりの変更

CSS以外で先月のブラウザに入った画像や通知まわりの変更

ブラウザの月ごとの更新というと、CSSの新機能に目が向きがちです。けれども先月は、画像の形式や通知、表示速度の計測、HTMLの差し込みといった、CSS以外のところにも現場に関わりそうな変更が入っていました。web.devの月次のまとめと、Chrome、Firefoxそれぞれの公式の説明から、制作の仕事に結びつきそうなものを並べてみます。

画像形式のJPEG XLがChromeとFirefoxで既定に

Chrome 155とFirefox 158が、画像形式のJPEG XL(拡張子は.jxl)を既定で表示できるようになりました。Safariは以前から対応しているので、主なブラウザでは表示できる範囲がかなり広がったことになります。一方、web.devの対応表ではEdgeがまだ未対応の扱いです。

Chromeの開発チームの説明によると、JPEG XLはJPEGに比べて30〜50%ほど圧縮の効率がよく、劣化のない圧縮やHDR、今あるJPEGを劣化させずに変換し直す機能も備えています。ただ、AVIFを置き換えるものという位置づけではなく、両方を試して結果のよいほうを選ぶことが勧められています。向いているのは、写真のように細部まで残したい画像や、劣化のない圧縮を使いたい場面とのことです。

Firefox 158では、画像を要求するときのAcceptヘッダーにも image/jxl が加わりました。サーバーや画像配信の仕組みがこのヘッダーを見て形式を出し分けている場合は、対応しているブラウザにだけJPEG XLを返す、という作りにしやすくなります。当面は picture 要素などで従来の形式を控えに置いておくのが無難でしょう。

通知を押したときの行き先をURLで書ける

Firefox 158で、通知を作るときの navigate という指定が使えるようになりました。通知を押したときに開くURLを、そのまま書いておける指定です。Safariにはすでに入っていて、Chromeはまだ対応していません。

これまでは、通知が押されたときのイベントをService Workerの側で受け取り、開くページを自分で指示する必要がありました。MDNの説明では、navigate を指定した通知は、押されるとイベントを起こす代わりにブラウザがそのURLへ移動します。予約の確定や発送の連絡のように、押した先のページが決まっている通知なら、書くコードが少なくて済みます。Chromeが未対応のあいだは、従来のイベントの処理も残しておくことになります。

キャッシュから読まれたかどうかを計測で見分けられる

表示速度を調べるときに使う PerformanceResourceTiming に、deliveryType という値があります。画像やスクリプトなどがどこから届いたかを示すもので、Firefox 158が対応したことで主なブラウザで使えるようになりました。MDNでも、先月から新しく広く使える機能として扱われています。

キャッシュから読まれた場合は cache という値が返るので、実際の訪問者の環境でキャッシュがどのくらい効いているかを集計しやすくなります。Firefoxが最初に対応したのはこの cache の値だけです。また、別のドメインから読み込むファイルは、相手側が計測を許可するヘッダーを返していないと空の値になります。外部のCDNに置いたファイルを調べたいときは、ここで数字が欠けることがあるので覚えておくとよさそうです。

HTMLを差し込むときの安全側の仕組みが整ってきた

利用者が入力した文字列などをページに差し込むとき、危ないタグや属性を取り除いてくれるHTML Sanitizer APIにも手が入りました。Firefox 158では、javascript: で始まるURLを含む属性を取り除くかどうかを設定で決められるようになっています。安全側のメソッドである setHTML() は、もともとこの種の属性を必ず取り除きます。今回の変更で、取り除く範囲を自分で決める setHTMLUnsafe() の側でも、既定の設定のままなら取り除かれるようになりました。

続くFirefox 159では、setHTML() が不要な要素や属性を取り除くタイミングが、DOMを組み立てたあとではなく解析の途中に改められています。MDNは、信頼できないHTMLを差し込む場面では innerHTML の代わりに setHTML() を使うよう勧めています。ただ、このAPI自体はまだ対応していないブラウザがあり、MDNでも広く使える機能には数えられていません。今すぐ切り替えるというより、検索結果の表示やコメント欄のように外から来た文字列を扱う箇所がどこにあるかを、先に洗い出しておく段階だと思います。

どれも派手な見た目の変化はありませんが、画像の配信、通知、計測、入力の扱いと、サイトの裏側の品質に関わるところばかりです。対応状況がそろうのを待つあいだに、画像の出し分けやキャッシュの計測のように、今の環境で試せるところから触れておくとよさそうです。

JavaScriptをCSSに置き換えたあとに残る思わぬ不具合

JavaScriptをCSSに置き換えたあとに残る思わぬ不具合

ResizeObserverで書いていた切り替えをコンテナクエリに置き換え、差分の大半が削除行になる。そんな整理を気持ちよく終えた経験のある制作者は多いと思います。Smashing Magazineに11月3日付で載った記事は、その「消した行の多さ」と「サイト全体の分かりやすさ」は別物だと指摘しています。筆者は新しいCSSの機能そのものを否定しているわけではなく、既存のCSSやJavaScriptとの関わりを確かめないまま入れると、ひとつのファイルは短くなっても全体の挙動を追いにくくなる、という立場です。

記事が挙げる落とし穴は四つあります。一つ目は、同じ振る舞いに持ち主が二人いる状態です。コンテナクエリを足したのに、別ファイルのResizeObserverと古いクラス指定が残り、ブレークポイントを片方だけ変えた結果、誰も書いていない中途半端な見た目が生まれる例が紹介されています。二つ目は container-type: inline-size の副作用です。この指定は新しいブロック整形文脈を作るため、マージンの相殺が止まり、回り込みの扱いも変わります。さらに、中身から幅を決めていたフレックスアイテムなどは、幅が0pxにつぶれて見えなくなることがあるそうです。

三つ目は詳細度です。.card:has(img) p のような短いセレクターは、コメント欄のアバター画像にも反応し、詳細度でもコメント側の指定に勝ってしまいます。筆者は子結合子 > で範囲を絞る方法や、:where() で重みをなくす方法を勧めています。カスケードレイヤーについても、新しい指定だけをレイヤーに入れると、レイヤー外の古い指定が常に勝つ点に注意が要るとしています。四つ目は表示速度で、5,000行の一覧で試したところ、単独では軽い二つの :has() の規則が同じスタイルシートにそろったときだけ、一行の切り替えで5,001要素が再計算されたという計測が示されています。これはChromeの一環境での結果で、筆者も数字より傾向を見てほしいと書いています。そのうえで、移す前と後でChromeの開発者ツールのパフォーマンスパネルを記録し、スタイルの再計算やレイアウトにかかる時間を、本番に近い量のデータで比べることを勧めています。

移行の前に確かめたいこと

記事の終わりには、振る舞いの持ち主、影響範囲、カスケード、古い実装の削除、性能の計測、次の担当者への分かりやすさの六つを、プルリクエストの説明に書いておくという確認項目が並んでいます。新機能の紹介記事の多くはまっさらな状態を前提に書かれているが、実際に世に出す仕事の多くは移行だ、という筆者の言葉には頷かされます。新規の案件より既存サイトの改修が多い制作会社にとって、この視点は身近です。テーマやプラグインのCSSが何層にも重なったWordPressサイトでは、新しい機能を一か所に足しただけで、別のページの余白や幅が変わることは珍しくありません。置き換えたあとは部品単体ではなく、その部品が実際に置かれているページをひと通り開いて確かめる。地味ですが、それがいちばん確実な後始末になりそうです。

部品の名前の衝突やモジュールの読み直しを助けるブラウザの変更

部品の名前の衝突やモジュールの読み直しを助けるブラウザの変更

web.devが10月29日に公開した月例のまとめでは、10月に安定版になったChrome 155と156、Firefox 158と159、Safari 27.1と27.2の新機能が紹介されています。見た目に関わるCSSの話題が目立ちがちですが、今回はその陰で、JavaScriptの部品やモジュールの扱い、計測、安全なHTMLの差し込みといった裏方の部分にも手が入っていました。ここでは、制作の現場で覚えておくと後で効いてきそうなものを順に拾ってみます。

その1 部品ごとに名前の登録先を分けられる

Web Componentsで作った部品(カスタム要素)は、これまでページ全体でひとつの登録先 window.customElements にまとめて登録する決まりでした。そのため、別々のライブラリやチームが作った部品を同じページに入れると、同じ名前がぶつかる問題が起きえました。

Firefox 159がスコープ付きのカスタム要素レジストリ(scoped custom element registries)に対応し、ChromeとSafariを合わせて主要ブラウザすべてで使える状態、いわゆるBaseline Newly availableになりました。CustomElementRegistry() で独立した登録先を作り、特定のShadow DOMの中だけで定義を有効にできます。外部の予約ウィジェットや地図の部品を、自前の部品と一緒に置くような案件では、名前の付け方で悩む場面が減りそうです。

その2 テキストをそのままモジュールとして読み込める

Chrome 155が、import ... with { type: "text" } という書き方でファイルの中身を文字列として読み込む機能に対応しました。Firefoxはすでに対応しており、Safariはまだです。HTMLのひな形やSVGの断片を文字列として扱いたいとき、これまでは fetch() で取りに行くか、ビルドの仕組みに頼るのが一般的でした。

ただ、Safariが未対応のうちは、そのまま本番のサイトで頼るのは早いと考えています。社内の管理画面や、対応ブラウザを限定できる場面から試すのが無難です。

その3 読み込みに失敗したモジュールを読み直せる

地味ですが効きそうなのがこちらです。Chrome 156から、読み込みに失敗したモジュールが失敗したまま記憶されなくなりました。一時的に回線が途切れて import() が失敗しても、もう一度呼べば読み直せます。

これまでは一度失敗すると同じページの中では取り戻せず、ページを読み直してもらうしかないことがありました。移動中のスマートフォンなど回線が不安定な利用者が多いサイトでは、「再試行」のボタンを用意するといった作りが現実的になります。

その4 キャッシュから届いたかを計測で見分けられる

Firefox 158が PerformanceResourceTiming.deliveryType に対応しました。読み込んだファイルがキャッシュから返されたときに "cache" と示してくれるプロパティで、ChromeとSafariはすでに対応しています。

表示速度を調べるとき、速かったのはキャッシュのおかげなのか、配信そのものが速かったのかを分けて見られると、改善の手を打つ場所がはっきりします。自前で計測の仕組みを入れているサイトなら、記録する項目に加えておく価値はありそうです。

その5 HTMLを安全に差し込む仕組みの細かな手直し

FirefoxではHTML Sanitizer APIにも手が入りました。Firefox 158では、Element.setHTMLUnsafe() のような安全確認を省く差し込み方を使うときに、javascript: で始まるURLを含む属性を取り除くかどうかを設定できるようになっています。Firefox 159では、Element.setHTML() などの安全な差し込み方が、DOMを組み立てた後ではなく、解析の途中で不要な要素や属性を取り除くように改められました。

対応しているのは今のところFirefoxが中心です。それでも、利用者の入力を画面に出す処理をどう安全にするかは、問い合わせフォームや口コミ欄を持つ中小企業のサイトでも無関係ではありません。各ブラウザの足並みがそろうまで、動きを追っておきたい分野です。

その6 見た目側ではスクロール連動のアニメーションがそろった

裏方の話が続いたので、最後に見た目側からひとつだけ。Firefox 159でスクロール連動のアニメーション(scroll-driven animations)が既定で有効になり、主要ブラウザすべてで使える状態になりました。スクロール量や要素の見え具合にアニメーションの進み具合を結びつける仕組みで、これまでJavaScriptで書いていた演出の一部をCSSで置き換えられます。

Baseline Newly availableは、主要ブラウザの最新版がそろって対応したという段階で、古い版を使う利用者がまだ残っている時期でもあります。部品の登録先やモジュールの読み直しのように、使えない環境で壊れると困る機能は、対応していない場合の動きを確かめたうえで取り入れていくのがよさそうです。

圧縮形式Brotliの読み出し側に見つかった欠陥と確かめどころ

圧縮形式Brotliの読み出し側に見つかった欠陥と確かめどころ

ページを軽くする圧縮形式として、gzipと並んで広く使われているBrotliに、深刻度の高い脆弱性が見つかりました。Googleが10月21日に修正版を出し、カナダのサイバーセキュリティセンターも10月28日付で注意喚起を出しています。米国のCISAは10月27日に、実際に悪用が確認された脆弱性の一覧へこの件を加えました。

名前だけ聞くと「サイトの圧縮を止めないといけないのか」と身構えてしまいますが、問題があるのは圧縮されたデータを元に戻す側、つまり読み出しの処理です。どこを確かめればよいのかを、一次情報をもとに整理してみます。

読み出しの処理でメモリの外に書き込んでしまう

対象はGoogleのBrotliライブラリの1.0.3から1.2.0までで、修正版は1.0.10、1.1.1、1.2.1の三つです。識別番号はCVE-2026-111497で、Googleは共通の評価基準で9.2(最も重い区分)と評価しています。

Brotliの圧縮データはブロックという単位に分かれていて、途中で符号の表を切り替えられる作りになっています。Node.jsの公表によると、不正な切り替えの指示が来たとき、本来は「データが壊れている」と判断すべきところを「入力が足りないだけ」と扱ってしまい、内部の小さな作業領域の外へ書き込みが続いていました。細工した圧縮データを読ませるだけで、処理の停止やメモリの中身の漏えい、場合によっては任意のコードの実行につながるとされています。ログインは必要ありません。

Brotliは単体で使われるより、ほかのソフトの中に組み込まれていることが多い技術です。カナダの注意喚起では、Node.js、.NET、PowerShell、Bun、Envoy、Istio、PythonのBrotliとbrotlicffiのパッケージなどが影響を受けるものとして挙げられています。

WordPressのサーバーで見ておきたいところ

まず安心材料から書くと、ApacheのBrotliモジュールやnginxは、標準の設定では送るときに圧縮するだけで、受け取ったデータを読み出す処理はしないと報告されています。サイトの表示を速くするためにBrotliの圧縮を有効にしていること自体が、すぐ危険につながるわけではありません。

一方で、PHPにBrotliの拡張を入れている場合は話が別です。この拡張は内部にBrotliの写しを持っていて、10月25日に出た0.21.1で修正版に入れ替わりました。OSのライブラリを更新しても、拡張が持っている写しは古いままになりうるので、拡張の版を個別に確かめる必要があります。DebianなどのOSのbrotliのパッケージにも修正版が出ているので、サーバーの定期的な更新と合わせて当てておくと安心です。

サーバーの外へデータを取りにいく処理も入り口になります。ある検証記事では、Pythonの代表的な通信ライブラリが、Brotliのパッケージさえ入っていれば、こちらが圧縮しないよう頼んでも、相手が圧縮して返してくれば読み出してしまうことが確かめられています。外部の画像やRSSを取り込む処理、Webhookの送り先、リンクの見出しを取りにいく処理など、相手のサーバーを選べない通信は特に気にしておきたいところです。

Node.jsと手元の開発環境も見直す

Node.jsは10月21日に、22.23.4、24.22.1、26.12.1の修正版を出しました。公式のNode.jsはBrotliを本体の中に抱えているため、OSのライブラリを更新しても直りません。Express 5は標準で圧縮された送信データを読み出すので、Node.jsで受付の仕組みを作っている場合は優先して更新したいところです。すでにサポートが終わったNode.js 20系などには修正が出ないので、これを機に乗り換えを考える必要があります。

見落としやすいのが手元のパソコンです。先の検証では、Git for Windowsに同梱されたcurlが古いBrotliを使っていて、信頼できない相手からcloneすると応答が読み出される状態だったと報告されています。10月26日の2.56.0.windows.4で修正版に入れ替わったので、git versionで版を見ておくとよいでしょう。ビルドの道具としてNode.jsを入れている制作者の環境も同じく更新の対象です。

なお、Node.jsは同梱のBrotliの版を上げずに修正だけを取り込んだため、表示される版は1.1.0のままです。版の文字列だけで判断せず、Node.js本体の版で確かめるのが確実です。

すぐに更新できないときの考え方

カナダの注意喚起では、修正版をすぐに入れられない場合、信頼できない相手から来たBrotliの圧縮データを処理させないよう求めています。受け取る側なら、手前の中継サーバーで圧縮形式にbrが含まれる送信を断る、Expressなら送信データの読み出しを止める設定にする、といった手が挙げられています。あわせて、処理の予期しない停止や不審な動きがないかを見ておくことも勧められています。

今回の件は、ページを速くする技術が、いつのまにかサーバーや開発環境のあちこちに組み込まれていることを改めて気づかせてくれました。表に見える設定だけでなく、拡張や同梱物の中身まで含めて、どこで何が使われているかを一度洗い出しておくと、次に似たことが起きたときの動きがずっと速くなるはずです。

Chromeの次の版でサイトからアプリのインストールを促せる

Chromeの次の版でサイトからアプリのインストールを促せる

ウェブアプリをパソコンに「インストール」する操作は、これまでブラウザ任せでした。アドレスバーの小さなアイコンやメニューの奥の項目を、利用者が自分で見つけるしかなかったのです。10月28日にベータ版になったChrome 158では、この入口をサイトの側で用意できる仕組みが入ります。安定版の予定日は11月17日とされています。

中身は二つあります。一つはJavaScriptから呼ぶ navigator.install()、Web Install APIと呼ばれるものです。もう一つは、HTMLに <install> 要素を一つ置くだけで、ブラウザがインストールのボタンを描いてくれる方法です。Chrome Platform Statusの項目では、Web Install APIはこの要素と並行して出すと説明されています。どちらも、いま開いているサイトだけでなく、別のサイトのウェブアプリもインストールの対象にできます。自社の複数のアプリを一覧ページに並べ、それぞれにボタンを付けるといった使い方が想定されています。

勝手に入るわけではない

サイトができるのは「インストールしませんか」と尋ねるところまでで、確認を出すのはブラウザ、決めるのは利用者です。<install> 要素はボタンの文言や見た目をブラウザが決めるため、利用者のクリックを本当の意思表示として扱える、というのがChrome for Developersの説明です。navigator.install() のほうは、クリックやタップといった利用者の操作の直後でないと呼べません。企業や学校では、WebAppInstallByUserEnabledというポリシーで利用者によるインストールを止めたり、web-app-installationという権限ポリシーで使えるサイトを絞ったりできるとされています。

実務で気になるのは準備の手間です。ウェブアプリのマニフェストに id の項目があれば、<install> 要素は一行で済みます。id がない場合は、開発者ツールのApplicationタブに出る計算済みのIDを別に指定します。対応していないブラウザでは要素の中に書いたHTMLがそのまま表示されるので、普通のリンクを入れておけば代わりの導線になります。

ほかのブラウザの足並みはそろっていません。OpenPWAがまとめたChrome Platform Statusの記録では、Web Install APIの対象はデスクトップ版のChromeで、Androidなどの時期は書かれていません。標準化への立場は、Mozillaが態度未表明、WebKitが反対です。<install> 要素はMicrosoft EdgeのチームがChromeのチームと共同で実装してきたもので、当面はChromium系のブラウザ向けの機能と考えておくのがよさそうです。

中小企業のサイトでウェブアプリまで用意している例はまだ多くありませんが、予約や会員向けの画面をアプリのように使ってもらいたい場面では、案内の手間が一段減ります。すでにマニフェストを置いているサイトなら、id が入っているかを確かめておくだけでも、試すための下準備としては十分です。

Node.jsの改版が年に一度になり今の長期サポート版が旧方式の最後に

Node.jsの改版が年に一度になり今の長期サポート版が旧方式の最後に

10月28日、Node.js 26が長期サポート(LTS)の段階に入りました。版は26.13.0、愛称は「Lithium」です。中身は直前の26.12.1から変わっておらず、LTSになったことを示す情報(process.release など)を書き換えただけの更新とされています。サポートは2029年4月末まで続く予定です。区切りの更新に見えますが、今回はNode.jsの出し方そのものが切り替わる節目でもあります。

Node.jsはこれまで、年に2回大きな版を出し、偶数の版だけをLTSにしてきました。公式の告知によると、次の27からは大きな版を年に1回だけ出し、そのすべてをLTSにします。奇数か偶数かの区別はなくなり、Node.js 26は旧方式で出る最後の版になります。

新しい流れと手元で気にしたいこと

新方式では、まず10月から翌年3月までの半年間を「Alpha」として試験的に配り、4月に正式な版を出し、10月にLTSへ移ります。LTSの期間は30か月で、最初の正式版から終了までが36か月という計算です。Alphaは互換性を崩す変更も入りうる試験用の版で、署名とタグが付き、主要なパッケージの試験も通したうえで配られます。本番での利用は想定されていません。公式の版一覧には、10月29日の時点でv27がAlphaとして載っています。版の番号は、正式版が出る年に合わせて27は2027年、28は2028年と並ぶ予定です。

告知では、この変更の理由も説明されています。奇数の版はほとんど使われず、多くの組織がLTSだけを追ってきたこと、そして同時に4〜5本の系列へ修正を当て続けるのが、主にボランティアで回っている開発体制にとって重くなっていたことが挙げられています。LTSだけに上げてきた人にとっては、変わるのはほぼ番号の付き方だけ、というのが公式の見立てです。

ウェブ制作の現場でNode.jsに触れるのは、テーマのCSSやJavaScriptをまとめるビルドの道具、静的サイトの生成、デプロイの仕組みあたりが多いと思います。手元やCIで使う版を決めている設定(.nvmrc や package.json の engines、CIの設定ファイルなど)が古い版のままになっていないか、この機会に見ておくと安心です。版一覧ではv20がすでにサポートを終えており、v22とv24はまだLTSとして更新が続いています。

なお、Node.js 24や22から26へ上げる場合、26.13.0の公開の案内には、25以降のLinux向けの公式バイナリが libatomic というライブラリに依存するようになったとの注意があります。配布しているディストリビューションによっては別に入れる必要があるため、サーバーやCIの環境で上げるときは先に確かめておくとつまずきにくいはずです。毎年4月と10月という予定がはっきりしたことで、制作の道具の版をそろえる時期も決めやすくなりそうです。

Service Workerを起こさずに通信を振り分ける仕組みがSafariにも届いた

Service Workerを起こさずに通信を振り分ける仕組みがSafariにも届いた

web.devが10月2日に公開した9月分のウェブプラットフォーム新機能まとめに、地味ながら気になる項目がありました。Safari 27が、Service Workerの「Static Routing API」に対応したという話です。Chromeでは版123から使えていた機能で、これでSafariとChrome系の両方で動くようになりました。表示速度に関わる仕組みなので、少し掘り下げて紹介します。

Service Workerが抱えていた待ち時間

Service Workerは、ページとネットワークの間に入って通信を仲介するスクリプトです。オフライン表示やキャッシュの制御に使われ、WordPressでもPWA化やキャッシュ系のプラグインを通じて、知らないうちに組み込まれているサイトがあります。

ただ、Service Workerを置くと、そのサイトへのリクエストはいったんService Workerのfetchイベントを通るのが基本です。Service Workerが止まっている状態なら、まず起動させてから処理を始めることになります。結果として、キャッシュから返すだけ、あるいはそのままネットワークへ流すだけのリクエストでも、Service Workerの起動を待つ時間が生じていました。

Chrome for Developersの解説によると、Static Routing APIはこの部分を解消するためのものです。どのパスをどこから取得するかをあらかじめ宣言しておくことで、ブラウザはキャッシュやネットワークから取るだけのためにService Workerを動かさずに済むとされています。web.devの記事でも、起動を待たずに取得できることでページ遷移の速度が上がると説明されています。

インストール時に道筋を登録しておく

使い方は、Service Workerのinstallイベントの中で event.addRoutes() を呼び、振り分けのルールを渡すだけです。ルールは「条件」と「取得元」の組み合わせで書きます。

条件には、URLの形(urlPattern)、リクエストのメソッド、モード、取得先の種類、Service Workerが起動中かどうか、を指定できます。複数の条件を書いた場合は、すべてを満たしたときだけそのルールが使われます。取得元は、ネットワーク、キャッシュ、従来どおりのfetchイベント、ネットワークとfetchイベントを競わせる方式、の中から選びます。名前を指定して特定のキャッシュストレージを使うこともできます。

たとえば、フォームへのPOST送信はService Workerを通さず、そのままネットワークへ送る、という指定は次のように書けます。

addEventListener('install', (event) => {
  event.addRoutes({
    condition: {
      urlPattern: "/form/*",
      requestMethod: "post"
    },
    source: "network"
  });
});

画像の拡張子を条件にして特定のキャッシュから返す、記事ページはService Workerが起動中のときだけfetchイベントに回す、といった書き分けも解説の例に挙がっています。なお、試験提供の段階では registerRouter() という一度しか呼べないメソッドでしたが、利用者の意見を受けて今の addRoutes() に変わったそうです。Chromeの開発者ツールでは、Applicationパネルに登録済みのルールが表示され、Networkパネルでもルールに一致したリクエストを見分けられます。

制作現場で押さえておきたいこと

web.devの対応表を見ると、ChromeとEdgeは版123から、Safariは今回の27から対応していますが、Firefoxはまだ未対応です。対応していないブラウザでは従来どおりfetchイベントで処理されるだけなので、ルールを追加しても表示が壊れるわけではありません。速くなる環境が増えた、と受け止めるのが妥当なところです。

中小企業のサイトで直接この記述を書く場面はそう多くないかもしれません。それでも、Service Workerを使っているサイトを引き継いだときや、キャッシュ系のプラグインを選ぶときに、こうした振り分けに対応しているかどうかは一つの見どころになります。特にお問い合わせフォームや管理画面への通信のように、キャッシュを挟む意味がないリクエストを素通しにできるのは、速度だけでなく不具合の切り分けの面でも助かります。

Service Workerは入れると速くなる一方で、仲介が増えるぶんの負担もある、という両面を持つ仕組みでした。その負担を宣言ひとつで減らせる手段が主要なブラウザにそろってきたので、手元のサイトでService Workerが何を受け持っているのか、一度確かめてみる良い機会だと思います。

innerHTMLに代わるHTMLの差し込み方がそろってきた

innerHTMLに代わるHTMLの差し込み方がそろってきた

JavaScriptで画面の一部を書き換えるとき、多くの現場ではいまも innerHTML に文字列を代入する書き方が使われています。手軽で、どのブラウザでも動き、昔のサンプルコードもほとんどがこの形です。ところがこの秋、この「HTMLの文字列を差し込む」という基本動作のまわりで、ブラウザ側の整備が一段進みました。

9月16日にベータ版となったChrome 155では、HTMLを差し込む新しいメソッド群と、差し込みながら少しずつ流し込むストリーミング用のメソッドが入っています。Firefoxは今年2月の148で、差し込むときに危険な部分を取り除く setHTML() を先に出荷しました。安全性と速さという別々の課題に、同じ入り口から手が入りつつある、というのが今回の見立てです。

innerHTMLが抱えてきた二つの弱点

innerHTML の弱点は、大きく分けて二つあります。一つ目は安全性です。ユーザーが入力した文字列や外部から取ってきたデータをそのまま代入すると、紛れ込んだイベント属性などから任意のスクリプトが動く、いわゆるクロスサイトスクリプティング(XSS)の入り口になります。Mozillaの解説では、XSSは10年近くにわたってウェブの脆弱性の上位三つに入り続けているとされています。

二つ目は、同じような目的のメソッドが乱立していることです。Chromeのドキュメントでは、innerHTML、outerHTML、insertAdjacentHTML、createContextualFragment、setHTMLUnsafe などを並べたうえで、上書きなのか追記なのか、危険なタグを取り除くのか、スクリプトは実行されるのか、といった違いを即答できる開発者は少ないだろうと率直に書いています。確かに、制作の現場でもこの違いを意識して使い分けている例はあまり見かけません。

さらにもう一点、これらはすべて「差し込むHTMLが最初から全部そろっている」ことが前提です。サーバーから届く途中のHTMLを順に表示していく、というHTML本来の強みを、JavaScriptからの差し込みでは活かせませんでした。

危険な部分を取り除いてから入れるsetHTML

安全性の側の答えが、HTML Sanitizer APIと、その中心にある setHTML() です。使い方は innerHTML への代入をメソッド呼び出しに置き換えるだけで、差し込む前にブラウザが危険な要素と属性を取り除きます。MDNによると、既定の設定では script、iframe、embed、object などの要素や、onclick のようなイベント属性がすべて落とされ、さらにクリックジャッキングやなりすましに使われうる要素、コメント、data- 属性まで取り除かれます。

許可する要素を自分で指定することもできます。たとえば段落と太字だけを通す、といった「許可リスト型」の設定を作れば、想定外のタグは一切入りません。MDNは、危険なものを列挙して外す方式より、必要なものだけを列挙して通す方式のほうが安全だと説明しています。将来新しい危険な要素が見つかっても、許可リストに入っていなければ最初から通らないためです。

これまでこの役割は、DOMPurifyのような外部ライブラリが担ってきました。MDNは、ブラウザに組み込まれた方式のほうが、解析の文脈や実行されうるコードをより正確に把握できるため、安全な方のメソッドを使うなら外部ライブラリは不要になるという立場です。ただし、この機能はまだ主要ブラウザすべてでは使えない段階にあり、特にSafariが未対応である点は押さえておく必要があります。

名前をそろえた差し込み用メソッド群

Chrome 155で入るのは、差し込む位置ごとに名前をそろえたメソッド群です。要素の中身を置き換える setHTML() を軸に、要素ごと置き換える replaceWithHTML()、前後に足す beforeHTML() と afterHTML()、子要素の先頭と末尾に足す prependHTML() と appendHTML() が用意されています。ベータ版の告知では、これらが insertAdjacentHTML() の実質的な置き換えになると位置づけられています。

それぞれには、危険な部分の除去をしない「Unsafe」付きの版もあります。名前だけ見ると使ってはいけないもののようですが、Chromeのドキュメントは、これは入力の信頼度に応じてリスクを意識してほしいという注意書きであり、使うなという意味ではないと説明しています。Unsafe版では、オプションを指定すれば差し込んだHTML内のスクリプトを実行させることもでき、初期値は実行しない設定です。

地味な変更に見えますが、名前の規則が一つにまとまることの効果は小さくありません。コードを読んだ人が「このメソッドは安全側か」「どこに入るか」を名前だけで判断できるようになれば、レビューや引き継ぎのときの見落としが減ります。複数の人が触るサイトほど、こうした読みやすさは効いてきます。

届いた分から順に流し込むストリーミング

もう一つの柱が、ストリーミング用のメソッドです。上の各メソッドには streamHTML() や streamAppendHTML() のような対応版があり、Streams APIの書き込み口を返します。fetch() で取ってきた応答をそのままつなげば、サーバーから届いた分から順に画面へ反映できます。Chrome 151からは、応答を文字列の流れとして取り出す textStream() という便利なメソッドも加わり、中間の変換処理を書かずに済むようになりました。

これまで、ページの一部をJavaScriptで差し替える作りでは、応答をすべて受け取ってから一気に入れるのが普通でした。Chromeのドキュメントは、単一ページアプリケーションが最初の読み込み以外ではHTMLの逐次表示の恩恵を受けられないことを大きな弱点として挙げ、この新しいメソッドでそこを埋められるとしています。共通のフッターのような部品を別ファイルから取り込み、キャッシュを効かせる使い方も例に挙がっています。ただし、JavaScriptが動かないと表示されない以上、最初の画面で見える部分に使うのは避けるべきだという注意も添えられています。

同じ取り組みの一部として、HTMLの中で後から中身を差し替える仕組みも進んでいます。場所の目印を置いておき、ページの後半で template 要素に for 属性を付けて中身を送ると、目印の位置にはめ込まれる、という方式です。重い処理を待つ部分だけを後回しにして、先に骨組みを表示できます。こちらはChrome 150から使えるとされています。

ブラウザごとの足並みと当面の付き合い方

ここまでの話を整理すると、各ブラウザの足並みはまだそろっていません。setHTML() による安全な差し込みはFirefoxが先行し、Chromeは差し込み位置ごとのメソッドとストリーミングを前に進めています。一方でSafariはSanitizer APIに対応しておらず、MDNでも主要ブラウザで広く使える段階にはないと表示されています。

Chromeのチームは、新しいメソッドの形をそのまま使えるようにする補助ライブラリをnpmで公開しています。ただしドキュメント自身が、この補助ライブラリは実際には流し込まず、全部受け取ってからまとめて差し込むと明記しています。安全な差し込みの部分も、ブラウザ側のSanitizer APIがなければ成り立ちません。つまり補助ライブラリは、書き方を先取りするためのもので、機能そのものを全ブラウザで再現するものではない、と理解しておくのがよさそうです。

もう一つの論点は、Trusted Typesとの関係です。これは危険になりうる差し込み口に、決められた変換処理を必ず通させる仕組みです。Mozillaは、setHTML() を採用したあとなら、setHTML() だけを許して他の危険な差し込み方を禁じる厳しい設定にしやすくなり、今後の書き間違いによるXSSの再発を防げると説明しています。Content Security Policyが大がかりな改修を必要としたため広く普及しきらなかった、という反省も同じ記事で触れられており、今回の仕組みは「コードの置き換えを小さく済ませる」ことに重きが置かれています。

中小企業のサイト運用で見ておきたいところ

では、日々のサイト制作や保守で何をすればよいか。すぐに全面的な書き換えが必要な話ではありません。ただ、お知らせの一覧をJavaScriptで読み込んで表示する部分や、問い合わせフォームの入力内容を確認画面に出す部分など、外から来た文字列を innerHTML で差し込んでいる箇所は、どのサイトにも意外と残っています。まずはそうした箇所を把握しておき、Safariを含む主要ブラウザで使えるようになった段階で、setHTML() への置き換えを検討する、という順番が現実的です。

WordPressのサイトでも、テーマやプラグインのJavaScriptに同じような書き方が含まれていることがあります。自社で書いた追加のスクリプトであれば、置き換えの候補として一覧にしておくだけでも、将来の改修の見積もりがしやすくなります。外部のプラグインについては、作者側の対応を待つことになりますが、どの部分が外から来たHTMLを扱っているかを知っておくことには意味があります。

ストリーミングのほうは、表示速度を気にする規模の大きなサイトや、画面の一部を頻繁に差し替える管理画面のような作りで先に効いてくるはずです。普通のコーポレートサイトでは急いで取り入れる理由は少ないものの、HTMLを後から流し込めるようになると、ページの組み立て方の選択肢が確実に増えます。長く制作を続けてきた立場から見ても、innerHTML ひとつで何でも済ませていた時代から、目的に応じて安全な道具を選べる時代へと、基本の部分が静かに入れ替わり始めているように感じます。

モーダルを閉じたときに出る警告は消すより順番を直す

モーダルを閉じたときに出る警告は消すより順番を直す

モーダルウィンドウを閉じた瞬間、Chromeの開発者ツールのコンソールに黄色い警告が出る。Bootstrapでも、Angularでも、Ionicでも、同じ文面が出てくるおなじみのものです。検索すると一行で黙らせる方法がすぐ見つかるので、深く考えずに入れてしまった経験がある方も多いのではないでしょうか。

CSS-Tricksに、この警告は正しく、よく出回っている直し方のほとんどは使う人を困らせる方向に働いている、と正面から論じた記事が掲載されました。表示の崩れとして目に見えない不具合だけに、制作の現場では見落としやすい話です。

警告が伝えているのはフォーカスの置き去り

問題の中心は、aria-hidden という属性の性質にあります。この属性は要素をスクリーンリーダーなどの支援技術から見えなくしますが、キーボードでのフォーカス移動からは外しません。つまり、読み上げの対象からは消えているのに、Tabキーでは到達できる、という食い違いが起こり得ます。

モーダルを閉じる処理でよくあるのが、先に外側の枠へ aria-hidden を付けてフェードアウトを始め、アニメーションが終わってから元のボタンにフォーカスを戻す、という順番です。この間、閉じるボタンにはまだフォーカスが残っています。記事によると、Chromeはこの状態を見つけると指定された非表示を実際には適用せず、読み上げ側に中身を見せたままにしたうえで警告を出しているとのことです。コンソールの表示はお知らせではなく、書いたマークアップをブラウザが上書きしたという報告だと捉えたほうが実態に近いようです。

よく見かける直し方が使う人を置き去りにする

検索上位によく出てくるのが、閉じる処理の中で document.activeElement.blur() を呼ぶ一行です。確かに警告は消えます。ただ、フォーカスはどこにも移らず、ブラウザはページ全体の body に落とします。マウスで操作している人には何も起きていないように見えますが、キーボードやスクリーンリーダーで操作している人は、読み上げが途切れたうえに、次のTabでページの先頭からやり直すことになります。記事では、フォーカスの順序に関するWCAGの達成基準2.4.3に反する状態だと指摘しています。

ほかにも、setTimeout などで処理を少し遅らせる方法、aria-hidden 自体を取り除く方法、Radixやshadcnでモーダル扱いそのものを外してしまう設定などが紹介されていますが、いずれも警告を静かにする代わりに別の不都合を生むとされています。遅らせる方法は処理の重い端末で失敗が不定期に出るようになり、属性を外す方法はモーダルを開いている最中に背後のページを操作できてしまいます。

筆者自身もこの一行を入れて出荷し、後日の利用者テストでスクリーンリーダー利用者がページの先頭から延々とTabを押して元の場所へ戻る様子を見て、ようやく意味に気付いたと書いています。自動のアクセシビリティ検査も静止した状態のマークアップを見るため、この種の順番の不具合は通ってしまう、という指摘は制作側として耳が痛いところです。

閉じるときの手順を並べ替える

記事が示す正しい直し方は、新しい部品を足すことではなく、閉じる処理の順番を入れ替えることです。要点は、隠す領域からフォーカスを先に出してから隠す、の一点に集約されます。手順としては次の流れになります。

  • 開いている間に背後のページへ付けていた inert を先に外す
  • モーダルを開いたボタンへ、その場でフォーカスを戻す
  • 閉じかけているモーダル自体には aria-hidden ではなく inert を付け、クリックも受け付けないようにしてからフェードアウトさせる
  • アニメーションが終わった時点で要素を取り除く

inert は読み上げの対象からも、フォーカス移動からも、クリックからも要素を外す属性なので、フェード中の抜け殻を安全に扱えます。また、開いたボタンそのものは開く処理の時点で記録しておく必要があります。フォーカスをモーダルの中へ移したあとでは、どこから来たのかが分からなくなるためです。

加えて、動きを減らす設定の利用者のようにアニメーション自体が走らない場合、終了を知らせるイベントが来ないまま要素が残り続けるという落とし穴も挙げられています。削除した行のメニューから開いたモーダルのように、戻り先のボタンがもう無い場合に備えて、代わりの戻り先を用意しておくことも勧められています。

新しく作るなら標準のdialog要素が近道

記事の冒頭で真っ先に勧められているのが、HTML標準の dialog 要素を showModal() で開く方法です。この場合、フォーカスの受け渡しや背後の操作不能化はブラウザが引き受けてくれるため、今回のような不具合はほぼ起きなくなるとされています。Bootstrapも次の大きな版で自前の処理をやめ、この標準の仕組みに寄せたと紹介されています。

中小企業のサイトでも、お問い合わせの確認画面や画像の拡大表示など、モーダルは意外と多く使われています。既存のライブラリをすぐに入れ替えられない場合でも、閉じる処理でフォーカスがどこへ戻るかをキーボードだけで一度確かめてみる価値はありそうです。コンソールをきれいにすることが目的になっていないか、改めて見直すきっかけになる記事でした。

npmの公開に人の承認を挟む流れが強まっている

npmの公開に人の承認を挟む流れが強まっている

WordPressのブロックテーマやプラグインを作っていると、npmを使わない日はほとんどありません。ビルド用のツール一式も、CSSの処理も、小さな便利ライブラリも、たいていnpm経由で入ってきます。そのnpmで、9月に入ってから公開の手順まわりの変更が立て続けに発表されました。一つひとつは地味な更新ですが、並べてみると「パッケージを公開する最後の一押しは人間がやる」という方向がはっきり見えてきます。

今回は、GitHubの変更履歴(Changelog)に9月に載った三つの更新と、6月に予告されたnpm v12の既定値の変更、そしてその背景にある8月のワーム被害をつなげて、制作の現場から見た意味を考えてみます。

8月に起きたことを振り返る

話の出発点は、8月4日に起きたnpmパッケージの大規模な乗っ取りです。Datadog Security Labsの分析によると、キャッシュ用ライブラリとして広く使われているkeyvのGitHubリポジトリに不正なコミットが入り、そこから公開された版に悪意あるコードが仕込まれました。同じ手口はcacheable系のパッケージ群やectoにも広がり、flat-cacheやfile-entry-cacheといった、名前を見れば依存関係の奥で見覚えのあるパッケージも含まれていました。コミュニティではChainDropと呼ばれています。

仕組みとしては、パッケージのインストール時に自動で走るpreinstallスクリプトから読み込み役のファイルを起動し、そこから本体を動かすというものです。本体は開発者の端末やCIの環境から、GitHubやnpmのトークン、クラウドの認証情報、環境変数などを集めて外部へ送り出します。さらに、盗んだnpmトークンのうち二要素認証を迂回できる設定のものを見つけると、そのトークンで書き込める別のパッケージにも同じ仕掛けを入れて勝手に新しい版を公開する、という自己増殖の機能まで備えていました。

見落とせないのは、keyvの問題の版が、GitHub Actionsのワークフローから正規の手順で公開され、正しい来歴証明(provenance)まで付いていたという点です。Datadogは、来歴証明は「どこでどう作られたか」を示す証拠であって、安全かどうかの判定ではないと指摘しています。ワークフローそのものが乗っ取られていれば、証明は悪意あるコードの出どころを忠実に記録してしまうわけです。

ステージ公開という考え方

こうした流れを受けて、npmが力を入れているのがステージ公開(staged publishing)です。これは、新しい版をいきなりレジストリに出すのではなく、いったん「公開待ち」の状態に置き、メンテナーが二要素認証を通したうえで承認して初めて公開される、という手順です。

9月3日の更新では、この仕組みまわりに三つの変更が一般提供になりました。一つ目は、トークンを使わずにCIから公開する信頼済み公開(trusted publishing)の設定を、一つのパッケージに複数持てるようになったこと。安定版、プレリリース版、検証用といったワークフローを分けて運用できるようになり、これまでOIDCでまかなえない経路のために長期間有効なトークンを残しておく、といった回避策が要らなくなります。

二つ目は、公開待ちのパッケージはマルウェアの検査が終わるまで承認ボタンが押せなくなったこと。三つ目は、npmjs.comの版一覧で、それぞれの版が承認されたのか、却下されたのか、まだ待ち状態なのかという履歴がメンテナーから見えるようになったことです。

興味深いのは、信頼済み公開の設定は既定で「ステージまで」しかできず、直接の公開は設定ごとに明示的に有効にしないと使えない、という点です。GitHubは設定をステージ専用のままにしておくことを勧めています。ワークフローが乗っ取られても、人の承認がなければレジストリまで届かない。8月の件で破られた部分を、ちょうど塞ぐ形になっています。

トークンにも「ステージまで」の権限ができた

9月18日には、細かく権限を絞れるアクセストークン(granular access token)に、読み書きのうち「ステージのみ」という選択肢が加わりました。このトークンを使う自動化の処理は、npm stage publishで版を公開待ちに出すことはできますが、npm publishで直接公開しようとすると拒否されます。二要素認証の迂回を許可する設定にしていても同じです。

背景には、npmが2027年1月をめどに、二要素認証を迂回するトークンによる直接公開を廃止する予定だという事情があります。信頼済み公開にすぐ移れない現場向けの、移行の足がかりという位置づけです。ただし、ステージ専用トークンも配布タグの付け替えや版の非推奨化といった書き込み権限は残っているため、ほかの書き込み用トークンと同じように慎重に扱うよう注意書きがあります。利用にはnpm CLI 11.15.0以降、Node.js 22.14.0以降が必要とされています。

8月のワームが増殖に使ったのは、まさに二要素認証を迂回できる書き込み用のトークンでした。ステージ専用に切り替わっていれば、盗まれても勝手に新しい版を世に出すことはできません。ここでも、狙われた経路に対してピンポイントで手が打たれているのがわかります。

アカウントを取り戻したあとの猶予期間

9月9日の更新はもう少し地味で、リカバリーコードでサインインしたアカウントに、72時間の保留期間を設けるというものです。これまでは影響の大きいアカウントだけに適用されていた保護が、すべてのnpmアカウントに広がりました。

保留中は、サインインやパッケージの閲覧、インストールはできますが、公開やアクセストークンの作成といった影響の大きい操作が止まります。期間が過ぎれば自動で解除され、問い合わせなどは必要ありません。リカバリーコードが盗まれてアカウントを乗っ取られた場合に、すぐに悪意ある版を出されるのを遅らせるための仕組みです。自分で使った覚えがないのに公開できなくなったら、すぐにnpmのサポートに連絡してほしいとされています。

インストールする側の既定値も変わる

ここまでは公開する側の話でしたが、使う側にも大きな変更が予告されています。6月に発表されたnpm v12の破壊的変更では、npm installの挙動のうち、これまで自動で動いていたものを明示的に許可する方式に切り替えるとされています。

中心になるのは、依存パッケージのpreinstall、install、postinstallといったスクリプトを、既定では実行しなくなるという変更です。ネイティブ拡張のビルドも対象に含まれます。どのパッケージのスクリプトが止まるかはnpm approve-scriptsで一覧でき、信頼するものだけを許可すると、その許可リストがpackage.jsonに書き込まれます。あわせて、Gitリポジトリやhttpsのtarballといった外部の場所から依存を取ってくる動作も、既定では許可しない方向です。これらはnpm 11.16.0以降で警告として先に確認できます。

8月のワームが最初に動き出したきっかけはpreinstallスクリプトでした。インストールしただけで任意のコードが走るという、長年の前提そのものに手が入るわけで、影響は小さくありません。

制作会社の現場で見直しておきたいこと

npmにパッケージを公開していない制作会社でも、使う側としての備えは必要です。まず、案件ごとのリポジトリでnpmのバージョンを上げ、どのパッケージがインストール時にスクリプトを実行しているのかを一度洗い出しておくと、v12への移行で慌てずに済みます。古い案件ほど、ビルドの途中でネイティブ拡張を組み立てるパッケージが紛れていることがあり、許可リストの作成に意外と手間がかかるかもしれません。

次に、CIに置いているトークンの棚卸しです。今回の分析では、盗まれた情報の中心がCIの環境変数や認証情報でした。保守契約で複数のサイトを預かっている場合、デプロイ用の鍵やサーバーの認証情報がCIにまとまって置かれていることも多いはずです。npmのトークンに限らず、権限が広すぎないか、使っていないものが残っていないかを確かめておく価値はあります。

自社でプラグインやライブラリを公開しているなら、信頼済み公開とステージ公開への移行を検討するよい時期です。承認の手間は増えますが、少人数の現場ほど「誰かのアカウントが一つ破られたら終わり」という状態になりやすく、人の目を一段挟む意味は大きいと感じます。

私たちRESONIXでも、テーマやプラグインの開発にnpmを日常的に使っています。便利な仕組みの上に乗っている以上、その仕組みが変わる方向は追いかけておきたいところです。今回の一連の変更は、自動化を減らすのではなく、自動化の最後に人の判断を戻すという整理の仕方で、ほかのツールにも広がっていきそうな考え方だと思います。