跳转到主要内容
使用 uninstall 从 Extension.js 缓存中移除受管理的浏览器运行时。
uninstall 移除的是 Extension.js 下载到其受管理缓存中的浏览器运行时。它从不移除你的系统浏览器,也从不移除安装在浏览器里的扩展。要移除一个开发中的扩展,停止 dev 会话即可。该扩展加载进的是受管理的浏览器配置文件,而不是你自己的浏览器配置文件。

什么时候使用 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 退出。
从 4.1.41 之后的版本起,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,卸载会使用这个自定义的缓存根目录。

下一步