uninstall 從 Extension.js 快取中移除受管理的瀏覽器執行階段。
何時使用 uninstall
- 你想釋出受管理瀏覽器佔用的磁碟空間,因為已不再需要。
- 你想重設某個受管理瀏覽器的安裝,讓下次
install時強制重新下載。 - 你正在清理持續整合(CI)的快取,或切換瀏覽器目標。
標準用法
單一瀏覽器使用位置引數形式:--all 移除所有受管理的瀏覽器目標。
用法
引數與旗標
--all 移除的是與 install --browser all 建立的相同受管理集合:chrome、chromium、edge 與 firefox。
從 4.2.0 之後的版本起,--all 與瀏覽器名稱一起使用,例如 extension uninstall chrome --all,會以 E_ARGS 與狀態 usage 被拒絕,什麼都不會移除。傳入名稱來移除這些瀏覽器,或只傳 --all 來移除每個瀏覽器。
用 --output json 輸出機器可讀結果
--output json 會在 stdout 上印出一個 schema-1 信封:
- 移除成功會印出
status: "uninstalled"幀,並在value中指出目標。 --where會印出status: "located"幀,解析後的路徑放在value.paths。- 移除失敗會印出
ok: false與error.code: "E_BROWSER_UNINSTALL",接著行程以1結束。
value 包含 browsers、all,以及一個 results 陣列,每個目標一項。每一項有 browser、removed、path(檢查過的受管資料夾)與 outcome:
從 4.2.0 之後的版本起,
failed 項目還帶有 kind,腳本不必讀取 reason 就能分支:
uninstall 會先嘗試每個目標,然後才失敗。任何目標失敗時,執行都以 1 結束,即使其他目標已被移除。失敗的執行仍會印出 value.results,所以腳本可以看到哪些目標已被移除。沒有移除任何目標時,狀態為 noop,幀中帶有一則 W_UNINSTALL_NOOP 警告。
範例
移除受管理的 Chrome for Testing
移除所有受管理的瀏覽器
顯示 Firefox 的受管理移除路徑
最佳實務
- 在 CI 收尾使用
--all,在測試後清理受管理的瀏覽器。 - 先使用
--where,在大量移除前確認會被清掉的內容。
行為說明
- 如果你設定了
EXT_BROWSERS_CACHE_DIR,uninstall 會使用該自訂快取根目錄。

