CVE-2025-30222: Shescape has potential environment variable exposure on Windows with CMD
Impact
This impact users of Shescape on Windows that explicitly configure shell: 'cmd.exe' or shell: true using any of quote/quoteAll/escape/escapeAll.
An attacker may be able to get read-only access to environment variables. Example:
javascript import as cp from "node:childprocess"; import { Shescape } from "shescape";
// 1. Prerequisites const shescape = new Shescape({ shell: "cmd.exe", // Or shell: true, // Only if the default shell is CMD });
// 2. Payload const payload = '"%PATH%';
// 3. Usage let escapedPayload;
escapedPayload = shescape.quote(payload); // Or escapedPayload = shescape.quoteAll([payload]); // Or escapedPayload = shescape.escape(payload); // Or escapedPayload = shescape.escapeAll([payload]);
// And (example) const result = cp.execSync(echo Hello ${escapedPayload}, options);
// 4. Impact console.log(result.toString()); // Outputs "Hello" followed by the contents of the PATH environment variable
For Shescape prior to v2.0.0, the options object must have shell: 'cmd.exe' or shell: undefined and interpolation: true.
Patches
This bug has been patched in v2.1.2 which you can upgrade to now.
If you are already using v2 of Shescape, no further changes are required. If you are using v1 of Shescape, follow the migration guide to upgrade to v2. There is no plan to release a patch compatible with v1 of Shescape.
Workarounds
Alternatively, users can remove all instances of % from user input before using Shescape.
References
- Shescape Pull Request #1916 - Shescape commit 0a81f1e - Shescape release v2.1.2
For more information
- Comment on Pull Request #1916 - Comment on commit 0a81f1e - Open an issue at https://github.com/ericcornelissen/shescape/issues (New issue > Question)
Other sources
Shescape is a simple shell escape library for JavaScript. Versions 1.7.2 through 2.1.1 are vulnerable to potential environment variable exposure on Windows with CMD. This impact users of Shescape on Windows that explicitly configure shell: 'cmd.exe' or shell: true using any of quote/quoteAll/escape/escapeAll. An attacker may be able to get read-only access to environment variables. This bug has been patched in v2.1.2. For those who are already using v2 of Shescape, no further changes are required. Those who are are using v1 of Shescape should follow the migration guide to upgrade to v2. There is no plan to release a patch compatible with v1 of Shescape. As a workaround, users can remove all instances of % from user input before using Shescape.
— MITRE
Affected Software
Remediation
Recommended actions to resolve this vulnerability, in priority order.
- Upgrade
Upgrade
npm/shescapeto a version that resolves this vulnerability.Fixed in 2.1.2 - Upgrade
Upgrade
shescapeto a version that resolves this vulnerability.Fixed in v2.1.2Patch v2.1.2 - Configuration
If using Shescape v1.7.2 through 2.1.1 on Windows, avoid explicitly configuring `shell: 'cmd.exe'` or `shell: true`; the impact is on users who do so with `quote`/`quoteAll`/`escape`/`escapeAll`. Prefer upgrading to v2.1.2 or use the default shell without forcing CMD.
Shescape shell = 'cmd.exe' (or shell: true) - Compensating control
Workaround: remove all instances of `%` from user input before using Shescape.
Event History
Frequently Asked Questions
What is the severity of CVE-2025-30222?
The severity of CVE-2025-30222 is considered moderate due to potential exposure of environment variables.
How do I fix CVE-2025-30222?
To fix CVE-2025-30222, upgrade Shescape to version 2.1.2 or later.
What versions of Shescape are affected by CVE-2025-30222?
Shescape versions 1.7.2 through 2.1.1 are affected by CVE-2025-30222.
Who is impacted by CVE-2025-30222?
Users of Shescape on Windows who configure the shell as 'cmd.exe' or 'shell: true' are impacted by CVE-2025-30222.
What type of vulnerability is CVE-2025-30222?
CVE-2025-30222 is a vulnerability related to potential environment variable exposure in the Shescape library.