117 lines
3.4 KiB
TypeScript
117 lines
3.4 KiB
TypeScript
|
import {GlobbyOptions} from 'globby';
|
||
|
|
||
|
declare namespace del {
|
||
|
interface ProgressData {
|
||
|
/**
|
||
|
Deleted files and directories count.
|
||
|
*/
|
||
|
deletedCount: number;
|
||
|
|
||
|
/**
|
||
|
Total files and directories count.
|
||
|
*/
|
||
|
totalCount: number;
|
||
|
|
||
|
/**
|
||
|
Completed percentage. A value between `0` and `1`.
|
||
|
*/
|
||
|
percent: number;
|
||
|
}
|
||
|
|
||
|
interface Options extends GlobbyOptions {
|
||
|
/**
|
||
|
Allow deleting the current working directory and outside.
|
||
|
|
||
|
@default false
|
||
|
*/
|
||
|
readonly force?: boolean;
|
||
|
|
||
|
/**
|
||
|
See what would be deleted.
|
||
|
|
||
|
@default false
|
||
|
|
||
|
@example
|
||
|
```
|
||
|
import del = require('del');
|
||
|
|
||
|
(async () => {
|
||
|
const deletedPaths = await del(['temp/*.js'], {dryRun: true});
|
||
|
|
||
|
console.log('Files and directories that would be deleted:\n', deletedPaths.join('\n'));
|
||
|
})();
|
||
|
```
|
||
|
*/
|
||
|
readonly dryRun?: boolean;
|
||
|
|
||
|
/**
|
||
|
Concurrency limit. Minimum: `1`.
|
||
|
|
||
|
@default Infinity
|
||
|
*/
|
||
|
readonly concurrency?: number;
|
||
|
|
||
|
/**
|
||
|
Called after each file or directory is deleted.
|
||
|
|
||
|
@example
|
||
|
```
|
||
|
import del from 'del';
|
||
|
|
||
|
await del(patterns, {
|
||
|
onProgress: progress => {
|
||
|
// …
|
||
|
}});
|
||
|
```
|
||
|
*/
|
||
|
readonly onProgress?: (progress: ProgressData) => void;
|
||
|
}
|
||
|
}
|
||
|
|
||
|
declare const del: {
|
||
|
/**
|
||
|
Synchronously delete files and directories using glob patterns.
|
||
|
|
||
|
Note that glob patterns can only contain forward-slashes, not backward-slashes. Windows file paths can use backward-slashes as long as the path does not contain any glob-like characters, otherwise use `path.posix.join()` instead of `path.join()`.
|
||
|
|
||
|
@param patterns - See the supported [glob patterns](https://github.com/sindresorhus/globby#globbing-patterns).
|
||
|
- [Pattern examples with expected matches](https://github.com/sindresorhus/multimatch/blob/main/test/test.js)
|
||
|
- [Quick globbing pattern overview](https://github.com/sindresorhus/multimatch#globbing-patterns)
|
||
|
@param options - You can specify any of the [`globby` options](https://github.com/sindresorhus/globby#options) in addition to the `del` options. In contrast to the `globby` defaults, `expandDirectories`, `onlyFiles`, and `followSymbolicLinks` are `false` by default.
|
||
|
@returns The deleted paths.
|
||
|
*/
|
||
|
sync: (
|
||
|
patterns: string | readonly string[],
|
||
|
options?: del.Options
|
||
|
) => string[];
|
||
|
|
||
|
/**
|
||
|
Delete files and directories using glob patterns.
|
||
|
|
||
|
Note that glob patterns can only contain forward-slashes, not backward-slashes. Windows file paths can use backward-slashes as long as the path does not contain any glob-like characters, otherwise use `path.posix.join()` instead of `path.join()`.
|
||
|
|
||
|
@param patterns - See the supported [glob patterns](https://github.com/sindresorhus/globby#globbing-patterns).
|
||
|
- [Pattern examples with expected matches](https://github.com/sindresorhus/multimatch/blob/main/test/test.js)
|
||
|
- [Quick globbing pattern overview](https://github.com/sindresorhus/multimatch#globbing-patterns)
|
||
|
@param options - You can specify any of the [`globby` options](https://github.com/sindresorhus/globby#options) in addition to the `del` options. In contrast to the `globby` defaults, `expandDirectories`, `onlyFiles`, and `followSymbolicLinks` are `false` by default.
|
||
|
@returns The deleted paths.
|
||
|
|
||
|
@example
|
||
|
```
|
||
|
import del = require('del');
|
||
|
|
||
|
(async () => {
|
||
|
const deletedPaths = await del(['temp/*.js', '!temp/unicorn.js']);
|
||
|
|
||
|
console.log('Deleted files and directories:\n', deletedPaths.join('\n'));
|
||
|
})();
|
||
|
```
|
||
|
*/
|
||
|
(
|
||
|
patterns: string | readonly string[],
|
||
|
options?: del.Options
|
||
|
): Promise<string[]>;
|
||
|
};
|
||
|
|
||
|
export = del;
|