@visulima/fs
Version:
Human friendly file system utilities for Node.js
3,012 lines (1,741 loc) • 80 kB
Markdown
<div align="center">
<h3>Visulima fs</h3>
<p>
Human friendly file system utilities for Node.js
</p>
</div>
<br />
<div align="center">
[![typescript-image]][typescript-url] [![npm-image]][npm-url] [![license-image]][license-url]
</div>
---
<div align="center">
<p>
<sup>
Daniel Bannert's open source work is supported by the community on <a href="https://github.com/sponsors/prisis">GitHub Sponsors</a>
</sup>
</p>
</div>
---
## Install
```sh
npm install @visulima/fs
```
```sh
yarn add @visulima/fs
```
```sh
pnpm add @visulima/fs
```
> **Note:** If you want to parse or write YAML, you'll need to install `yaml` as well.
```sh
npm install yaml
```
```sh
yarn add yaml
```
```sh
pnpm add yaml
```
> After installing `yaml`, you can use the `readYaml`, `readYamlSync` and `writeYaml`, `writeYamlSync` functions from `@visulima/fs/yaml`.
## Usage
## walk
```typescript
import { walk } from "@visulima/fs";
const filesAndFolders: string[] = [];
for await (const index of walk(`${__dirname}/fixtures`, {})) {
filesAndFolders.push(index.path);
}
console.log(filesAndFolders);
```
## walkSync
```typescript
import { walkSync } from "@visulima/fs";
const filesAndFolders: string[] = [];
for (const index of walkSync(`${__dirname}/fixtures`, {})) {
filesAndFolders.push(index.path);
}
console.log(filesAndFolders);
```
### API for `walk` and `walkSync`
#### path
Type: `string`
The directory to start from.
#### options
Type: `object`
#### maxDepth
Type: `number`
Default: `Infinity`
Optional: `true`
Description: The maximum depth of the file tree to be walked recursively.
#### includeFiles
Type: `boolean`
Default: `true`
Optional: `true`
Description: Indicates whether file entries should be included or not.
#### includeDirs
Type: `boolean`
Default: `true`
Optional: `true`
Description: Indicates whether directory entries should be included or not.
#### includeSymlinks
Type: `boolean`
Default: `true`
Optional: `true`
Description: Indicates whether symlink entries should be included or not. This option is meaningful only if followSymlinks is set to false.
#### followSymlinks
Type: `boolean`
Default: `false`
Optional: `true`
Description: Indicates whether symlinks should be resolved or not.
#### extensions
Type: `string[]`
Default: `undefined`
Optional: `true`
Description: List of file extensions used to filter entries. If specified, entries without the file extension specified by this option are excluded.
#### match
Type: `(RegExp | string)[]`
Default: `undefined`
Optional: `true`
Description: List of regular expression or [glob](<https://en.wikipedia.org/wiki/Glob_(programming)>) patterns used to filter entries. If specified, entries that do not match the patterns specified by this option are excluded.
#### skip
Type: `(RegExp | string)[]`
Default: `undefined`
Optional: `true`
Description: List of regular expression or [glob](<https://en.wikipedia.org/wiki/Glob_(programming)>) patterns used to filter entries. If specified, entries matching the patterns specified by this option are excluded.
## findUp
Find a file or directory by walking up parent directories.
```typescript
import { findUp } from "@visulima/fs";
// Returns a Promise for the found path or undefined if it could not be found.
const file = await findUp("package.json");
console.log(file);
```
## findUpSync
Find a file or directory by walking up parent directories.
```typescript
import { findUpSync } from "@visulima/fs";
// Returns the found path or undefined if it could not be found.
const file = findUpSync("package.json");
console.log(file);
```
### API for `findUp` and `findUpSync`
#### name
Type: `string[] | string | ((directory: PathLike) => PathLike | Promise<PathLike | typeof FIND_UP_STOP> | typeof FIND_UP_STOP)` \
Sync Type: `string[] | string | ((directory: PathLike) => PathLike | typeof FIND_UP_STOP)`
The name of the file or directory to find.
> If an array is specified, the first item that exists will be returned.
> A function that will be called with each directory until it returns a string with the path, which stops the search, or the root directory has been reached and nothing was found. Useful if you want to match files with certain patterns, set of permissions, or other advanced use-cases.
>
> When using async mode, the matcher may optionally be an async or promise-returning function that returns the path.
#### options
Type: `object`
##### cwd
Type: `URL | string`\
Default: `process.cwd()`
The directory to start from.
##### type
Type: `string`\
Default: `'file'`\
Values: `'file' | 'directory'`
The type of path to match.
##### stopAt
Type: `URL | string`\
Default: Root directory
A directory path where the search halts if no matches are found before reaching this point.
##### allowSymlinks
Type: `boolean`\
Default: `true`
Allow symbolic links to match if they point to the target file or directory.
## readFile
Read a file.
```typescript
import { readFile } from "@visulima/fs";
// Returns a Promise for the file contents.
const file = await readFile("package.json");
console.log(file);
```
## readFileSync
Read a file.
```typescript
import { readFileSync } from "@visulima/fs";
// Returns the file contents.
const file = readFileSync("package.json");
console.log(file);
```
### API for `readFile` and `readFileSync`
#### path
Type: `string`
The path to the file to read.
#### options
Type: `object`
##### buffer
Type: `boolean`
Default: `true`
Optional: `true`
Description: Indicates whether the file contents should be returned as a Buffer or a string.
##### compression
Type: `"brotli" | "gzip" | undefined`
Default: `undefined`
Optional: `true`
Description: The file compression.
##### encoding
Type: `"ascii" | "base64" | "base64url" | "hex" | "latin1" | "ucs-2" | "ucs2" | "utf-8" | "utf-16le" | "utf8" | "utf16le" | undefined`
Default: `utf8`
Optional: `true`
#### flag
Type: `number | string | undefined`
Default: `'r'`
Optional: `true`
## isAccessible
Check if a file or directory exists and is accessible.
```typescript
import { isAccessible } from "@visulima/fs";
// Returns a Promise for the result.
const file = await isAccessible("package.json");
console.log(file);
```
## isAccessibleSync
Check if a file or directory exists and is accessible.
```typescript
import { isAccessibleSync } from "@visulima/fs";
// Returns the result.
const file = isAccessibleSync("package.json");
console.log(file);
```
### API for `isAccessible` and `isAccessibleSync`
#### path
Type: `string`
The path to the file or directory to check.
#### mode
Type: `number`
Default: `fs.constants.F_OK`
Optional: `true`
Description: The accessibility mode.
---
# Utilities
## parseJson
Parse JSON with more helpful errors.
```typescript
import { parseJson, JSONError } from "@visulima/fs/utils";
const json = '{\n\t"foo": true,\n}';
JSON.parse(json);
/*
undefined:3
}
^
SyntaxError: Unexpected token }
*/
parseJson(json);
/*
JSONError: Unexpected token } in JSON at position 16 while parsing near '{ "foo": true,}'
1 | {
2 | "foo": true,
> 3 | }
| ^
*/
parseJson(json, "foo.json");
/*
JSONError: Unexpected token } in JSON at position 16 while parsing near '{ "foo": true,}' in foo.json
1 | {
2 | "foo": true,
> 3 | }
| ^
*/
```
### API for `parseJson`
#### json
Type: `string`
The JSON string to parse.
#### reviver
Type: `Function`
Prescribes how the value originally produced by parsing is transformed, before being returned. See [JSON.parse docs](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/parse#Using_the_reviver_parameter) for more.
#### filename
Type: `string`
The filename to use in error messages.
### API for `JSONError`
Exposed for use in `instanceof` checks.
#### fileName
Type: `string`
The filename displayed in the error message.
#### codeFrame
Type: `string`
The printable section of the JSON which produces the error.
## Api Docs
<!-- TYPEDOC -->
# error
## Classes
### AlreadyExistsError
Defined in: [packages/fs/src/error/already-exists-error.ts:4](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/error/already-exists-error.ts#L4)
Error thrown when file already exists.
#### Extends
- `Error`
#### Constructors
##### new AlreadyExistsError()
```ts
new AlreadyExistsError(message): AlreadyExistsError
```
Defined in: [packages/fs/src/error/already-exists-error.ts:9](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/error/already-exists-error.ts#L9)
Creates a new instance.
###### Parameters
###### message
`string`
The error message.
###### Returns
[`AlreadyExistsError`](error.md#alreadyexistserror)
###### Overrides
```ts
Error.constructor
```
#### Accessors
##### code
###### Get Signature
```ts
get code(): string
```
Defined in: [packages/fs/src/error/already-exists-error.ts:14](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/error/already-exists-error.ts#L14)
###### Returns
`string`
###### Set Signature
```ts
set code(_name): void
```
Defined in: [packages/fs/src/error/already-exists-error.ts:19](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/error/already-exists-error.ts#L19)
###### Parameters
###### \_name
`string`
###### Returns
`void`
##### name
###### Get Signature
```ts
get name(): string
```
Defined in: [packages/fs/src/error/already-exists-error.ts:24](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/error/already-exists-error.ts#L24)
###### Returns
`string`
###### Set Signature
```ts
set name(_name): void
```
Defined in: [packages/fs/src/error/already-exists-error.ts:29](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/error/already-exists-error.ts#L29)
###### Parameters
###### \_name
`string`
###### Returns
`void`
###### Overrides
```ts
Error.name
```
#### Methods
##### captureStackTrace()
```ts
static captureStackTrace(targetObject, constructorOpt?): void
```
Defined in: node\_modules/.pnpm/@types+node@18.19.71/node\_modules/@types/node/globals.d.ts:91
Create .stack property on a target object
###### Parameters
###### targetObject
`object`
###### constructorOpt?
`Function`
###### Returns
`void`
###### Inherited from
```ts
Error.captureStackTrace
```
#### Properties
##### cause?
```ts
optional cause: unknown;
```
Defined in: node\_modules/.pnpm/typescript@5.8.2/node\_modules/typescript/lib/lib.es2022.error.d.ts:26
###### Inherited from
```ts
Error.cause
```
##### message
```ts
message: string;
```
Defined in: node\_modules/.pnpm/typescript@5.8.2/node\_modules/typescript/lib/lib.es5.d.ts:1077
###### Inherited from
```ts
Error.message
```
##### stack?
```ts
optional stack: string;
```
Defined in: node\_modules/.pnpm/typescript@5.8.2/node\_modules/typescript/lib/lib.es5.d.ts:1078
###### Inherited from
```ts
Error.stack
```
##### prepareStackTrace()?
```ts
static optional prepareStackTrace: (err, stackTraces) => any;
```
Defined in: node\_modules/.pnpm/@types+node@18.19.71/node\_modules/@types/node/globals.d.ts:98
Optional override for formatting stack traces
###### Parameters
###### err
`Error`
###### stackTraces
`CallSite`[]
###### Returns
`any`
###### See
https://v8.dev/docs/stack-trace-api#customizing-stack-traces
###### Inherited from
```ts
Error.prepareStackTrace
```
##### stackTraceLimit
```ts
static stackTraceLimit: number;
```
Defined in: node\_modules/.pnpm/@types+node@18.19.71/node\_modules/@types/node/globals.d.ts:100
###### Inherited from
```ts
Error.stackTraceLimit
```
***
### DirectoryError
Defined in: [packages/fs/src/error/directory-error.ts:4](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/error/directory-error.ts#L4)
Error thrown when an operation is not allowed on a directory.
#### Extends
- `Error`
#### Constructors
##### new DirectoryError()
```ts
new DirectoryError(message): DirectoryError
```
Defined in: [packages/fs/src/error/directory-error.ts:9](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/error/directory-error.ts#L9)
Creates a new instance.
###### Parameters
###### message
`string`
The error message.
###### Returns
[`DirectoryError`](error.md#directoryerror)
###### Overrides
```ts
Error.constructor
```
#### Accessors
##### code
###### Get Signature
```ts
get code(): string
```
Defined in: [packages/fs/src/error/directory-error.ts:14](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/error/directory-error.ts#L14)
###### Returns
`string`
###### Set Signature
```ts
set code(_name): void
```
Defined in: [packages/fs/src/error/directory-error.ts:19](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/error/directory-error.ts#L19)
###### Parameters
###### \_name
`string`
###### Returns
`void`
##### name
###### Get Signature
```ts
get name(): string
```
Defined in: [packages/fs/src/error/directory-error.ts:24](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/error/directory-error.ts#L24)
###### Returns
`string`
###### Set Signature
```ts
set name(_name): void
```
Defined in: [packages/fs/src/error/directory-error.ts:29](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/error/directory-error.ts#L29)
###### Parameters
###### \_name
`string`
###### Returns
`void`
###### Overrides
```ts
Error.name
```
#### Methods
##### captureStackTrace()
```ts
static captureStackTrace(targetObject, constructorOpt?): void
```
Defined in: node\_modules/.pnpm/@types+node@18.19.71/node\_modules/@types/node/globals.d.ts:91
Create .stack property on a target object
###### Parameters
###### targetObject
`object`
###### constructorOpt?
`Function`
###### Returns
`void`
###### Inherited from
```ts
Error.captureStackTrace
```
#### Properties
##### cause?
```ts
optional cause: unknown;
```
Defined in: node\_modules/.pnpm/typescript@5.8.2/node\_modules/typescript/lib/lib.es2022.error.d.ts:26
###### Inherited from
```ts
Error.cause
```
##### message
```ts
message: string;
```
Defined in: node\_modules/.pnpm/typescript@5.8.2/node\_modules/typescript/lib/lib.es5.d.ts:1077
###### Inherited from
```ts
Error.message
```
##### stack?
```ts
optional stack: string;
```
Defined in: node\_modules/.pnpm/typescript@5.8.2/node\_modules/typescript/lib/lib.es5.d.ts:1078
###### Inherited from
```ts
Error.stack
```
##### prepareStackTrace()?
```ts
static optional prepareStackTrace: (err, stackTraces) => any;
```
Defined in: node\_modules/.pnpm/@types+node@18.19.71/node\_modules/@types/node/globals.d.ts:98
Optional override for formatting stack traces
###### Parameters
###### err
`Error`
###### stackTraces
`CallSite`[]
###### Returns
`any`
###### See
https://v8.dev/docs/stack-trace-api#customizing-stack-traces
###### Inherited from
```ts
Error.prepareStackTrace
```
##### stackTraceLimit
```ts
static stackTraceLimit: number;
```
Defined in: node\_modules/.pnpm/@types+node@18.19.71/node\_modules/@types/node/globals.d.ts:100
###### Inherited from
```ts
Error.stackTraceLimit
```
***
### NotEmptyError
Defined in: [packages/fs/src/error/not-empty-error.ts:4](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/error/not-empty-error.ts#L4)
Error thrown when a directory is not empty.
#### Extends
- `Error`
#### Constructors
##### new NotEmptyError()
```ts
new NotEmptyError(message): NotEmptyError
```
Defined in: [packages/fs/src/error/not-empty-error.ts:9](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/error/not-empty-error.ts#L9)
Creates a new instance.
###### Parameters
###### message
`string`
The error message.
###### Returns
[`NotEmptyError`](error.md#notemptyerror)
###### Overrides
```ts
Error.constructor
```
#### Accessors
##### code
###### Get Signature
```ts
get code(): string
```
Defined in: [packages/fs/src/error/not-empty-error.ts:14](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/error/not-empty-error.ts#L14)
###### Returns
`string`
###### Set Signature
```ts
set code(_name): void
```
Defined in: [packages/fs/src/error/not-empty-error.ts:19](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/error/not-empty-error.ts#L19)
###### Parameters
###### \_name
`string`
###### Returns
`void`
##### name
###### Get Signature
```ts
get name(): string
```
Defined in: [packages/fs/src/error/not-empty-error.ts:24](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/error/not-empty-error.ts#L24)
###### Returns
`string`
###### Set Signature
```ts
set name(_name): void
```
Defined in: [packages/fs/src/error/not-empty-error.ts:29](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/error/not-empty-error.ts#L29)
###### Parameters
###### \_name
`string`
###### Returns
`void`
###### Overrides
```ts
Error.name
```
#### Methods
##### captureStackTrace()
```ts
static captureStackTrace(targetObject, constructorOpt?): void
```
Defined in: node\_modules/.pnpm/@types+node@18.19.71/node\_modules/@types/node/globals.d.ts:91
Create .stack property on a target object
###### Parameters
###### targetObject
`object`
###### constructorOpt?
`Function`
###### Returns
`void`
###### Inherited from
```ts
Error.captureStackTrace
```
#### Properties
##### cause?
```ts
optional cause: unknown;
```
Defined in: node\_modules/.pnpm/typescript@5.8.2/node\_modules/typescript/lib/lib.es2022.error.d.ts:26
###### Inherited from
```ts
Error.cause
```
##### message
```ts
message: string;
```
Defined in: node\_modules/.pnpm/typescript@5.8.2/node\_modules/typescript/lib/lib.es5.d.ts:1077
###### Inherited from
```ts
Error.message
```
##### stack?
```ts
optional stack: string;
```
Defined in: node\_modules/.pnpm/typescript@5.8.2/node\_modules/typescript/lib/lib.es5.d.ts:1078
###### Inherited from
```ts
Error.stack
```
##### prepareStackTrace()?
```ts
static optional prepareStackTrace: (err, stackTraces) => any;
```
Defined in: node\_modules/.pnpm/@types+node@18.19.71/node\_modules/@types/node/globals.d.ts:98
Optional override for formatting stack traces
###### Parameters
###### err
`Error`
###### stackTraces
`CallSite`[]
###### Returns
`any`
###### See
https://v8.dev/docs/stack-trace-api#customizing-stack-traces
###### Inherited from
```ts
Error.prepareStackTrace
```
##### stackTraceLimit
```ts
static stackTraceLimit: number;
```
Defined in: node\_modules/.pnpm/@types+node@18.19.71/node\_modules/@types/node/globals.d.ts:100
###### Inherited from
```ts
Error.stackTraceLimit
```
***
### NotFoundError
Defined in: [packages/fs/src/error/not-found-error.ts:4](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/error/not-found-error.ts#L4)
Error thrown when a file or directory is not found.
#### Extends
- `Error`
#### Constructors
##### new NotFoundError()
```ts
new NotFoundError(message): NotFoundError
```
Defined in: [packages/fs/src/error/not-found-error.ts:9](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/error/not-found-error.ts#L9)
Creates a new instance.
###### Parameters
###### message
`string`
The error message.
###### Returns
[`NotFoundError`](error.md#notfounderror)
###### Overrides
```ts
Error.constructor
```
#### Accessors
##### code
###### Get Signature
```ts
get code(): string
```
Defined in: [packages/fs/src/error/not-found-error.ts:14](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/error/not-found-error.ts#L14)
###### Returns
`string`
###### Set Signature
```ts
set code(_name): void
```
Defined in: [packages/fs/src/error/not-found-error.ts:19](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/error/not-found-error.ts#L19)
###### Parameters
###### \_name
`string`
###### Returns
`void`
##### name
###### Get Signature
```ts
get name(): string
```
Defined in: [packages/fs/src/error/not-found-error.ts:24](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/error/not-found-error.ts#L24)
###### Returns
`string`
###### Set Signature
```ts
set name(_name): void
```
Defined in: [packages/fs/src/error/not-found-error.ts:29](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/error/not-found-error.ts#L29)
###### Parameters
###### \_name
`string`
###### Returns
`void`
###### Overrides
```ts
Error.name
```
#### Methods
##### captureStackTrace()
```ts
static captureStackTrace(targetObject, constructorOpt?): void
```
Defined in: node\_modules/.pnpm/@types+node@18.19.71/node\_modules/@types/node/globals.d.ts:91
Create .stack property on a target object
###### Parameters
###### targetObject
`object`
###### constructorOpt?
`Function`
###### Returns
`void`
###### Inherited from
```ts
Error.captureStackTrace
```
#### Properties
##### cause?
```ts
optional cause: unknown;
```
Defined in: node\_modules/.pnpm/typescript@5.8.2/node\_modules/typescript/lib/lib.es2022.error.d.ts:26
###### Inherited from
```ts
Error.cause
```
##### message
```ts
message: string;
```
Defined in: node\_modules/.pnpm/typescript@5.8.2/node\_modules/typescript/lib/lib.es5.d.ts:1077
###### Inherited from
```ts
Error.message
```
##### stack?
```ts
optional stack: string;
```
Defined in: node\_modules/.pnpm/typescript@5.8.2/node\_modules/typescript/lib/lib.es5.d.ts:1078
###### Inherited from
```ts
Error.stack
```
##### prepareStackTrace()?
```ts
static optional prepareStackTrace: (err, stackTraces) => any;
```
Defined in: node\_modules/.pnpm/@types+node@18.19.71/node\_modules/@types/node/globals.d.ts:98
Optional override for formatting stack traces
###### Parameters
###### err
`Error`
###### stackTraces
`CallSite`[]
###### Returns
`any`
###### See
https://v8.dev/docs/stack-trace-api#customizing-stack-traces
###### Inherited from
```ts
Error.prepareStackTrace
```
##### stackTraceLimit
```ts
static stackTraceLimit: number;
```
Defined in: node\_modules/.pnpm/@types+node@18.19.71/node\_modules/@types/node/globals.d.ts:100
###### Inherited from
```ts
Error.stackTraceLimit
```
***
### PermissionError
Defined in: [packages/fs/src/error/permission-error.ts:4](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/error/permission-error.ts#L4)
Error thrown when an operation is not permitted.
#### Extends
- `Error`
#### Constructors
##### new PermissionError()
```ts
new PermissionError(message): PermissionError
```
Defined in: [packages/fs/src/error/permission-error.ts:9](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/error/permission-error.ts#L9)
Creates a new instance.
###### Parameters
###### message
`string`
The error message.
###### Returns
[`PermissionError`](error.md#permissionerror)
###### Overrides
```ts
Error.constructor
```
#### Accessors
##### code
###### Get Signature
```ts
get code(): string
```
Defined in: [packages/fs/src/error/permission-error.ts:14](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/error/permission-error.ts#L14)
###### Returns
`string`
###### Set Signature
```ts
set code(_name): void
```
Defined in: [packages/fs/src/error/permission-error.ts:19](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/error/permission-error.ts#L19)
###### Parameters
###### \_name
`string`
###### Returns
`void`
##### name
###### Get Signature
```ts
get name(): string
```
Defined in: [packages/fs/src/error/permission-error.ts:24](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/error/permission-error.ts#L24)
###### Returns
`string`
###### Set Signature
```ts
set name(_name): void
```
Defined in: [packages/fs/src/error/permission-error.ts:29](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/error/permission-error.ts#L29)
###### Parameters
###### \_name
`string`
###### Returns
`void`
###### Overrides
```ts
Error.name
```
#### Methods
##### captureStackTrace()
```ts
static captureStackTrace(targetObject, constructorOpt?): void
```
Defined in: node\_modules/.pnpm/@types+node@18.19.71/node\_modules/@types/node/globals.d.ts:91
Create .stack property on a target object
###### Parameters
###### targetObject
`object`
###### constructorOpt?
`Function`
###### Returns
`void`
###### Inherited from
```ts
Error.captureStackTrace
```
#### Properties
##### cause?
```ts
optional cause: unknown;
```
Defined in: node\_modules/.pnpm/typescript@5.8.2/node\_modules/typescript/lib/lib.es2022.error.d.ts:26
###### Inherited from
```ts
Error.cause
```
##### message
```ts
message: string;
```
Defined in: node\_modules/.pnpm/typescript@5.8.2/node\_modules/typescript/lib/lib.es5.d.ts:1077
###### Inherited from
```ts
Error.message
```
##### stack?
```ts
optional stack: string;
```
Defined in: node\_modules/.pnpm/typescript@5.8.2/node\_modules/typescript/lib/lib.es5.d.ts:1078
###### Inherited from
```ts
Error.stack
```
##### prepareStackTrace()?
```ts
static optional prepareStackTrace: (err, stackTraces) => any;
```
Defined in: node\_modules/.pnpm/@types+node@18.19.71/node\_modules/@types/node/globals.d.ts:98
Optional override for formatting stack traces
###### Parameters
###### err
`Error`
###### stackTraces
`CallSite`[]
###### Returns
`any`
###### See
https://v8.dev/docs/stack-trace-api#customizing-stack-traces
###### Inherited from
```ts
Error.prepareStackTrace
```
##### stackTraceLimit
```ts
static stackTraceLimit: number;
```
Defined in: node\_modules/.pnpm/@types+node@18.19.71/node\_modules/@types/node/globals.d.ts:100
###### Inherited from
```ts
Error.stackTraceLimit
```
***
### WalkError
Defined in: [packages/fs/src/error/walk-error.ts:7](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/error/walk-error.ts#L7)
Error thrown in walk or walkSync during iteration.
#### Extends
- `Error`
#### Constructors
##### new WalkError()
```ts
new WalkError(cause, root): WalkError
```
Defined in: [packages/fs/src/error/walk-error.ts:12](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/error/walk-error.ts#L12)
Constructs a new instance.
###### Parameters
###### cause
`unknown`
###### root
`string`
###### Returns
[`WalkError`](error.md#walkerror)
###### Overrides
```ts
Error.constructor
```
#### Accessors
##### name
###### Get Signature
```ts
get name(): string
```
Defined in: [packages/fs/src/error/walk-error.ts:21](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/error/walk-error.ts#L21)
###### Returns
`string`
###### Set Signature
```ts
set name(_name): void
```
Defined in: [packages/fs/src/error/walk-error.ts:26](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/error/walk-error.ts#L26)
###### Parameters
###### \_name
`string`
###### Returns
`void`
###### Overrides
```ts
Error.name
```
#### Methods
##### captureStackTrace()
```ts
static captureStackTrace(targetObject, constructorOpt?): void
```
Defined in: node\_modules/.pnpm/@types+node@18.19.71/node\_modules/@types/node/globals.d.ts:91
Create .stack property on a target object
###### Parameters
###### targetObject
`object`
###### constructorOpt?
`Function`
###### Returns
`void`
###### Inherited from
```ts
Error.captureStackTrace
```
#### Properties
##### cause?
```ts
optional cause: unknown;
```
Defined in: node\_modules/.pnpm/typescript@5.8.2/node\_modules/typescript/lib/lib.es2022.error.d.ts:26
###### Inherited from
```ts
Error.cause
```
##### message
```ts
message: string;
```
Defined in: node\_modules/.pnpm/typescript@5.8.2/node\_modules/typescript/lib/lib.es5.d.ts:1077
###### Inherited from
```ts
Error.message
```
##### root
```ts
root: string;
```
Defined in: [packages/fs/src/error/walk-error.ts:9](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/error/walk-error.ts#L9)
File path of the root that's being walked.
##### stack?
```ts
optional stack: string;
```
Defined in: node\_modules/.pnpm/typescript@5.8.2/node\_modules/typescript/lib/lib.es5.d.ts:1078
###### Inherited from
```ts
Error.stack
```
##### prepareStackTrace()?
```ts
static optional prepareStackTrace: (err, stackTraces) => any;
```
Defined in: node\_modules/.pnpm/@types+node@18.19.71/node\_modules/@types/node/globals.d.ts:98
Optional override for formatting stack traces
###### Parameters
###### err
`Error`
###### stackTraces
`CallSite`[]
###### Returns
`any`
###### See
https://v8.dev/docs/stack-trace-api#customizing-stack-traces
###### Inherited from
```ts
Error.prepareStackTrace
```
##### stackTraceLimit
```ts
static stackTraceLimit: number;
```
Defined in: node\_modules/.pnpm/@types+node@18.19.71/node\_modules/@types/node/globals.d.ts:100
###### Inherited from
```ts
Error.stackTraceLimit
```
## References
### JSONError
Re-exports [JSONError](utils.md#jsonerror)
# index
## Functions
### collect()
```ts
function collect(directory, options): Promise<string[]>
```
Defined in: [packages/fs/src/find/collect.ts:4](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/find/collect.ts#L4)
#### Parameters
##### directory
`string`
##### options
[`WalkOptions`](index.md#walkoptions) = `{}`
#### Returns
`Promise`\<`string`[]\>
***
### collectSync()
```ts
function collectSync(directory, options): string[]
```
Defined in: [packages/fs/src/find/collect-sync.ts:4](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/find/collect-sync.ts#L4)
#### Parameters
##### directory
`string`
##### options
[`WalkOptions`](index.md#walkoptions) = `{}`
#### Returns
`string`[]
***
### detect()
```ts
function detect(content): "\n" | "\r\n"
```
Defined in: [packages/fs/src/eol.ts:20](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/eol.ts#L20)
Detect the EOL character for string input.
Returns null if no newline.
#### Parameters
##### content
`string`
#### Returns
"\n" \| "\r\n"
***
### emptyDir()
```ts
function emptyDir(dir, options?): Promise<void>
```
Defined in: [packages/fs/src/remove/empty-dir.ts:19](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/remove/empty-dir.ts#L19)
Ensures that a directory is empty.
Deletes directory contents if the directory is not empty.
If the directory does not exist, it is created.
The directory itself is not deleted.
#### Parameters
##### dir
`string` | `URL`
##### options?
[`EmptyDirOptions`](index.md#emptydiroptions)
#### Returns
`Promise`\<`void`\>
***
### emptyDirSync()
```ts
function emptyDirSync(dir, options?): void
```
Defined in: [packages/fs/src/remove/empty-dir-sync.ts:18](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/remove/empty-dir-sync.ts#L18)
Ensures that a directory is empty.
Deletes directory contents if the directory is not empty.
If the directory does not exist, it is created.
The directory itself is not deleted.
#### Parameters
##### dir
`string` | `URL`
##### options?
[`EmptyDirOptions`](index.md#emptydiroptions)
#### Returns
`void`
***
### ensureDir()
```ts
function ensureDir(directory): Promise<void>
```
Defined in: [packages/fs/src/ensure/ensure-dir.ts:12](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/ensure/ensure-dir.ts#L12)
Ensures that the directory exists.
If the directory structure does not exist, it is created. Like mkdir -p.
#### Parameters
##### directory
`string` | `URL`
#### Returns
`Promise`\<`void`\>
***
### ensureDirSync()
```ts
function ensureDirSync(directory): void
```
Defined in: [packages/fs/src/ensure/ensure-dir-sync.ts:12](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/ensure/ensure-dir-sync.ts#L12)
Ensures that the directory exists.
If the directory structure does not exist, it is created. Like mkdir -p.
#### Parameters
##### directory
`string` | `URL`
#### Returns
`void`
***
### ensureFile()
```ts
function ensureFile(filePath): Promise<void>
```
Defined in: [packages/fs/src/ensure/ensure-file.ts:16](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/ensure/ensure-file.ts#L16)
Ensures that the file exists.
If the file that is requested to be created is in directories that do not exist,
these directories are created. If the file already exists, it is NOTMODIFIED.
#### Parameters
##### filePath
`string` | `URL`
#### Returns
`Promise`\<`void`\>
***
### ensureFileSync()
```ts
function ensureFileSync(filePath): void
```
Defined in: [packages/fs/src/ensure/ensure-file-sync.ts:16](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/ensure/ensure-file-sync.ts#L16)
Ensures that the file exists.
If the file that is requested to be created is in directories that do not exist,
these directories are created. If the file already exists, it is NOTMODIFIED.
#### Parameters
##### filePath
`string` | `URL`
#### Returns
`void`
***
### ensureLink()
```ts
function ensureLink(source, destination): Promise<void>
```
Defined in: [packages/fs/src/ensure/ensure-link.ts:15](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/ensure/ensure-link.ts#L15)
Ensures that the hard link exists.
If the directory structure does not exist, it is created.
#### Parameters
##### source
`string` | `URL`
##### destination
`string` | `URL`
#### Returns
`Promise`\<`void`\>
***
### ensureLinkSync()
```ts
function ensureLinkSync(source, destination): void
```
Defined in: [packages/fs/src/ensure/ensure-link-sync.ts:15](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/ensure/ensure-link-sync.ts#L15)
Ensures that the hard link exists.
If the directory structure does not exist, it is created.
#### Parameters
##### source
`string` | `URL`
##### destination
`string` | `URL`
#### Returns
`void`
***
### ensureSymlink()
```ts
function ensureSymlink(
target,
linkName,
type?): Promise<void>
```
Defined in: [packages/fs/src/ensure/ensure-symlink.ts:28](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/ensure/ensure-symlink.ts#L28)
Ensures that the link exists, and points to a valid file.
If the directory structure does not exist, it is created.
If the link already exists, it is not modified but error is thrown if it is not point to the given target.
#### Parameters
##### target
the source file path
`string` | `URL`
##### linkName
the destination link path
`string` | `URL`
##### type?
`Type`
the type of the symlink, or null to use automatic detection
#### Returns
`Promise`\<`void`\>
A void promise that resolves once the link exists.
***
### ensureSymlinkSync()
```ts
function ensureSymlinkSync(
target,
linkName,
type?): void
```
Defined in: [packages/fs/src/ensure/ensure-symlink-sync.ts:28](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/ensure/ensure-symlink-sync.ts#L28)
Ensures that the link exists, and points to a valid file.
If the directory structure does not exist, it is created.
If the link already exists, it is not modified but error is thrown if it is not point to the given target.
#### Parameters
##### target
the source file path
`string` | `URL`
##### linkName
the destination link path
`string` | `URL`
##### type?
`Type`
the type of the symlink, or null to use automatic detection
#### Returns
`void`
A void.
***
### findUp()
```ts
function findUp(name, options): Promise<string>
```
Defined in: [packages/fs/src/find/find-up.ts:11](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/find/find-up.ts#L11)
#### Parameters
##### name
[`FindUpName`](index.md#findupname)
##### options
[`FindUpOptions`](index.md#findupoptions) = `{}`
#### Returns
`Promise`\<`string`\>
***
### findUpSync()
```ts
function findUpSync(name, options): string
```
Defined in: [packages/fs/src/find/find-up-sync.ts:11](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/find/find-up-sync.ts#L11)
#### Parameters
##### name
[`FindUpNameSync`](index.md#findupnamesync)
##### options
[`FindUpOptions`](index.md#findupoptions) = `{}`
#### Returns
`string`
***
### format()
```ts
function format(content, eol): string
```
Defined in: [packages/fs/src/eol.ts:36](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/eol.ts#L36)
Format the file to the targeted EOL.
#### Parameters
##### content
`string`
##### eol
"\n" | "\r\n"
#### Returns
`string`
***
### isAccessible()
```ts
function isAccessible(path, mode?): Promise<boolean>
```
Defined in: [packages/fs/src/is-accessible.ts:9](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/is-accessible.ts#L9)
Returns a Promise that resolves to a boolean indicating if the path is accessible or not.
#### Parameters
##### path
`string` | `URL`
##### mode?
`number`
#### Returns
`Promise`\<`boolean`\>
***
### isAccessibleSync()
```ts
function isAccessibleSync(path, mode?): boolean
```
Defined in: [packages/fs/src/is-accessible-sync.ts:9](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/is-accessible-sync.ts#L9)
Returns a boolean indicating if the path is accessible or not.
#### Parameters
##### path
`string` | `URL`
##### mode?
`number`
#### Returns
`boolean`
***
### move()
```ts
function move(
sourcePath,
destinationPath,
options): Promise<void>
```
Defined in: [packages/fs/src/move/index.ts:35](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/move/index.ts#L35)
Move a file asynchronously.
#### Parameters
##### sourcePath
`string`
The file you want to move.
##### destinationPath
`string`
Where you want the file moved.
##### options
[`MoveOptions`](index.md#moveoptions) = `{}`
Configuration options.
#### Returns
`Promise`\<`void`\>
A `Promise` that resolves when the file has been moved.
#### Example
```
import { moveFile } from '@visulima/fs';
await moveFile('source/test.png', 'destination/test.png');
console.log('The file has been moved');
```
***
### moveSync()
```ts
function moveSync(
sourcePath,
destinationPath,
options?): void
```
Defined in: [packages/fs/src/move/index.ts:61](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/move/index.ts#L61)
Move a file synchronously.
#### Parameters
##### sourcePath
`string`
The file you want to move.
##### destinationPath
`string`
Where you want the file moved.
##### options?
[`MoveOptions`](index.md#moveoptions)
Configuration options.
#### Returns
`void`
Nothing is returned.
#### Example
```
import { moveFileSync } from '@visulima/fs';
moveFileSync('source/test.png', 'destination/test.png');
console.log('The file has been moved');
```
***
### readFile()
```ts
function readFile<O>(path, options?): Promise<ContentType<O>>
```
Defined in: [packages/fs/src/read/read-file.ts:20](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/read/read-file.ts#L20)
#### Type Parameters
• **O** *extends* [`ReadFileOptions`](index.md#readfileoptionsc)\<`"brotli"` \| `"gzip"` \| `"none"`\> = `undefined`
#### Parameters
##### path
`string` | `URL`
##### options?
`O`
#### Returns
`Promise`\<`ContentType`\<`O`\>\>
***
### readFileSync()
```ts
function readFileSync<O>(path, options?): ContentType<O>
```
Defined in: [packages/fs/src/read/read-file-sync.ts:18](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/read/read-file-sync.ts#L18)
#### Type Parameters
• **O** *extends* [`ReadFileOptions`](index.md#readfileoptionsc)\<`"brotli"` \| `"gzip"` \| `"none"`\> = `undefined`
#### Parameters
##### path
`string` | `URL`
##### options?
`O`
#### Returns
`ContentType`\<`O`\>
***
### readJson()
#### Call Signature
```ts
function readJson<T>(path, options?): Promise<T>
```
Defined in: [packages/fs/src/read/read-json.ts:8](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/read/read-json.ts#L8)
##### Type Parameters
• **T** *extends* `JsonValue`
##### Parameters
###### path
`string` | `URL`
###### options?
[`ReadJsonOptions`](index.md#readjsonoptions)
##### Returns
`Promise`\<`T`\>
#### Call Signature
```ts
function readJson<T>(
path,
reviver,
options?): Promise<T>
```
Defined in: [packages/fs/src/read/read-json.ts:10](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/read/read-json.ts#L10)
##### Type Parameters
• **T** *extends* `JsonValue`
##### Parameters
###### path
`string` | `URL`
###### reviver
(`this`, `key`, `value`) => `any`
###### options?
[`ReadJsonOptions`](index.md#readjsonoptions)
##### Returns
`Promise`\<`T`\>
***
### readJsonSync()
#### Call Signature
```ts
function readJsonSync<T>(path, options?): T
```
Defined in: [packages/fs/src/read/read-json-sync.ts:8](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/read/read-json-sync.ts#L8)
##### Type Parameters
• **T** *extends* `JsonValue`
##### Parameters
###### path
`string` | `URL`
###### options?
[`ReadJsonOptions`](index.md#readjsonoptions)
##### Returns
`T`
#### Call Signature
```ts
function readJsonSync<T>(
path,
reviver,
options?): T
```
Defined in: [packages/fs/src/read/read-json-sync.ts:10](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/read/read-json-sync.ts#L10)
##### Type Parameters
• **T** *extends* `JsonValue`
##### Parameters
###### path
`string` | `URL`
###### reviver
(`this`, `key`, `value`) => `any`
###### options?
[`ReadJsonOptions`](index.md#readjsonoptions)
##### Returns
`T`
***
### remove()
```ts
function remove(path, options): Promise<void>
```
Defined in: [packages/fs/src/remove/remove.ts:5](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/remove/remove.ts#L5)
#### Parameters
##### path
`string` | `URL`
##### options
###### maxRetries?
`number`
If an `EBUSY`, `EMFILE`, `ENFILE`, `ENOTEMPTY`, or
`EPERM` error is encountered, Node.js will retry the operation with a linear
backoff wait of `retryDelay` ms longer on each try. This option represents the
number of retries. This option is ignored if the `recursive` option is not
`true`.
**Default**
```ts
0
```
###### retryDelay?
`number`
The amount of time in milliseconds to wait between retries.
This option is ignored if the `recursive` option is not `true`.
**Default**
```ts
100
```
#### Returns
`Promise`\<`void`\>
***
### removeSync()
```ts
function removeSync(path, options): void
```
Defined in: [packages/fs/src/remove/remove-sync.ts:5](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/remove/remove-sync.ts#L5)
#### Parameters
##### path
`string` | `URL`
##### options
###### maxRetries?
`number`
If an `EBUSY`, `EMFILE`, `ENFILE`, `ENOTEMPTY`, or
`EPERM` error is encountered, Node.js will retry the operation with a linear
backoff wait of `retryDelay` ms longer on each try. This option represents the
number of retries. This option is ignored if the `recursive` option is not
`true`.
**Default**
```ts
0
```
###### retryDelay?
`number`
The amount of time in milliseconds to wait between retries.
This option is ignored if the `recursive` option is not `true`.
**Default**
```ts
100
```
#### Returns
`void`
***
### rename()
```ts
function rename(
source,
destination,
options?): Promise<void>
```
Defined in: [packages/fs/src/move/index.ts:85](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/move/index.ts#L85)
Rename a file asynchronously.
#### Parameters
##### source
`string`
The file you want to rename.
##### destination
`string`
The name of the renamed file.
##### options?
[`MoveOptions`](index.md#moveoptions)
Configuration options.
#### Returns
`Promise`\<`void`\>
A `Promise` that resolves when the file has been renamed.
#### Example
```
import { renameFile } from '@visulima/fs';
await renameFile('test.png', 'tests.png', {cwd: 'source'});
console.log('The file has been renamed');
```
***
### renameSync()
```ts
function renameSync(
source,
destination,
options?): void
```
Defined in: [packages/fs/src/move/index.ts:109](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/move/index.ts#L109)
Rename a file synchronously.
#### Parameters
##### source
`string`
The file you want to rename.
##### destination
`string`
The name of the renamed file.
##### options?
[`MoveOptions`](index.md#moveoptions)
Configuration options.
#### Returns
`void`
A `Promise` that resolves when the file has been renamed.
#### Example
```
import {renameFileSync} from '@visulima/fs';
renameFileSync('test.png', 'tests.png', {cwd: 'source'});
console.log('The file has been renamed');
```
***
### walk()
```ts
function walk(directory, __namedParameters): AsyncIterableIterator<WalkEntry>
```
Defined in: [packages/fs/src/find/walk.ts:49](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/find/walk.ts#L49)
Walks the file tree rooted at root, yielding each file or directory in the
tree filtered according to the given options.
Options:
- maxDepth?: number = Infinity;
- includeFiles?: boolean = true;
- includeDirs?: boolean = true;
- includeSymlinks?: boolean = true;
- followSymlinks?: boolean = false;
- extensions?: string[];
- match?: string | ReadonlyArray<string>;
- skip?: string | ReadonlyArray<string>;
#### Parameters
##### directory
`string` | `URL`
##### \_\_namedParameters
[`WalkOptions`](index.md#walkoptions) = `{}`
#### Returns
`AsyncIterableIterator`\<[`WalkEntry`](index.md#walkentry)\>
***
### walkSync()
```ts
function walkSync(directory, __namedParameters): IterableIterator<WalkEntry>
```
Defined in: [packages/fs/src/find/walk-sync.ts:40](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/find/walk-sync.ts#L40)
Same as [`walk`](index.md#walk) but uses synchronous ops
#### Parameters
##### directory
`string` | `URL`
##### \_\_namedParameters
[`WalkOptions`](index.md#walkoptions) = `{}`
#### Returns
`IterableIterator`\<[`WalkEntry`](index.md#walkentry)\>
***
### writeFile()
```ts
function writeFile(
path,
content,
options?): Promise<void>
```
Defined in: [packages/fs/src/write/write-file.ts:15](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/write/write-file.ts#L15)
#### Parameters
##### path
`string` | `URL`
##### content
`string` | `ArrayBuffer` | `ArrayBufferView`\<`ArrayBufferLike`\>
##### options?
[`WriteFileOptions`](index.md#writefileoptions)
#### Returns
`Promise`\<`void`\>
***
### writeFileSync()
```ts
function writeFileSync(
path,
content,
options?): void
```
Defined in: [packages/fs/src/write/write-file-sync.ts:15](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/write/write-file-sync.ts#L15)
#### Parameters
##### path
`string` | `URL`
##### content
`string` | `ArrayBuffer` | `ArrayBufferView`\<`ArrayBufferLike`\>
##### options?
[`WriteFileOptions`](index.md#writefileoptions)
#### Returns
`void`
***
### writeJson()
```ts
function writeJson(
path,
data,
options): Promise<void>
```
Defined in: [packages/fs/src/write/write-json.ts:11](https://github.com/visulima/visulima/blob/ae1c843808a0fea82d6f99ef936ec12dc5b255c1/packages/fs/src/write/write-json.ts#L11)
#### Parameters
##### path
`string` | `URL`
##### data
`unknown`
##### options
[`WriteJsonOptions`](index.md#writejsonoptions) = `{}`
#### Returns
`Promise`\<`void`\>
***
### writeJsonSync()
```ts
function writeJsonSync(
path,
data,
options): void
```
Defined in: [packages/fs/src/write/write-json-sync.ts:11](https://github.co