Skip to content

fix(extension): faviconの遅延通知を待ち、取得失敗時はGoogleのサービスにフォールバックする - #564

Open
ujiro99 wants to merge 1 commit into
mainfrom
fix/favicon-fetch-557
Open

ujiro99 wants to merge 1 commit into
mainfrom
fix/favicon-fetch-557

Conversation

@ujiro99

@ujiro99 ujiro99 commented Nov 17, 2026

Copy link
Copy Markdown
Owner

Closes #557

原因

fetchIconUrl は tabs.onUpdated の status: "complete" を受けた時点で favIconUrl を確認し、無ければ 100ms 後に1回だけ再確認していました。

検証用拡張機能で onUpdated を計測したところ、Chrome は読み込み完了後に favicon をダウンロードし、その完了後に別イベントで favIconUrl を通知しており、complete 時点で favIconUrl が入っているケースは1件もありませんでした。

サイト complete → favIconUrl 通知の遅延
movlyhub.com(favicon 465KB) 50〜114ms
seenr.app 12〜260ms
youtube.com 40〜150ms
imdb.com 200〜216ms

成否は favicon のダウンロード時間次第で、キャッシュの無いサイトや大きな favicon のサイトでは失敗し、ICON_NOT_FOUND が保存されていました。タイムアウト(5秒)や Cloudflare のチャレンジは原因ではありませんでした。

変更内容

  • complete 後も最大 3 秒 onUpdated を監視し、favIconUrl が届いた時点で確定する
  • タイムアウト・取得失敗時は ICON_NOT_FOUND ではなく Google favicon サービス(getGoogleFaviconUrl)の URL を返す
    • 検索 URL の %s やクエリが混ざらないよう、オリジンのみを encodeURIComponent して渡す
    • 問題の2サイトとも s2 で実アイコンが取得できることを確認済み
  • windows.create の解決前に他タブ等の onUpdated が来ると、リスナーが外れて必ずタイムアウトになる潜在バグを修正(作成直後に tabs.get で状態を補完)
  • ユニットテスト chrome.fetchIconUrl.test.ts(FI-01〜09)、getGoogleFaviconUrl のテスト(GF-01〜02)を追加

未対応(別途検討)

  • 既に ICON_NOT_FOUND で保存済みのコマンドは、検索 URL を再入力すれば再取得されますが、自動補完はしていません

テスト

  • yarn test(extension): 138 files / 1992 tests pass
  • tsc --noEmit, yarn lint: エラーなし

🤖 Generated with Claude Code

https://claude.ai/code/session_01Pd1sH4nCJL33ibMb6Cy6p5

Chrome reports `favIconUrl` in a separate onUpdated event after the page
load completes, once the favicon download finishes. fetchIconUrl only
retried once 100ms after `complete`, so sites with large or uncached
favicons (e.g. movlyhub.com, seenr.app) always failed and the command was
saved with the placeholder icon.

- Keep listening for up to 3s after `complete` for favIconUrl
- Fall back to the Google favicon service on timeout or failure
- Stop removing the listener when an event arrives before the window
  is created, and catch up via tabs.get instead

Refs #557

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

claude Bot commented Nov 17, 2026

Copy link
Copy Markdown

レビュー結果

favicon の遅延通知を onUpdated で待つ、という原因分析と修正方針は妥当です。windows.create 解決前のイベントで listener が外れるバグも、tabs.get での補完で解消できています。リスナー解除・タイマー解除・ウィンドウ close を finally に集約した構造も読みやすいです。テスト (FI-01〜09, GF-01〜02) も境界ケースまで揃っています。以下は確認・検討してほしい点です。

検討事項

  1. fetchIconUrl が reject しなくなった影響 (packages/extension/src/services/chrome.ts:136-140)

    • 以前はタイムアウトや取得失敗で reject され、faviconContextProvider.tsx:48-53 の catch から FaviconEvent.FAIL が発火して CommandEditDialog.tsx:515 で ICON_NOT_FOUND が設定されていました。
    • 今後は FAIL 経路にほぼ到達しません。ネットワーク不通やサイト自体の不在でも Google の汎用アイコンが保存されます。
    • 意図した仕様ならそのままで構いません。その場合は ICON_NOT_FOUND 経路が実質デッドコードに近くなる点を、コメントか PR 説明に残すと親切です。
  2. favicon が loading 中に届いた場合の待ち時間 (chrome.ts:90-100, FI-07)

    • status !== "complete" のときは latestFavIconUrl を保持するだけで settle しません。そのため complete が来ない場合は 5 秒のロードタイムアウトまで待ちます。
    • 動作は正しく、FI-07 でも検証されています。ただし体感待ち時間が延びるので、仕様として意図したものか確認してください。
  3. failsafe の判定基準 (chrome.ts:43-49)

    • 1000 バイト超の URL は常に Google サービスへ置き換えます。これは従来どおりです。
    • 今回 getGoogleFaviconUrl(url) に変わり、origin のみを渡すようになりました。これは改善です。
    • ただし「長い http(s) URL」も data URL と同様に置き換わる点は変わっていません。
  4. getGoogleFaviconUrl の非絶対 URL の扱い (packages/extension/src/lib/favicon.ts:44-52, GF-02)

    • 絶対 URL でない場合は %s やクエリを含んだままエンコードして渡します。
    • fetchIconUrl に渡る URL は isUrl で検証済みなので実害は小さいです。
    • 余裕があれば、https:// を補う、またはホスト部だけを取り出すなどの処理を検討してください。
  5. テストの vi.stubGlobal("chrome", {...chrome, ...}) (chrome.fetchIconUrl.test.ts:28-42)

    • chrome をスプレッドで複製しています。beforeEach で addListener のモックを差し替える際は元のオブジェクトを参照しています。
    • 現状は問題ありませんが、setup 側の chrome の形が変わると壊れやすくなります。chrome.tabs.get / windows.* を直接 vi.mocked で差し替える方が堅牢です。

軽微な指摘

  • chrome.ts:100-102: faviconTimer は一度設定されると clearTimeout 以外でリセットされません。現状は settle が冪等なので問題ありません。
  • 既存コマンドの ICON_NOT_FOUND を自動補完していない点は PR 説明のとおり別対応で問題ありません。Issue 化しておくと追跡しやすくなります。

セキュリティ・パフォーマンス

  • 外部へ渡す情報は origin のみで、encodeURIComponent もされています。検索クエリが漏れない点は良いです。
  • 最大待ち時間は 5 秒 + 3 秒です。ウィンドウは finally で確実に close されます。

指摘は軽微なものが中心で、全体として approve 相当です。

@codecov

codecov Bot commented Nov 17, 2026

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 98.64865% with 1 line in your changes missing coverage. Please review.
✅ Project coverage is 61.54%. Comparing base (9d2beb0) to head (0511d88).

Files with missing lines Patch % Lines
packages/extension/src/services/chrome.ts 98.48% 1 Missing ⚠️
Additional details and impacted files
@@            Coverage Diff             @@
##             main     #564      +/-   ##
==========================================
+ Coverage   61.29%   61.54%   +0.24%     
==========================================
  Files         311      311              
  Lines       31273    31299      +26     
  Branches     3683     3709      +26     
==========================================
+ Hits        19170    19262      +92     
+ Misses      12103    12037      -66     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

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.

ユーザー追加の検索コマンドでfaviconが取得できず、ポップアップにアイコンが表示されない

1 participant