Skip to content

fix(extension): Vivaldi でサイドパネル表示モードが動作しない問題を修正 - #560

Open
ujiro99 wants to merge 7 commits into
v1.4.2from
fix/vivaldi-side-panel
Open

ujiro99 wants to merge 7 commits into
v1.4.2from
fix/vivaldi-side-panel

Conversation

@ujiro99

@ujiro99 ujiro99 commented Nov 15, 2026 •

Copy link
Copy Markdown
Owner

概要

Vivaldi で結果をサイドパネルに表示しようとすると、ERR_FILE_NOT_FOUND になる問題を修正します(サポート問い合わせ。Vivaldi 8.3.4191.44 / Selection Command 1.4.1)。

原因

chrome.sidePanel.setOptions({ path }) に外部 URL(https://...)をそのまま渡していました。path は仕様上、拡張パッケージ内のリソースを指定するものです。

ブラウザ path に外部 URL を渡した場合 拡張ページから外部 URL への移動
Chrome URL として解決され、表示される(仕様外の挙動) 止められる(エラーも出ない)
Vivaldi 拡張のオリジンの後ろに連結され chrome-extension://<id>/https://... → ERR_FILE_NOT_FOUND 許可される

対応

サイドパネルではまず拡張内の中継ページ(src/side_panel_relay.html)を開き、そこから表示先 URL に切り替えます。

  • 中継ページはまず chrome.tabs.getCurrent() でサイドパネルがタブとして扱われているかを調べます。Vivaldi ではタブが返り、Chrome では undefined が返ります。
    • タブとして扱われている場合(Vivaldi): location.replace(url) で自分で移動します。
    • タブではない場合(Chrome など): Service Worker に sidePanelRelayFallback を送り、Service Worker が path に URL を直接設定します。
  • 直接設定できることが分かったら、その結果を chrome.storage.local(sidePanelDirectUrl)とメモリに保存します。2 回目以降は中継ページを経由せず、従来どおり直接設定します。つまり Chrome で中継ページを経由するのは、基本的に最初の 1 回だけです。
    • sidePanel.open() をユーザー操作の扱いのまま呼ぶ必要があり、setOptions は同期的に呼ばなければなりません。そのため判定結果は Service Worker 起動時にメモリに読み込んでおきます。
    • 判定結果は setOptions が成功した後にだけ保存します。失敗しても直接設定モードに固定されることはありません。
    • 保存する値は判定したときの navigator.userAgent です。ブラウザが更新されて userAgent が変わったら判定をやり直します(Chrome ではメジャーバージョンの更新時)。
    • 既知の制限: 判定結果の読み込みは非同期のため、Service Worker が停止から起動した直後に開いた場合は Chrome でも中継ページを経由します。この場合もフォールバックで最終的に表示されるので、許容しています。
  • sidePanelRelayFallback は、送信元が自分の拡張の中継ページ(クエリと # 以降を除いて完全一致)で、URL が http(s)、tabId が正の整数の場合にだけ受け付けます。
  • 前提: サイドパネルがタブとして扱われないブラウザは、Chrome と同じく path に外部 URL を受け付けるとみなしています。確認したのは Chrome と Vivaldi だけで、Edge / Brave / Opera などは未確認です。

Vivaldi でサイドパネルのページアクションが動かない問題

Vivaldi ではサイドパネルがタブとして扱われるため、サイドパネル内の content script が Service Worker に接続するときにも sender.tab が付きます。Service Worker の onConnect は「sender.tab が無い接続 = サイドパネル」という前提で振り分けていたので、通常のタブとして登録するだけで、実行待ちのステップ(PA_SIDE_PANEL_PENDING)を実行していませんでした。エラーにはならず、何も起きないだけでした。タブの情報(active、index、windowId など)は裏で開いている普通のタブと区別がつかないため、次の方法で見分けます。

  • 中継ページは、タブとして扱われている場合(Vivaldi)、移動する前に registerSidePanelHostTab を Service Worker に送り、自分のタブ ID をサイドパネルのタブとして登録します。登録の完了を待ってから移動します。
  • Service Worker は、送信元が自分の拡張の中継ページであることを確かめたうえで sender.tab.id を登録します。Service Worker が停止しても消えないよう、session storage(sidePanelHostTabs)にも保存し、タブが閉じられたら登録を消します。
  • onConnect は、登録済みのタブからの接続をサイドパネルの接続として handleSidePanelConnect に回します。このとき connectedTabs には登録しません。登録すると、navigate ステップでページが移動した後に content script が再接続しなくなるためです。

これで、サイドパネルで開く PageAction と AI サービスのコマンド(どちらも PA_SIDE_PANEL_PENDING を使う)が Vivaldi でも動くようになります。

タイムアウトで判定しなかった理由: Chrome では移動を止められても何のシグナルも出ません。Navigation API の committed / navigateerror も発火しません。タイムアウトで判定すると、Vivaldi で表示に時間がかかるサイト(Gemini など)を「移動できなかった」と誤判定してしまいます。

動作確認

ヘッドレス起動のブラウザで、ビルド済みの拡張を読み込んで確認しました。どちらのブラウザでも、サイドパネルの表示先が http://127.0.0.1:8765/target.html になることを確認しています。

  • Chrome(Playwright 付属 Chromium): 1 回目は中継ページから直接設定に切り替わり、2 回目は直接設定で表示される
  • Vivaldi 8.3.4191.44(Linux 版): 1 回目、2 回目とも中継ページ経由で表示される
  • 修正前の方式では、Vivaldi でサイドパネルの URL が chrome-extension://<id>/http://... になることを再現(問い合わせ内容と一致)
  • yarn test / yarn lint が通る(lint は既存の warning のみ)
  • Windows 版 Vivaldi で、Gemini などの実サービスを使って表示されることを確認
  • Chrome の通常起動(ヘッドあり)で、初回に表示がちらつかないことを確認
  • Vivaldi で chrome.tabs.getCurrent() が毎回タブを返すことを確認(5 回)。Chrome では undefined になりフォールバックに進むことも確認
  • Vivaldi で、サイドパネルで開く PageAction が動作することを確認

補足・未対応

  • Vivaldi ではサイドパネル内のコンテンツスクリプトにも sender.tab が付きます。そのため isSidePanel() は「サイドパネルではない」と判定し、useSidePanelNavigation によるリンクの横取りは働きません。ただし Vivaldi ではサイドパネル内の通常の遷移がそのまま動くので、実害はないと考えています。
  • サイドパネルを使うページアクションは、上記「Vivaldi でサイドパネルのページアクションが動かない問題」で対応しました。isSidePanel() の判定は、このPRでは対象外としています。

🤖 Generated with Claude Code

https://claude.ai/code/session_01Pd1sH5ArKQDueJGVC1vMCK

Vivaldi appends an absolute URL passed to chrome.sidePanel.setOptions({ path })
to the extension origin, so the side panel showed ERR_FILE_NOT_FOUND
(chrome-extension://<id>/https://...). Chrome resolves it as a URL instead,
but blocks a side panel extension page from navigating to a web URL.

Open a relay page bundled with the extension first. When the side panel is
hosted as a tab (Vivaldi), it navigates to the target URL by itself.
Otherwise (Chrome), it asks the service worker to set the URL as the path
directly, and the result is cached so later opens skip the relay page.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Pd1sH5ArKQDueJGVC1vMCK
@ujiro99

ujiro99 commented Nov 18, 2026

Copy link
Copy Markdown
Owner Author

@copilot resolve the merge conflicts in this pull request

# Conflicts:
#	packages/extension/src/service_worker.ts

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>

Copilot AI commented Nov 18, 2026

Copy link
Copy Markdown
Contributor

@copilot resolve the merge conflicts in this pull request

main をマージし、service_worker.ts の競合を解消しました。マージコミットは 148282b です。

@ujiro99
ujiro99 changed the base branch from main to v1.4.2 November 19, 2026 03:21
- Store the user agent instead of a boolean when the direct URL mode is
  detected, and ignore the cached result on a different browser version,
  so that the mode is detected again if the browser behavior changes.
- Persist the detection result in parallel with setOptions so that showing
  the page is not delayed by the storage write.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@ujiro99
ujiro99 marked this pull request as ready for review November 19, 2026 07:25
@claude

claude Bot commented Nov 19, 2026

Copy link
Copy Markdown

レビュー結果

Vivaldi で path に外部 URL を渡すと壊れる問題に対して、中継ページ方式で対応する設計です。原因の切り分けも、タイムアウトで判定しない理由も PR 本文で説明されています。判定結果をメモリに保持して setOptions を同期的に呼ぶ点も、user gesture の制約に合っています。ブロッカーになる問題は見つかりませんでした。以下は改善提案です。

良い点

  • sidePanelRelayFallback(packages/extension/src/action/helper.ts:312-333)が、送信元の ID と URL、http(s) の URL、整数の tabId を検証しています。許可する範囲が狭く、javascript: などの任意スキームへ飛ばされる心配もありません。
  • sidePanelUrl.ts は責務が分かれていて、コメントも丁寧です。__test による状態リセットも用意されています。
  • ユーザーエージェントをキーにして判定結果をキャッシュしているので、ブラウザ更新後は再判定されます。

指摘・提案

  1. Service Worker 再起動直後は毎回中継ページを経由する可能性があります(UX・パフォーマンス)
    packages/extension/src/service_worker.ts:36 の initSidePanelUrlMode() は await されません。内部では Storage.get を待つ非同期処理です。Service Worker が idle で停止した後、アクションのクリックで起動した場合は、directUrlSupported の読み込みが終わる前に openSidePanel が toSidePanelPath を呼ぶ可能性があります。chrome.ts:666 は同期呼び出しが必須で、この時点では値が false のままです。
    その場合は Chrome でも中継ページを経由します。中継ページ → フォールバック → setOptions と進むため、2 回目以降でも表示のちらつきや読み込みが二重に発生し得ます。PR 本文の「ちらつかない」確認は、Service Worker が起動したままの状態だったのではないでしょうか。
    chrome.storage.session などを使って起動時の読み込みを速める方法や、openSidePanel 側で読み込み完了を待てる範囲を検討する余地があります。ただし await すると user gesture が切れるため、難しい面もあります。この制限を PR 本文かコードコメントに明記してください。Service Worker を停止させた状態で確認するとよいです。

  2. tabId の検証が緩くなっています

    • packages/extension/src/side_panel_relay.ts:19 の Number(params.get("tabId")) は、パラメータが無い場合に 0 になります。Number.isInteger(0) は true なので、helper.ts:326 の検証をすり抜けます。
    • 中継ページで Number.isInteger(tabId) && tabId > 0 などの確認を追加してください。サービス側でも tabId > 0 を見ると堅くなります。
    • 同様に、sender.tab が無い(サイドパネル内)ことの確認や、実在するタブかの確認があると、より安全です。
  3. テストの不足

    • side_panel_relay.ts のテストがありません。tabs.getCurrent() がタブを返す場合は location.replace を呼ぶこと、返さない場合は Ipc.send を呼ぶこと、URL が不正な場合は何もしないことを、__tests__/ に追加するとよいです(docs/design/test/testing.md の方針)。
    • packages/extension/src/action/__tests__/helper.test.ts の sidePanelRelayFallback に、tabId が非整数の場合や sender.id が異なる場合のケースがありません。HSR-02 は sender.url が異なる場合だけを見ています。
    • setSidePanelUrlDirectly で setOptions が失敗した場合のテストもありません。
  4. initSidePanelUrlMode の競合回避ロジック(sidePanelUrl.ts 付近)
    directUrlSupported = directUrlSupported || (...) は意図どおりです。ただし、markDirectUrlSupported が先に走って Storage.set が失敗した場合は、メモリ上だけが true になり、保存はされません。次に Service Worker が起動したときは再判定になるため、動作上は問題ありません。この挙動は警告ログだけで済ませてよいか、念のため確認してください。

  5. 軽微な点

    • chrome.ts:725-730 の updateSidePanelUrl で、非直接モードのままサイドパネルの中継ページが開いている状態から再度 setOptions すると、中継ページが再読み込みされます。Vivaldi では毎回この経路を通るため、ページ内遷移の度にちらつく可能性があります。実機で確認済みであれば問題ありません。
    • side_panel_relay.html は /src/side_panel_relay.ts を絶対パスで読み込んでいます。既存の onboarding_page.html と同じ書き方か確認してください。
    • 他のブラウザ(Edge、Brave、Opera など)は Chrome と同じ経路になる前提です。本文にも未確認と記載されているので、リリースノートなどで周知するとよいです。

セキュリティ

  • 中継ページが受け取る URL は http(s) のみで、Service Worker 側でも再検証されています。この点は問題ありません。
  • sender.url.startsWith(relayUrl) は、getURL が拡張のオリジンを含むため、他オリジンからは成立しません。

全体として、方針も実装も妥当だと考えます。1 の Service Worker 再起動時の挙動を確認し、2 と 3 を対応すれば、マージして問題ないと思います。

- Reject a missing, empty or non-positive tabId in both the relay page and
  the service worker fallback handler.
- Export relay() from the relay page so that it can be tested, and add
  tests for the relay page, sender/tabId validation and setOptions failure.
- Document that a side panel opened right after the service worker wakes up
  may still go through the relay page.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@ujiro99

ujiro99 commented Nov 19, 2026

Copy link
Copy Markdown
Owner Author

レビューありがとうございます。14a5268f で対応しました。

1. Service Worker 再起動直後に中継ページを経由する

修正はせず、既知の制限として受け入れます。この場合も中継ページ → フォールバック → setOptions({ path: url }) と進み、最終的には main と同じ処理でページが開きます。悪くなるのは、中継ページが一瞬見えることと読み込みが 1 回増えることだけで、UX として許容できると判断しました。ストレージの読み込みを await すると user gesture が切れるため、制限とその理由を sidePanelUrl.ts の directUrlSupported のコメントに明記しました。

2. tabId の検証

  • isValidTabId(正の整数かを確認する関数)を sidePanelUrl.ts に追加し、中継ページと sidePanelRelayFallback の両方で使うようにしました。
  • 中継ページでは、tabId が無いか空のときは 0 ではなく不正な値として扱います。
  • Vivaldi のように中継ページが自分で移動する場合は tabId を使わないので、確認はフォールバックを送る直前で行っています。
  • sender.tab や実在するタブの確認は、送信元の拡張 ID と中継ページの URL を既に確認しているため追加していません。

3. テストの不足

  • src/__tests__/side_panel_relay.test.ts を追加しました。テストできるように、中継ページの処理を relay(search, navigate) として export する形にしています。確認している内容は次のとおりです。
    • タブなら自分で移動する
    • タブでなければフォールバックを要求する
    • URL や tabId が不正なら何もしない
  • helper.test.ts に 2 つ追加しました。
    • HSR-04: sender.id が違う場合は無視する
    • HSR-05: tabId が 0 / -1 / 1.5 / NaN の場合は無視する
  • chrome.sidePanel.test.ts に CSP-SD-03 を追加しました。setOptions が失敗したら reject することを確認します。

4. Storage.set が失敗した場合

次の起動で判定し直すだけで動作に問題はないため、今の警告ログのままにしています。

5. 軽微な点

  • side_panel_relay.html の読み込み方は、既存の onboarding_page.html と同じ /src/... の絶対パスです。
  • Vivaldi で chrome.tabs.getCurrent() が毎回タブを返すことは、実機で 5 回試して確認しました。Chrome では undefined が返ってフォールバックに進むことも確認済みです。
  • サイドパネル内の URL を更新するたびに Vivaldi でちらつくかは、引き続き実機で確認します。

拡張機能の全テスト 2,027 件、型チェック、lint は通っています。

🤖 Generated with Claude Code

@claude

claude Bot commented Nov 19, 2026

Copy link
Copy Markdown

レビュー結果

Vivaldi での ERR_FILE_NOT_FOUND に対する修正として、中継ページを使う方針は妥当です。原因と対応の説明も丁寧で、tabId / URL スキーム / 送信元の検証、テストの厚さも良いです。気になる点を重要度順に挙げます。

指摘事項

  1. 直接指定モードの判定が setOptions の成否と無関係に永続化される
    packages/extension/src/services/chrome.ts の setSidePanelUrlDirectly で、markDirectUrlSupported() と chrome.sidePanel.setOptions() を Promise.all で並列実行しています。setOptions が失敗してもフラグはメモリと storage に保存されます。そのため、以降の呼び出しはすべて中継ページを経由せず、表示できないまま固定される恐れがあります。UA が変わるまで自己回復しません。
    修正案: setOptions の成功後に markDirectUrlSupported() を呼ぶ。ちらつき対策で並列にしている意図は理解しますが、永続化だけでも成功後にする方が安全です。
    chrome.test の CSP-SD-03 は reject を確認するだけです。このとき markDirectUrlSupported が呼ばれていないことも確認すると良いです。

  2. 「tabs.getCurrent() が undefined なら直接指定できる」という推定
    packages/extension/src/side_panel_relay.ts:36-47 で、Chrome 以外のブラウザ(Edge や Brave など)でも「タブではない = 外部 URL を path に直接渡せる」とみなしています。この前提が崩れるブラウザでは、1 回目に直接指定が失敗しても成功扱いで永続化されます(指摘 1 と同じ経路)。実機確認が Chrome(Chromium) と Vivaldi のみなので、前提と対象ブラウザを PR 本文かコメントに明記してください。

  3. サービスワーカー起動直後の取りこぼし(既知の制限)
    packages/extension/src/services/sidePanelUrl.ts:41-52 の initSidePanelUrlMode は非同期です。起動直後は直接モードでも中継ページを経由し、Chrome ではちらつきが出る場合があります。コメントで明記されており許容範囲です。頻度が高いなら、chrome.storage.session など同期的に使える手段の検討余地があります。

  4. 中継ページが無言で空白になる
    side_panel_relay.ts:30-33, 42-45 で、URL や tabId が不正な場合は console.warn だけで終了し、ユーザーには空白のパネルが表示されます。通常は到達しませんが、簡単なエラー文言の表示があるとサポート時に原因を切り分けやすくなります。

  5. テスタビリティ(軽微)
    side_panel_relay.ts:55-57 に import 時の副作用(relay(location.search, ...) の即時実行)があります。relay を export してテストしている点は良いのですが、import するたびに実行されます。location.search が空だと warn が出るので、テスト側でモックしているか確認してください。エントリ用の薄いファイルと分離するのが理想です。

  6. UA 全文をキーにする点(軽微)
    sidePanelUrl.ts の detectedUserAgent === navigator.userAgent は、Chrome のようにマイナーバージョンが固定される UA では、メジャー更新時のみ再判定になります。意図通りなら問題ありませんが、その旨をコメントにしておくと親切です。

セキュリティ

  • sidePanelRelayFallback(packages/extension/src/action/helper.ts)は sender.id と sender.url の前方一致、http(s) 限定、tabId の整数検証を行っており妥当です。startsWith(relayUrl) は src/side_panel_relay.html の後ろに別パスが続く場合も許容します。将来的に近い名前のページを追加するなら、new URL(sender.url).pathname の厳密比較にしておくと安全です。
  • 中継ページが受け取る URL は拡張自身が生成したものなので、オープンリダイレクトのリスクは低いです。

テスト

ユニットテストは分岐を網羅しており十分です。上記 1 の「失敗時に永続化しない」ケースのテストを追加することをお勧めします。

全体としては、指摘 1 の修正を済ませればマージして問題ないと考えます。

- Persist the direct URL mode only after setOptions succeeds, so that a
  failure does not lock later calls into the direct mode.
- Accept the relay fallback only from the exact relay page path.
- Move the relay logic to services/sidePanelRelay.ts so that importing it
  has no side effects, and keep side_panel_relay.ts as a thin entry point.
- Document the assumption that non-tab side panels accept a web URL as
  path, and that Chrome re-detects only on major updates.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@ujiro99

ujiro99 commented Nov 19, 2026

Copy link
Copy Markdown
Owner Author

2 件目のレビューありがとうございます。502ef32a で対応しました。

1. setOptions の成否と無関係に判定が保存される

setSidePanelUrlDirectly を、setOptions が成功した後にだけ markDirectUrlSupported() を呼ぶ形に変えました。保存はページを設定した後に行うので、表示が遅れることはありません。CSP-SD-03 には、失敗した後の次回は中継ページを使うことの確認を追加しました。

setOptions が成功しても、ページが実際に表示できたとは限りません。表示できたかの確認(例: サイドパネルの content script からの接続が来たか)までは、今回は入れていません。

2. 「タブでない = 直接設定できる」という前提

前提と、Chrome と Vivaldi でしか確認していないこと(Edge / Brave / Opera などは未確認)を、sidePanelUrl.ts 冒頭のコメントに明記しました。

3. Service Worker 起動直後の判定漏れ

前回のコメントのとおり、既知の制限として受け入れます。

4. 不正なパラメータのときにパネルが空白になる

拡張機能が自分で組み立てた URL では起きず、中継ページを手で開いた場合にしか起きません。エラー文言を出すには多言語対応も必要になるため、今回は見送りました。

5. import 時の副作用

中継の処理を src/services/sidePanelRelay.ts に分け、src/side_panel_relay.ts はそれを呼ぶだけのエントリファイルにしました。テストは src/services/__tests__/sidePanelRelay.test.ts に移しています。import しても処理が動かなくなりました。

6. userAgent をキーにする点

Chrome の userAgent にはメジャーバージョンしか含まれないため、判定をやり直すのはメジャー更新のときだけです。意図どおりなので、その旨をコメントに書きました。

セキュリティ: 送信元 URL の確認

startsWith での前方一致をやめ、クエリと # 以降を除いた URL が中継ページと完全に一致するかで確認するようにしました。HSR-06 では、side_panel_relay.html.evil のような似たパスからの要求を無視することを確認しています。

拡張機能の全テスト 2,030 件、型チェック、lint は通っています。

🤖 Generated with Claude Code

@claude

claude Bot commented Nov 19, 2026

Copy link
Copy Markdown

レビュー結果

Vivaldi の ERR_FILE_NOT_FOUND に対する原因分析が明確で、中継ページ方式、sender 検証、http(s) 限定、directUrlSupported を Service Worker 起動時にメモリへ読み込む設計(ユーザー操作を維持するため)はよく考えられています。テストも充実しています。以下は懸念点と提案です。

要確認・改善提案

  1. 「タブでなければ直接指定可能」という推定の誤検出が永続化される (packages/extension/src/services/sidePanelRelay.ts:38-46, packages/extension/src/services/chrome.ts:762-768, packages/extension/src/services/sidePanelUrl.ts:67-80)
    chrome.tabs.getCurrent() が undefined を返すだけで setSidePanelUrlDirectly → markDirectUrlSupported が走り、sidePanelDirectUrl に UA が保存されます。Vivaldi で getCurrent() が一時的に undefined を返した場合や、Edge / Brave / Opera など未検証のブラウザで path への URL 直指定が効かない場合、ブラウザの更新(UA 変更)まで中継ページが使われなくなり、元の ERR_FILE_NOT_FOUND 状態に固定されます。復旧手段がありません。

    • 提案: 直接指定の成功確認(例: chrome.sidePanel.getOptions({ tabId }) で path が設定値になっているか)の追加、または保存値に有効期限を設ける、失敗時のリセット経路を用意する。
    • 未検証ブラウザについては sidePanelUrl.ts のコメントに記載済みですが、フォールバックの失敗が検知できない点がリスクです。
  2. 初回のみ中継ページ経由になるため Chrome で二重ロードが発生する (packages/extension/src/services/sidePanelUrl.ts:41-50)
    既知の制約として記載済みです。加えて、Service Worker が再起動した直後(initSidePanelUrlMode の非同期読み込み完了前)の操作でも同様になります。ServiceWorkerData.init() と同様に、読み込み完了を待たずに済む chrome.storage.session などの同期的なキャッシュは難しいため、許容範囲と考えます。ただし、中継ページは <body> が空なので、ネットワークが遅い場合に白画面が見えます。ローディング表示の追加を検討してください。

  3. sidePanelRelayFallback の tabId がサイドパネルの所属タブと一致するか未検証 (packages/extension/src/action/helper.ts:312-338)
    sender は自拡張の中継ページに限定されているため実害は小さいですが、URL クエリの tabId をそのまま信頼しています。sender.tab が付く環境では突き合わせる、もしくは中継ページが自身に渡された tabId のみ送ることを前提とした設計メモを残すと安全です。

  4. Storage.get / initSidePanelUrlMode のレース処理 (packages/extension/src/services/sidePanelUrl.ts:57-62)
    directUrlSupported || ... は期待どおりですが、markDirectUrlSupported の if (directUrlSupported) return により、initSidePanelUrlMode が先に UA 不一致(古いバージョン)を読み込んだ場合でも true 化後は保存が行われます。この動作は問題ありませんが、UA が変わって再検出する際に古い値が上書きされることをテストで明示すると良いです(SPU-IN-04 の後に markDirectUrlSupported を呼ぶケース)。

  5. ページアクション側は未確認 (packages/extension/src/hooks/useSidePanelNavigation.ts, PR 説明の「補足・未対応」)
    useSidePanelNavigation は navigateSidePanel 経由で updateSidePanelUrl → toSidePanelPath を通るため中継が適用されます。Vivaldi で isSidePanel() が false になる件は PR 説明の通り実害が小さそうですが、Vivaldi でサイドパネル内リンクを辿った後に別コマンドで updateSidePanelUrl を呼ぶ経路(中継ページが再度読み込まれる)の動作確認を推奨します。

軽微な指摘

  • packages/extension/src/side_panel_relay.html:15 : 失敗時(console.error のみ、side_panel_relay.ts:4-6)にユーザーへ何も表示されません。簡単なエラーメッセージ表示があると、問い合わせ対応時に原因が分かりやすくなります。
  • packages/extension/src/services/sidePanelUrl.ts:129-135 : isRelayableUrl は引数が null を許容する型ガードで toSidePanelPath からは string で呼ばれます。問題ありませんが、型を string | null | undefined にしておくと sender 由来の値にも使いやすいです。
  • packages/extension/src/action/helper.ts:333 : setSidePanelUrlDirectly(...).catch 後も return false で応答しません。他コマンドと整合していますが、Ipc.send の呼び出し側が応答待ちでハングしないことを念のため確認してください。
  • manifest の web_accessible_resources に中継ページは含まれておらず、これは適切です(Web ページから開かれない)。

テスト

ユニットテストは分岐(Vivaldi/Chrome 判定、sender 検証、似たパス、不正 tabId、UA 変更)を網羅しており良好です。追加するなら次のとおりです。

  • 上記 1 に対応する場合のテスト(直接指定が効かなかったときの復旧)
  • useSidePanelNavigation 経由のエンドツーエンド的なテスト(__tests__ 内)

セキュリティ

http(s) 限定、sender の id と URL の厳密比較(クエリ・ハッシュ除去)、tabId の整数検証は妥当で、懸念は大きくありません。

全体として、方針・実装・テストとも良好です。上記 1 のみ、ブラウザの誤検出が固定化するリスクがあるため、対応を検討してもらえると安心です。

Vivaldi hosts the side panel as a tab, so content scripts in the side panel
connect with sender.tab like normal tabs. The service worker treated them as
normal tabs and never ran the pending side panel page action steps.

- The relay page registers its own tab as a side panel host tab before
  navigating to the target URL.
- onConnect treats connections from registered host tabs as side panel
  connections, and does not add them to connectedTabs so that they reconnect
  after navigation.
- The registrations are kept in session storage and removed when the tab is
  closed.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@claude

claude Bot commented Nov 19, 2026

Copy link
Copy Markdown

レビュー結果

Vivaldi でサイドパネルが ERR_FILE_NOT_FOUND になる問題に対して、中継ページ方式で対処する PR です。原因の切り分けと設計意図が sidePanelUrl.ts の doc コメントによくまとまっています。isRelayableUrl による http(s) 限定、送信元チェック、isValidTabId による検証など、防御面も丁寧です。テストも ID 付きで網羅的に書かれており、プロジェクトの規約に沿っています。

マージをブロックする問題は見つかりませんでした。以下は改善提案と確認事項です。

指摘事項

1. onConnect の await が接続登録の順序に影響する可能性(中)
packages/extension/src/service_worker.ts の onConnect(if (tabId && !(await PageActionServiceWorker.isSidePanelHostTab(tabId))) の行)が対象です。

  • 通常タブの接続でも毎回 isSidePanelHostTab で非同期のストレージ読み込みを待つようになりました。初回はセッションストレージの読み込みが入ります。
  • その間に connectedTabs への追加が遅れます。同じ時間帯に ServiceWorkerData.update を行う他の処理があると、順序が前後する可能性があります。
  • 影響は小さいと考えます。ただ、sidePanelHostTabIds を ServiceWorkerData.init() と同じタイミングで先読みしておくと、通常タブの経路から非同期待ちを減らせます。

2. 中継ページ直接アクセス時の誤登録(低)
packages/extension/src/action/helper.ts の registerSidePanelHostTab と isRelayPageSender が対象です。

  • 検証は送信元 URL が中継ページかどうかだけです。ユーザーが chrome-extension://<id>/src/side_panel_relay.html?url=... を通常タブで開くと、そのタブがサイドパネルのホストとして登録されます。
  • 登録されたタブは connectedTabs に入らなくなります。
  • 悪用の余地は小さいです。ただ、sidePanelRelay.ts で chrome.tabs.getCurrent() が返すタブの windowType や url を使うなど、通常タブと区別できる材料があれば検討する価値があります。

3. Chrome 初回のみ中継ページを経由することについて(情報)

  • packages/extension/src/services/sidePanelUrl.ts の directUrlSupported は初期値が false です。そのため Chrome でも、最初の 1 回は中継ページの読み込みと Service Worker へのメッセージ往復が入ります。
  • 既知の制約としてコメントされており、許容できる範囲です。
  • Chrome でサイドパネルを閉じた直後に sidePanelRelayFallback が届いた場合、setSidePanelUrlDirectly が失敗して console.error だけで終わります。この場合は次回も中継ページ経由になります。動作上は問題ありません。

4. User-Agent をキーにしたキャッシュ(低)
sidePanelUrl.ts の initSidePanelUrlMode と markDirectUrlSupported が対象です。

  • Chrome の UA はメジャーバージョンしか含まないことがコメントに書かれており、認識されている制約です。
  • UA 全文をストレージに保存するのは冗長です。navigator.userAgentData?.brands やハッシュ化した値でもよいですが、現状のままでも問題ありません。

5. unregisterSidePanelHostTab の呼び出し(nit)
service_worker.ts の chrome.tabs.onRemoved 内で、PageActionServiceWorker.unregisterSidePanelHostTab(tabId) を await も .catch もなしで呼んでいます。

  • 内部で例外は握りつぶしているため、実害はありません。
  • ほかの呼び出しと揃えて void を付けるか、.catch を付けると意図が明確になります。

テストについて

  • 追加された sidePanelUrl / sidePanelRelay / serviceWorker-sidePanel / chrome.sidePanel / helper のテストは十分です。
  • 不足: service_worker.ts の onConnect が持つ新しい分岐(ホストタブなら handleSidePanelConnect に回し、connectedTabs に追加しない)に対するテストは、この差分内には見当たりません。ここが今回の挙動変更の要なので、可能なら追加をお勧めします。
  • Vivaldi の実機での確認はヘッドレスでの確認に留まっています。実機での確認が済んでいれば、PR 説明に追記してください。

その他

  • vite.config.ts のビルド入力追加と、SESSION_STORAGE_KEY / LOCAL_STORAGE_KEY の追加は適切です。
  • コメントは英語、PR 説明は日本語で、AGENTS.md の方針に沿っています。

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants