沒穿方服

「Navigate」的中文翻譯

另一個難題是 navigate 中文要翻成什麼。

一般翻成「瀏覽」、「導覽」，或「導航」，但缺乏上下文時都太曖昧。

參考 Windows 翻譯（檔案總管用的，IE 概念上就是 explorer 的延伸，所以音效也一樣）是用「開始瀏覽」和「導覽開始」，其實也看不懂。

Firefox DevTools 的翻譯是「導航」：

我最後使用「瀏覽導航」，作為事件選項之一感覺還可以。

Navigate 具體發生時機

應用樣態多元，所以使用者其實不太能預期發生時機。

不如現在就安裝 Noise，搭配不同 navigationType 設定不同音效，在日常生活中慢慢認識它。

Noise 4.2.0 新功能「Multiple Sounds」

可以在事件上綁定「多個」聲音，可選擇是否隨機播放。

安裝 Noise：

• 🦊 Firefox 擴充套件
• Chrome 線上應用程式商店

註：套件裡面「沒有提供」影片中的聲音檔，要自己去生喔。

我沒有全部看懂，但湊出一個 format 能夠將 URL 中的 fbclid 和 utm_source 等追蹤碼去掉：
${linkSrcUrl.replaceAll('[?&](fbclid|utm_\w+)=[^&#]+','')}

---

設定介面也很難懂，瘋狂科學家風格

• 
• 

userChrome.css 內容

用法是到 about:config 開啟 toolkit.legacyUserProfileCustomizations.stylesheets，然後到 Profile 資料夾自己新增 chrome/userChrome.css 檔案。

主要策略是用 CSS color-mix() 把預設背景色調暗。 另外有把關閉按鈕拿掉，內容如下：

2026-06-20: Firefox 152 更新了定義，新版為：

.tab-background {
  &:is([selected], [multiselected]) {
    background-color: color-mix(in srgb, var(--tab-background-color-selected) 70%, black) !important;
  }
}

.tabbrowser-tab[selected] .tab-close-button {
  color: white !important;
}
.tabbrowser-tab[selected]:not(:hover) .tab-close-button {
  display: none !important;
}

以下為舊版，已經沒用了。

.tabbrowser-tab[selected] .tab-background {
  background-color: color-mix(in srgb, var(--tab-selected-bgcolor) 70%, black) !important;
}

.tabbrowser-tab[selected] .close-icon {
  color: white !important;
}
.tabbrowser-tab[selected]:not(:hover) .close-icon {
  display: none !important;
}

增加音效或許不是完善解方，但在很多情況下也夠用了。

可以用的值

新增的 accessibility.typeaheadfind.wrappedSoundURL 設定和 Accessibility.typeaheadfind.soundURL 類似，具體可用的值為：

• 空字串（預設值）
  不會出聲，跟舊版行為相同
• 字串 beep
  發出系統嗶聲，跟舊版「找不到指定文字」的音效相同
• 字串 default
  發出古代 Firefox 的預設音效，很像屁聲，這不是我亂加的，是原始行為
• 指向 WAV 聲音檔的路徑
  因為底層是用 nsISound 實作所以只支援 wav。 格式必須是 file URI，也就是以 file:// 開頭，不確定的話可以把音檔拖進瀏覽器，再複製網址列的文字即可

這個功能我等了七年

其實最早在 2008 年寫的擴充元件 Noise 裡就有實作這個功能，但隨著 Firefox 57（2017/11/14）改變架構讓 XPCOM 套件全滅，接下來就一直沒有替代方案，在長文研究時真的很痛苦。

2024 六月處理了一個 findbar bug，其實也是為這個音效做準備，這次一個 commit 就結案，只是等待 review 推進也是拖了一個月。

這個行為在 Chrome 也是一樣，但好像無解，只有 Firefox 可以用 about:config 改掉：

layout.word_select.eat_space_to_next_word 改成 false就可以了，參考。

---

其他跟選取空白有關的選項：

• layout.word_select.stop_at_punctuation

  不要包含標點符號，預設 true。

• layout.word_select.stop_at_underscore

  不要包含底線，預設 false。

