diff options
author | Joel Kronqvist <work.joelkronqvist@pm.me> | 2022-03-11 20:46:06 +0200 |
---|---|---|
committer | Joel Kronqvist <work.joelkronqvist@pm.me> | 2022-03-11 20:46:06 +0200 |
commit | 080c5819d87b933816d724a83f3bf4f1686770a7 (patch) | |
tree | 4a2ccc68b27edf7d4cbc586c932cc7542b655e19 /node_modules/jest-serializer/README.md | |
parent | 5ac7049a9d30733165cc212dee308163c2a14644 (diff) | |
parent | d003b82235a9329f912522a2f70aa950dfce4998 (diff) | |
download | LYLLRuoka-080c5819d87b933816d724a83f3bf4f1686770a7.tar.gz LYLLRuoka-080c5819d87b933816d724a83f3bf4f1686770a7.zip |
Merge branch 'master' of https://github.com/JoelHMikael/FoodJS
Updating remote changes
Diffstat (limited to 'node_modules/jest-serializer/README.md')
-rw-r--r-- | node_modules/jest-serializer/README.md | 47 |
1 files changed, 47 insertions, 0 deletions
diff --git a/node_modules/jest-serializer/README.md b/node_modules/jest-serializer/README.md new file mode 100644 index 0000000..43c8bb1 --- /dev/null +++ b/node_modules/jest-serializer/README.md @@ -0,0 +1,47 @@ +# jest-serializer + +Module for serializing and deserializing object into memory and disk. By default, the `v8` implementations are used, but if not present, it defaults to `JSON` implementation. Both serializers have the advantage of being able to serialize `Map`, `Set`, `undefined`, `NaN`, etc, although the JSON one does it through a replacer/reviver. + +## Install + +```sh +$ yarn add jest-serializer +``` + +## API + +Three kinds of API groups are exposed: + +### In-memory serialization: `serialize` and `deserialize` + +This set of functions take or return a `Buffer`. All the process happens in memory. This is useful when willing to transfer over HTTP, TCP or via UNIX pipes. + +```javascript +import {deserialize, serialize} from 'jest-serializer'; + +const myObject = { + foo: 'bar', + baz: [0, true, '2', [], {}], +}; + +const buffer = serialize(myObject); +const myCopyObject = deserialize(buffer); +``` + +### Synchronous persistent filesystem: `readFileSync` and `writeFileSync` + +This set of functions allow to send to disk a serialization result and retrieve it back, in a synchronous way. It mimics the `fs` API so it looks familiar. + +```javascript +import {readFileSync, writeFileSync} from 'jest-serializer'; + +const myObject = { + foo: 'bar', + baz: [0, true, '2', [], {}], +}; + +const myFile = '/tmp/obj'; + +writeFileSync(myFile, myObject); +const myCopyObject = readFileSync(myFile); +``` |