79 lines
2.2 KiB
TypeScript
79 lines
2.2 KiB
TypeScript
// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
|
|
import { join } from "jsr:/@std/path@^0.221.0/join";
|
|
import { toPathString } from "./_to_path_string.ts";
|
|
|
|
/**
|
|
* Asynchronously ensures that a directory is empty deletes the directory
|
|
* contents it is not empty. If the directory does not exist, it is created.
|
|
* The directory itself is not deleted.
|
|
*
|
|
* Requires the `--allow-read` and `--allow-write` flag.
|
|
*
|
|
* @param dir The path of the directory to empty, as a string or URL.
|
|
* @returns A void promise that resolves once the directory is empty.
|
|
*
|
|
* @example
|
|
* ```ts
|
|
* import { emptyDir } from "@std/fs/empty-dir";
|
|
*
|
|
* await emptyDir("./foo");
|
|
* ```
|
|
*/
|
|
export async function emptyDir(dir: string | URL) {
|
|
try {
|
|
const items = await Array.fromAsync(Deno.readDir(dir));
|
|
|
|
await Promise.all(items.map((item) => {
|
|
if (item && item.name) {
|
|
const filepath = join(toPathString(dir), item.name);
|
|
return Deno.remove(filepath, { recursive: true });
|
|
}
|
|
}));
|
|
} catch (err) {
|
|
if (!(err instanceof Deno.errors.NotFound)) {
|
|
throw err;
|
|
}
|
|
|
|
// if not exist. then create it
|
|
await Deno.mkdir(dir, { recursive: true });
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Synchronously ensures that a directory is empty deletes the directory
|
|
* contents it is not empty. If the directory does not exist, it is created.
|
|
* The directory itself is not deleted.
|
|
*
|
|
* Requires the `--allow-read` and `--allow-write` flag.
|
|
*
|
|
* @param dir The path of the directory to empty, as a string or URL.
|
|
* @returns A void value that returns once the directory is empty.
|
|
*
|
|
* @example
|
|
* ```ts
|
|
* import { emptyDirSync } from "@std/fs/empty-dir";
|
|
*
|
|
* emptyDirSync("./foo");
|
|
* ```
|
|
*/
|
|
export function emptyDirSync(dir: string | URL) {
|
|
try {
|
|
const items = [...Deno.readDirSync(dir)];
|
|
|
|
// If the directory exists, remove all entries inside it.
|
|
while (items.length) {
|
|
const item = items.shift();
|
|
if (item && item.name) {
|
|
const filepath = join(toPathString(dir), item.name);
|
|
Deno.removeSync(filepath, { recursive: true });
|
|
}
|
|
}
|
|
} catch (err) {
|
|
if (!(err instanceof Deno.errors.NotFound)) {
|
|
throw err;
|
|
}
|
|
// if not exist. then create it
|
|
Deno.mkdirSync(dir, { recursive: true });
|
|
}
|
|
}
|