js-crc

Simple CRC checksum functions for JavaScript. Supports many predefined models such as CRC-8, CRC-16, CRC-24, CRC-32, and CRC-64. It also supports custom CRC models.

Download

Core

Compress
Uncompress

Models

Compress
Uncompress

Installation

You can also install js-crc by using Bower.

bower install js-crc

For node.js, you can use this command to install:

npm install js-crc

Import

There are only 2 default models in js-crc. crc32 and crc16. More models are in js-crc/models. You can check all models in this file. The name and alias will convert to lower snake case and export. For example, CRC-64/ECMA-182 will convert to crc_64_ecma_182.

Node.js

If you use node.js, you should require the module first:

1var crc32 = require('js-crc').crc32;
2var crc16 = require('js-crc').crc16;
3var crc_64_ecma_182 = require('js-crc/models').crc_64_ecma_182;

or

1const { crc32, crc16 } = require('js-crc');
2const { crc_64_ecma_182 } = require('js-crc/models');

TypeScript

If you use TypeScript, you can import like this:

1import { crc32, crc16 } from 'js-crc';
2import { crc_64_ecma_182 } from 'js-crc/models';

RequireJS

It supports AMD:

1require(['your/path/crc.js'], function (crc) {
2  var crc32 = crc.crc32;
3  var crc16 = crc.crc16;
4  // ...
5});

Usage

Basic

You could use like this:

1crc32('Message to check');
2crc16('Message to check');
3
4var crc = crc32.create();
5crc.update('Message to check');
6crc.hex();
7
8var crc2 = crc32.update('Message to check');
9crc2.update('Message2 to check');
10crc2.array();

Custom Model

You can create custom model:

1const { createModel } = require('js-crc');
2var myModel = createModel({
3  width: 16,
4  poly: 0x8005,
5  init: 0x0000,
6  refin: true,
7  refout: true,
8  xorout: 0x0000
9});
10myModel('Message to check');

If width more than 32, poly, init and xorout have to split into an array of 32-bit numbers. For example

1createModel({
2  width: 82,
3  poly: [0x0308c, 0x01110114, 0x01440411],
4  init: [0, 0, 0],
5  refin: true,
6  refout: true,
7  xorout: [0, 0, 0]
8})

Example

1crc32('The quick brown fox jumps over the lazy dog'); // 414fa339
2crc32('The quick brown fox jumps over the lazy dog.'); // 519025e9
3
4// It also supports byte `Array`, `Uint8Array`, `ArrayBuffer` input:
5crc32([0]); // d202ef8d
6crc32(new Uint8Array([0])); // d202ef8d

License

The project is released under the MIT license.

Contact

The project's website is located at https://github.com/emn178/js-crc
Author: Chen, Yi-Cyuan (emn178@gmail.com)