• editor.word_select.delete_space_after_doubleclick_selection

  編輯文字時，點兩下選取後再刪除，會把字前後的空白也刪掉，若不是點兩下選取就沒有效果，預設 false。
  參考 Bug 由來。

安裝到能 build 起來已經不容易

官方說明（Firefox Source Docs）其實很不錯，更快的方式應該是找 mentor 或在 chat 問路，但我還是先自己試試。
文件：Getting Set Up To Work On The Firefox Codebase

Windows 下會教你用 MozillaBuild 安裝，會建立專用的 shell 設好獨立環境，缺點是會跟本來慣用的 shell 切開，有些東西像 git 也是另外裝一套，但確保跑得起來是第一優先啦，不做抵抗。

具體就是以下指令跑成功，該裝的就裝完了：
python3 bootstrap.py --vcs=git

但初期我還遇到 build script / 原始碼有些檔案沒處理好 python open 編碼的問題，也是追了一下。

然後 git pull 之後就能建自己的 Firefox 了：

./mach build ./mach run

在 WSL 跑 hg-git 慢到不行

WSL 遇過在 Windows 目錄跑執行檔會突然變超慢的問題（參考，把執行檔搬到 WSL 目錄竟然就沒事了），用前面裝的環境就剛好迎面撞上。

另 Firefox 原始碼還是用 Mercurial 做版本控制，如果要用 git 就要裝 hg-git 來中介，加上原始碼規模不小，結果一些 git 指令都要等非常久，久到中間一定要做別的事才行。

好用的 SearchFox

Mozilla 的程式碼搜尋，還支援 blame，重點是真的快。
https://searchfox.org/

哪那麼多 Findbar 呀

2008 年寫過 Firefox 3.0 的擴充套件，當時也改過 Findbar，記得 XUL 原始碼只有 gBrowser 裡面有 findbar，很輕鬆就能變造它的外觀和行為。

現在就不一樣了，tabbrowser（全域的 gBrowser）裡面有從某處初始化 findbar 的邏輯，widgets/browser-custom-element 裡面有視情況建立 FinderParent (remoteBrowser 時) 或一般 Finder (non-remote) 的分歧， 然後 PDF 的 viewer 模組裡又有自己的 findbar，這東西還有部分是從 pdfjs repo 不定期複製過來的，……各種各種。

這邊 trace code 和認識多年來的架構變更、引進概念（例如 fission 是什麼、modalHighlight 是什麼）也是個門檻。 還好 findbar 是相對冷門的功能，本身變動沒有很多。

Phabricator 協作平台

類似工具我之前主要是用 GitLab，還是第一次知道 Phabricator（音同 fabricator），配合 moz-phab 這個指令用起來很方便。

除了 Phabricator 本身有很多協作功能外，在 commit message 和遠端 branch 管理方面也可以省很多心力， 因為新的 branch 在用 moz-phab push 時就會自動生成對應的 Differential 頁面（跟本來的 branch name 已經無關），並把訊息塞到 commit message， 之後如果 review 來回要做 force push 也沒關係，只要在 commit message 保留 Differential Revision: .../D215196 這段文字，所有記錄就會回到同一頁，reviewer 也能看到你硬改了哪些東西。

Random fail 的測試

推上 Phabricator 的東西並不會跑所有測試，我這次接觸到的 CI 主要在程式要 land（類似所謂 merge 進主線）的時候，會由有權限的人 Pushing to Try，我才上去看測試死在哪，例如這具屍體。

之前工作時很頭痛的 random fail 問題，或稱 intermittent test / flaky test，就是平常跑都會過，偏偏就偶爾會死掉卡住 CI，這種要找出死因可能很花時間，於是常常不了了之。

這邊見識到 Firefox 的作法是有一個小組會去抓出案例，研究後登記起來，也提供查詢： Sheriffed intermittent failures。

然後跑測試時有一個 verify flag，對特定測試重複跑很多次，判斷是 intermittent 還是真的錯誤。

用 chat 求助

其實這個 bug 真正實作和討論的時間並不長，中間拖比較久是 reviewer 擺著，最後在 chat 求助才有人幫 land。

Extension API 的 Find API

原來跟瀏覽器的 findbar 根本沒關係呀！

之前一直想動 Findbar，很想從這裡下手，仔細研究才看懂走不通。