| README.mdView |
|---|
| 1 | | -# SYNOPSIS |
| 1 … | +# SYNOPSIS |
| 2 | 2 … | |
| 3 | 3 … | [](https://www.npmjs.org/package/wasm-persist) |
| 4 | 4 … | [](https://travis-ci.org/dfinity/wasm-persist) |
| 5 | 5 … | [](https://coveralls.io/r/dfinity/wasm-persist) |
| 6 | 6 … | |
| 7 | | -[](https://github.com/feross/standard) |
| 7 … | +[](https://github.com/feross/standard) |
| 8 | 8 … | |
| 9 | | -This allows you to hibernate a WebAssembly instance and later start it up again |
| 10 | | -at the exact place you left off |
| 9 … | +This allows you to hibernate a WebAssembly instance and later start it up again at the exact place you left off. |
| 11 | 10 … | |
| 12 | 11 … | # INSTALL |
| 13 | 12 … | `npm install wasm-persist` |
| 14 | 13 … | |
| 18 | 17 … | const persist = require('wasm-persist') |
| 19 | 18 … | ... |
| 20 | 19 … | wasm = persist.prepare(wasm) |
| 21 | 20 … | const {instance} = await WebAssembly.instantiate(wasm) |
| 22 | | -// call some exported functions on your instance |
| 21 … | +// call some exported functions on your instance |
| 23 | 22 … | // then when you are done |
| 24 | 23 … | const state = persist.hibernate(instance) |
| 25 | 24 … | |
| 26 | 25 … | ... |
| 29 | 28 … | const {instance} = await WebAssembly.instantiate(wasm) |
| 30 | 29 … | // just call persist.resume with the old state |
| 31 | 30 … | persist.resume(instance, state) |
| 32 | 31 … | ``` |
|
| 33 | | -# DESCIPTION |
| 34 | | -The Idea for wasm-persist came from [orthongal persistance](https://en.wikipedia.org/wiki/Persistence_(computer_science)#Orthogonal_or_transparent_persistence) |
| 35 | | -wasm-persist injects getter and setter function for each global and exports the |
| 36 | | -memory and table if they exist. Hibernate calls the getters and creates an Object |
| 37 | | -that contains the memory (as a typedArray) the globals and the function table. |
| 38 | | -Resume does the opposite and calls the setters for the globals and updates the |
| 39 | | -memory and the table. Forgein function on the table are not handled currently. |
| 40 | 32 … | |
| 33 … | +# DESCRIPTION |
| 34 … | +The Idea for wasm-persist came from [orthogonal persistence](https://en.wikipedia.org/wiki/Persistence_(computer_science)#Orthogonal_or_transparent_persistence). wasm-persist injects getter and setter function for each global and exports the |
| 35 … | +memory and table if they exist. Hibernate calls the getters and creates an Object that contains the memory (as a typedArray), the globals, and the function table. Resume does the opposite and calls the setters for the globals and updates the memory and the table. Foreign functions on the table are not handled currently. |
| 36 … | + |
| 41 | 37 … | # API |
| 42 | 38 … | [./docs/](./docs/index.md) |
| 43 | 39 … | |
| 44 | 40 … | # LICENSE |