hash-through

a PassThrough stream that taps to chunks flow and calculates the digest on the fly

Usage no npm install needed!

<script type="module">
  import hashThrough from 'https://cdn.skypack.dev/hash-through';
</script>

README

hash-through

A PassThrough stream that taps to chunks flow and calculates the digest on the fly.

The hashing function has to be supplied. It should be in a form similar to createHash from node crypto module.

Setup

npm install hash-through

Usage

A short example using createHash from node's crypto module:

const HashThrough = require('hash-through')
const crypto = require('crypto')

function createHash(){
  // here we are wrapping a particular implementation
  return crypto.createHash('sha256')
}

const ht = HashThrough(createHash)

// Now we can pipe through and get the digest ready
// by the very time the streaming is over:

const fs = require('fs')
const src = fs.createReadStream(__filename)

src.pipe(ht).pipe(process.stdout)

ht.on('finish', ()=>{
  console.log(ht.digest('hex'))
})

Basically, createHash should be a function with no args that returns a hash object, which in turn should have two methods: hash.update(chunk) and hash.digest(format) with the same meaning as in crypto module

More examples

The test directory contains some more examples of how to plug in different hash algorithms, including both cryptographic functions from node crypto module:

  • sha256
  • sha512
  • ripemd160

as well as some non-cryptographic ones:

Dependencies

For "a stable streams base, regardless of what version of Node you are using" we use readable-stream standalone stream module instead of Node core implementation (read elaboration on this here).

The idea

The point of this module is that original stream can really pass through the hashing instance 'untouched', so it really is a PassThrough stream from external point of view. One can insert one or more instances of it at any points of piping chains without violating the existing streaming logics. Kind of like tapping to the wire or playing man-in-the-middle.