fast-json - GitLite

KO | EN

gitlite — search

#javascript #ai #typescript #llm #golang #deep-learning #macos #nodejs #windows #awesome #kubernetes #vue #pytorch #mcp

fast-json

(★ 136)

A lightning fast on the fly JSON parser

파일 탐색기

최종 버전 다운로드 (.zip)

- extensions.json
- settings.json
- FastJson.js
- index.js
- package-lock.json
- package.json
- - big.json
  - citylots.json.tar.gz
  - small.json
- basic.js
- customPathSeparator.js
- performance.js
- skip.js
- constants.ts
- EventTree.ts
- FastJson.ts
- index.ts
- Node.ts
- Tree.ts
- types.ts
- EventTree.test.ts
- FastJson.test.ts
- index.test.ts
.editorconfig
.eslintrc.json
.gitignore
.prettierrc
CHANGELOG.md
jest.config.json
package-lock.json
package.json
README.md
tsconfig.build.json
tsconfig.json

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/alemures/fast-json

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd fast-json

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Node.js

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Node.js npm 명령어를 쓰려면 Node.js가 설치되어 있어야 합니다. LTS(장기지원) 버전을 추천합니다.

npm install fast-json

package.json에 명시된 라이브러리들을 내려받아 설치합니다.

✅ 명령어 실행 후 터미널에 나타나는 주소(보통 http://localhost:3000 형태)를 브라우저에서 열어보세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# fast-json

A lightning fast on the fly **JSON parser** able to return JSON values and structures from plain JSON as `String` or `Buffer`. It's much faster than JSON.parse() and doesn't require any extra memory allocation for the data processed.

## Install

```
npm install fast-json
```

## Usage

```javascript
const { FastJson } = require('fast-json');

const data = JSON.stringify({
  ireland: {
    people: [{ name: 'Alex' }, { name: 'John' }, { name: 'Cian' }],
  },
  spain: {
    people: [{ name: 'Antonio' }, { name: 'Juan' }, { name: 'Pedro' }],
  },
});

const fastJson = new FastJson();

// Path is a string representing a javascript object path
fastJson.on('ireland.people', (value) => {
  console.log('ireland.people ->', value);
});

// Paths can be also an array of keys
fastJson.on(['spain', 'people', '1', 'name'], (value) => {
  console.log(['spain', 'people', '1', 'name'], '->', value);
});

// Wildcards can be used to match all items in object or array
fastJson.on('spain.people[*].name', (value) => {
  console.log('spain.people[*].name ->', value);
});

fastJson.on('*.people[*].name', (value) => {
  console.log('*.people[*].name ->', value);
});

fastJson.write(data);
// The JSON can be string or Buffer
// fastJson.write(Buffer.from(data))
```

```javascript
fastJson.on('ireland.people[1].name', (value) => {
  console.log('ireland.people[1].name ->', value);
  // Once we have all we need, we can skip the rest of the JSON to improve performance.
  fastJson.skip();
});
```

```javascript
// Path separator defines the keys separator on the listeners
const fastJson = new FastJson({ pathSeparator: '/' });

// In this case it allows keys having dots by using a different separator
fastJson.on('unknown.country/people/0/name', (value) => {
  console.log('unknown.country/people/0/name ->', value);
});
```

## Performance

JSON file _citylots.json_ of **189MB** from https://github.com/zemirco/sf-city-lots-json.

- **fast-json: 0.56s / 198MB RAM**
- JSON.parse: 1.8s / 640MB RAM
- jsonparse: 15.0s / 1,100MB RAM (Only reading, it wasn't able to return a value)

## TODO

- [**Feature**] Allow chunked JSON.
- [**Feature**] Match more glob patters.
- [**Feature**] Add more flexibility to event listeners (on, once, off, etc).
- [**Documentation**] Create branch gh-pages using _jsdoc_.
- [**Documentation**] More real life testing and examples.