Skip to main content

readFileSync

function readFileSync
Jump to headingreadFileSync(
options?: { encoding?: null | undefined; flag?: string | undefined; } | null,
): Buffer

Returns the contents of the path.

For detailed information, see the documentation of the asynchronous version of this API: readFile.

If the encoding option is specified then this function returns a string. Otherwise it returns a buffer.

Similar to readFile, when the path is a directory, the behavior of fs.readFileSync() is platform-specific.

import { readFileSync } from 'node:fs';

// macOS, Linux, and Windows
readFileSync('<directory>');
// => [Error: EISDIR: illegal operation on a directory, read <directory>]

//  FreeBSD
readFileSync('<directory>'); // => <data>

Parameters Jump to heading

filename or file descriptor

optional
Jump to headingoptions: { encoding?: null | undefined; flag?: string | undefined; } | null

Return Type Jump to heading

Buffer
Jump to headingreadFileSync(
options: { encoding: BufferEncoding; flag?: string | undefined; } | BufferEncoding,
): string

Synchronously reads the entire contents of a file.

Parameters Jump to heading

A path to a file. If a URL is provided, it must use the file: protocol. If a file descriptor is provided, the underlying file will not be closed automatically.

Jump to headingoptions: { encoding: BufferEncoding; flag?: string | undefined; } | BufferEncoding

Either the encoding for the result, or an object that contains the encoding and an optional flag. If a flag is not provided, it defaults to 'r'.

Return Type Jump to heading

string
Jump to headingreadFileSync(
options?:
(ObjectEncodingOptions & { flag?: string | undefined; })
| BufferEncoding
| null
,
): string | Buffer

Synchronously reads the entire contents of a file.

Parameters Jump to heading

A path to a file. If a URL is provided, it must use the file: protocol. If a file descriptor is provided, the underlying file will not be closed automatically.

optional
Jump to headingoptions:
(ObjectEncodingOptions & { flag?: string | undefined; })
| BufferEncoding
| null

Either the encoding for the result, or an object that contains the encoding and an optional flag. If a flag is not provided, it defaults to 'r'.

Return Type Jump to heading

string | Buffer
Back to top