Home Manual Reference Source Test

MIT license NPM version dependencies coverage build status docs

Corrode is a batteries-included library for reading binary data. It helps you converting that blob-mess into useable data.

Use it to parse that one obscure binary-file with the help of JavaScript.


$ npm install --save corrode


$ npm test

Offline Docs

$ npm run docs
$ open doc/index.html

What's this?

corrode provides standard read-actions like uint8-uint64 for big & little endian, strings, buffers and control-structures like loops, skipping, etc. for your buffers and files. Additionally you can use assertions to always be sure, the data you parse corresponds to a specified format. The parsing is done not by a configuration-object, but by imperative code, allowing for far greater flexibility.

corrode is an abstraction on top of TransformStream and as such is pipeable to but also provides functions for more simple usage.

This library is not only heavily inspired by dissolve, it in fact can be seen as a total rewrite with even more features. The code is written in ES7, fully documented and tested.

Quick examples

const Corrode = require('corrode');
const parser = new Corrode();

        console.log(this.vars.val_1 * this.vars.val_3);
    .repeat('array', 5, function(){
            .string('array_val_4', 5);

Parsing a buffer

parser.fromBuffer(buffer, () => console.log(parser.vars));

Parsing a filestream

var stream = fs.createReadStream(file);
parser.on('finish', () => console.log(parser.vars));

These are just some of the very basic operations supported by Corrode.


All examples can be found in the examples/-folder. Included:

If you'd like to include your own examples, just open a PR. I'm more than happy to not have to think about existing complex structured binary data to parse myself.

Documentation & API Reference

Why use corrode over dissolve

It solves most of the major shortcomings dissolve has:

When not to use corrode

Not yet included are additions like bignum-support for int64 and additional non-node-standard-encodings.

corrode is currently not tested for use in browsers.

Used dependencies (3)

The following dependencies are installed when installing corrode:


This library is issued under the MIT license.

The Logo is from The Noun Project, created by Michael Senkow and licensed under the CC-BY-3.0.