@mandel59/memoized-json-hash
v0.2.0
Published
Generate hashes from javascript objects in node and the browser.
Downloads
10
Maintainers
Readme
memoized-json-hash
Generate hashes of serializable objects. Based on json-stable-stringify
by @substack, but memoizes the intermediate strings to improve performance. This only makes sense when hashing objects that frequently contain the same objects. Furthermore, this utility assumes that the input data is immutable. In other words, the function will return wrong results if you mutate the input between invocations!
Usage:
import jsonHash from 'memoized-json-hash'; // const jsonHash = require('memoized-json-hash').default;
const hash = jsonHash({foo: 'bar', bar: 'baz'});
// -> '7337b77ab6e6c7eb8e0ccd547591f6b926cec1e6'
// With options...
const options = {
algorithm: 'none'
}
const json = jsonHash({foo: 'bar', bar: 'baz'}, options);
// -> '{"foo":"bar","bar":"baz"}'
interface Options {
/**
* Which hashing algorithm to use. Specify 'none' to return a deterministic JSON string.
*
* Default: 'sha1'
*/
algorithm: 'none' | 'sha1' | 'sha256' | 'sha512' | 'md5'
/**
* Whether to allow recursive structures.
*
* Default: false
*/
cycles: boolean,
/**
* Whether to use the cache (memoization).
*
* Default: true
*/
cache: boolean
}