uninstall to remove managed browser runtimes from the Extension.js cache.
When to use uninstall
- You want to reclaim disk space from managed browsers you no longer need.
- You are resetting a managed browser install to force a fresh download on next
install. - You are cleaning up continuous integration (CI) caches or switching browser targets.
Canonical usage
For a single browser, use the positional form:--all to remove every managed browser target.
Usage
Arguments and flags
--all removes the same managed set that install --browser all creates: chrome, chromium, edge, and firefox.
From the release after 4.2.0, --all together with a browser name, such as extension uninstall chrome --all, is refused with E_ARGS and status usage, and nothing is removed. Pass the names to remove those browsers, or --all alone to remove every browser.
Machine output with --output json
--output json prints one schema-1 envelope on stdout:
- A successful removal prints a
status: "uninstalled"frame naming the target invalue. --whereprints astatus: "located"frame with the resolved paths invalue.paths.- A failed removal prints
ok: falsewitherror.code: "E_BROWSER_UNINSTALL"before the process exits1.
value carries browsers, all, and a results array with one entry for each target. Each entry has browser, removed, path (the managed folder that was checked), and outcome:
From the release after 4.2.0, a
failed entry also carries kind, so a script can branch without reading reason:
uninstall tries every target before it fails. The run exits 1 when any target fails, even when other targets were removed. A failed run still prints value.results, so a script can see which targets were removed. When no target was removed, the status is noop and the frame carries a W_UNINSTALL_NOOP warning.
Examples
Remove managed Chrome for Testing
Remove all managed browsers
Show the managed uninstall path for Firefox
Best practices
- Use
--allin CI teardown to clean up managed browsers after test runs. - Use
--wherefirst to confirm what will be removed before scripting bulk uninstalls.
Behavior notes
- If you set
EXT_BROWSERS_CACHE_DIR, uninstall uses that custom cache root.
Next steps
- Reinstall managed browsers with
install. - Review browser targeting with
devandstart. - Learn about Running other browsers with custom binary paths.

