npm / del
del
What changed in del 9, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-17.
5 breaking1 security3 behavior and defaults7 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli initdel 916 changes
Breaking changes 5
Deletion refuses directories containing the process working directory and paths reached through symlinks outside cwd, unless force is set.
Negated paths inside matched directories are preserved, and the containing directories are kept while their other contents are deleted. Returned paths change accordingly.
del now requires Node.js 22.
The objectMode option has been removed from the types because del only returns paths.
The stats option has been removed from the types because del only returns paths.
Security 1
Every matched path is checked before any deletion begins, preventing partial deletion before an out-of-cwd path is refused.
Behavior and default changes 3
The default concurrency is now 256 deletions at a time instead of Infinity.
deleteAsync now waits for running deletions to finish before rejecting.
With gitignore enabled, .gitignore files from the repository root down to cwd now apply.
Fixes and other changes 7
The error message is corrected when deleting the directory specified by the cwd option.
deleteSync now respects the onProgress option.
A deletion is retried up to three times on temporary errors such as EBUSY and EPERM.
An undefined value no longer overrides the del default for expandDirectories.
An undefined value no longer overrides the del default for followSymbolicLinks.
An undefined value no longer overrides the del default for onlyFiles.
A path is no longer returned twice when patterns differ only by a trailing slash.