uninstall 从 Extension.js 缓存中移除受管理的浏览器运行时。
什么时候使用 uninstall
- 你想从不再需要的受管理浏览器中回收磁盘空间。
- 你想重置一个受管理浏览器的安装,让下次
install时强制重新下载。 - 你正在清理持续集成(CI)缓存或切换浏览器目标。
标准用法
针对单个浏览器,使用位置参数形式:--all 移除所有受管理的浏览器目标。
用法
参数与 flag
--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 teardown 中使用
--all:测试运行后清理受管理的浏览器。 - 先用
--where确认:在脚本化批量卸载之前先确认会被移除的内容。
行为说明
- 如果你设置了
EXT_BROWSERS_CACHE_DIR,卸载会使用这个自定义的缓存根目录。

