# Delete directories (/docs/guides/runtime/delete-directory)

<!-- agent-signals: reading_time_min: 1 · est_tokens: 228 · updated: 2026-07-28 -->
Related: [Delete files](/docs/guides/runtime/delete-file.md), [Import a HTML file as text](/docs/guides/runtime/import-html.md), [Import a JSON file](/docs/guides/runtime/import-json.md), [Import a JSON5 file](/docs/guides/runtime/import-json5.md), [Import a TOML file](/docs/guides/runtime/import-toml.md), [Import a YAML file](/docs/guides/runtime/import-yaml.md)

To recursively delete a directory and all its contents, use `rm` from `node:fs/promises`. This is like running `rm -rf` in JavaScript.

```ts delete-directory.ts icon="/icons/typescript.svg"
import { rm } from "node:fs/promises";

// Delete a directory and all its contents
await rm("path/to/directory", { recursive: true, force: true });
```

***

These options configure the deletion behavior:

* `recursive: true` - Delete subdirectories and their contents
* `force: true` - Don't throw errors if the directory doesn't exist

Omit `force` to get an error if the directory doesn't exist:

```ts delete-directory.ts icon="/icons/typescript.svg"
try {
  await rm("path/to/directory", { recursive: true });
} catch (error) {
  if (error.code === "ENOENT") {
    console.log("Directory doesn't exist");
  } else {
    throw error;
  }
}
```

***

See [File I/O](/runtime/file-io) for more filesystem operations.