File: index.d.ts

package info (click to toggle)
node-load-json-file 7.0.1-1
  • links: PTS, VCS
  • area: main
  • in suites: bookworm, sid
  • size: 156 kB
  • sloc: javascript: 93; makefile: 4
file content (48 lines) | stat: -rw-r--r-- 1,331 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
// From https://github.com/sindresorhus/type-fest
export type JsonValue = string | number | boolean | null | {[Key in string]?: JsonValue} | JsonValue[];

export type Reviver = (this: unknown, key: string, value: unknown) => unknown;
export type BeforeParse = (data: string) => string;

export interface Options {
	/**
	Applies a function to the JSON string before parsing.
	*/
	readonly beforeParse?: BeforeParse;

	/**
	Prescribes how the value originally produced by parsing is transformed, before being returned.
	See the [`JSON.parse` docs](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/parse#Using_the_reviver_parameter) for more.
	*/
	readonly reviver?: Reviver;
}

/**
Read and parse a JSON file.

It also strips UTF-8 BOM.

@example
```
import {loadJsonFile} from 'load-json-file';

const json = await loadJsonFile('foo.json');
//=> {foo: true}
```
*/
export function loadJsonFile<ReturnValueType = JsonValue>(filePath: string, options?: Options): Promise<ReturnValueType>;

/**
Read and parse a JSON file.

It also strips UTF-8 BOM.

@example
```
import {loadJsonFileSync} from 'load-json-file';

const json = loadJsonFileSync('foo.json');
//=> {foo: true}
```
*/
export function loadJsonFileSync<ReturnValueType = JsonValue>(filePath: string, options?: Options): ReturnValueType;