WASM/Web-Assembly implementation of Google's FarmHash family of very fast hash functions for use in node.js and the browser. FarmHash is the successor to CityHash. Functions in the FarmHash family are not suitable for cryptography.
The existing farmhash npm packge works great if you can get it to build, but this can create a lot of pain. This WASM build should work on any operating system that uses node.js with zero extra configuration. It should be 100% consistent across different platforms. You can even use it in the browser. This package also includes TypeScript types, and a handy bigqueryFingerprint
that matches BigQuery's FARM_FINGERPRINT
function.
This WASM implementation is built using the farmhash Rust Crate. The 64-bit APIs use JavaScript's BigInt type to represent results. If you need a base-10 string, you can simply call .toString()
on the result.
Install using npm or yarn.
npm install farmhash-modern
# or
yarn install farmhash-modern
Import using ES Module syntax or CommonJS syntax.
import * as farmhash from 'farmhash-modern';
console.log(farmhash.fingerprint32('hello world'));
or
const farmhash = require('farmhash-modern');
console.log(farmhash.fingerprint32('hello world'));
npm install farmhash-modern
# or
yarn install farmhash-modern
In your webpack.config.js
file, make sure you have set:
module.exports = {
// ...
experiments: {asyncWebAssembly: true},
// ...
};
Also, make sure you do not have any rules that will capture .wasm
files and turn them into URLs or some other format.
Import using ES Module syntax syntax.
import * as farmhash from 'farmhash-modern';
console.log(farmhash.fingerprint32('hello world'));
Create a new farmhash based u32 for a string or an array of bytes. Fingerprint value should be portable and stable across library versions and platforms.
Create a new farmhash based u64 for a string or an array of bytes. Fingerprint value should be portable and stable across library versions and platforms.
Create a new farmhash based i64 for a string or an array of bytes. Fingerprint value should be portable and stable across library versions and platforms.
This matches the format used by BigQuery's FARM_FINGERPRINT function.
Create a new farmhash based u32 for an array of bytes. Hash value may vary with library version.
Create a new farmhash based u32 for an array of bytes with a given seed. Hash value may vary with library version.
Create a new farmhash based u64 for an array of bytes. Hash value may vary with library version.
Create a new farmhash based u64 for an array of bytes with a given seed. Hash value may vary with library version.
- Install dependencies for farmhash-modern:
yarn install
- Build farmhash-modern:
yarn build
- Install dependencies for web-app:
cd web-app && npm install
- Build the web-app:
cd web-app && npm build
MIT