The definitive source of the best
JavaScript libraries, frameworks, and plugins.

  • ×

    High-performance pure-javascript SHA1 implementation suitable for large binary data, reaching up to half the native speed.
    Filed under 

    • 🔾26%Overall
    • 275
    • 34.2 days
    • 🕩37
    • 👥12


    A high-performance pure-javascript SHA1 implementation suitable for large binary data.

    npm npm Build Status



    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.

    Using the Rusha Worker

    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:

    const worker = Rusha.createWorker();

    If for some reason this does not work for you, you can also just point the Worker constructor at rusha.js or rusha.min.js, like so:

    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

    Using the Rusha Hash API

    The Rusha Hash API is inspired by the Node.js Hash API.


    Simple usage
    const hexHash = Rusha.createHash().update('I am Rusha').digest('hex');
    Incremental usage
    const hash = Rusha.createHash(); 
    hash.update('I am');
    hash.update(' Rusha');
    const hexHash = rusha.digest('hex');


    You instantiate a new Hash object by calling Rusha.createHash().

    • 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.

    • state (getter and setter): Allows getting and setting the internal hashing state.

    Using the Rusha Object (DEPRECATED)

    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.


    Normal usage
    const rusha = new Rusha();
    const hexHash = rusha.digest('I am Rusha');
    Incremental usage
    const rusha = new Rusha();
    rusha.append('I am');
    rusha.append(' Rusha');
    const hexHash = rusha.end();


    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 src/
    • Build with npm run build
    • Run tests with npm test


    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.

    Show All