A high-performance pure-javascript SHA1 implementation suitable for large binary data.
npm install rushaA high-performance pure-javascript SHA1 implementation suitable for large binary data.
  
Rusha is available via npm:
``
npm install rusha
Rusha is available via bower:
`
bower install rusha
It is highly recommended to run CPU-intensive tasks in a Web Worker. To do so, just follow the instructions on _Using the Rusha Worker_.
If you have a good reason not to use Web Workers, follow the instructions on _Using the Rusha Hash API_ instead.
#### Spawning workers
You can create a new worker in two ways. The preferred way is using Rusha.createWorker(), which spawns a webworker containing the hashing logic, and returns back a Worker object:
`js`
const worker = Rusha.createWorker();
If for some reason this does not work for you, you can also just point the Worker constructorrusha.js
at or rusha.min.js, like so:
`js`
const worker = new Worker("dist/rusha.min.js");
> _Note: In order to make the latter work, Rusha will by default subscribe to incoming messages
when it finds itself inside a worker context. This can lead to problems when you would like to use Rusha as a library inside a web worker, but still have control over the messaging. To disable this behaviour, you can call Rusha.disableWorkerBehaviour() from within the worker._
#### Communicating with the worker
You can send your instance of the web worker messages in the format {id: jobid, data: dataobject}. The worker then sends back a message in the format {id: jobid, hash: hash}, were jobid is the id of the job previously received and hash is the hash of the data-object you passed, be it a Blob, Array, Buffer, ArrayBuffer or String
The Rusha Hash API is inspired by the Node.js Hash API.
#### Examples
##### Simple usage
`js`
const hexHash = Rusha.createHash().update('I am Rusha').digest('hex');
##### Incremental usage
`js`
const hash = Rusha.createHash();
hash.update('I am');
hash.update(' Rusha');
const hexHash = rusha.digest('hex');
#### Reference
You instantiate a new Hash object by calling Rusha.createHash().
##### Methods
- update(data): Update the hash state with the given data, which can be a binary String, Buffer, Array or ArrayBuffer.digest([encoding])
- : Calculates the digest of all of the data passed to be hashed. The encoding can be 'hex' or undefined. If encoding is provided a string will be returned; otherwise an ArrayBuffer is returned.
> _Note: Due to its synchronous nature, Hash#update does not accept data of type Blob. If you need to work with Blobs, you can either use the Rusha Worker, or use FileReader#readAsArrayBuffer to read the contents of the Blob, and then invoke Hash#update with the ArrayBuffer that was returned._
##### Properties
- state (getter and setter): Allows getting and setting the internal hashing state.
The Rusha Object API is deprecated, and is only documented here for older code bases that might still be using it.
You should be using the Hash API instead, which is documented above.
#### Examples
##### Normal usage
`js`
const rusha = new Rusha();
const hexHash = rusha.digest('I am Rusha');
##### Incremental usage
`js`
const rusha = new Rusha();
rusha.resetState();
rusha.append('I am');
rusha.append(' Rusha');
const hexHash = rusha.end();
#### Reference
Your instantiate a new Rusha object by doing new Rusha(). When created, it provides the following methods:
- digest(d): Create a hex digest from data of the three kinds mentioned below, or throw and error if the type is unsupported.digestFromString(s)
- : Create a hex digest from a binary String. A binary string is expected to only contain characters whose charCode < 256.digestFromBuffer(b)
- : Create a hex digest from a Buffer or Array. Both are expected to only contain elements < 256.digestFromArrayBuffer(a)
- : Create a hex digest from an ArrayBuffer object.rawDigest(d)
- : Behaves just like #digest(d), except that it returns the digest as an Int32Array of size 5.resetState()
- : Resets the internal state of the computation.append(d)
- : Appends a binary String, Buffer, Array, ArrayBuffer or Blob.setState(state)
- : Sets the internal computation state. See: getState().setState()
- : Returns an object representing the internal computation state. You can pass this state to setState(). This feature is useful to resume an incremental sha.end()
- : Finishes the computation of the sha, returning a hex digest.rawEnd()
- : Behaves just like #end(), except that it returns the digest as an Int32Array of size 5.
* Download npm dependencies with npm install
* Make changes to the files in
* Build with
* Run tests with
Tested were my Rusha implementation, the sha1.js implementation by P. A. Johnston, Tim Caswell's Cifre and the Node.JS native implementation.
If you want to check the performance for yourself in your own browser, I compiled a JSPerf Page.
A normalized estimation based on the best results for each implementation, smaller is better:
!rough performance graph
Results per Implementation and Platform:
!performance chart
All tests were performed on a MacBook Air 1.7 GHz Intel Core i5 and 4 GB 1333 MHz DDR3.