js-md5

A simple and fast MD5 hash function for JavaScript supports UTF-8 encoding.

Demo

MD5 Online
MD5 File Checksum Online

Download

Compress
Uncompress

Benchmark

jsPerf Benchmark
File Benchmark

Installation

You can also install js-md5 by using Bower.

bower install md5

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

npm install js-md5

Notice

buffer method is deprecated. This maybe confuse with Buffer in node.js. Please use arrayBuffer instead.

Usage

You could use like this:

1md5('Message to hash');
2var hash = md5.create();
3hash.update('Message to hash');
4hash.hex();
5
6// HMAC
7md5.hmac('key', 'Message to hash');
8
9var hash = md5.hmac.create('key');
10hash.update('Message to hash');
11hash.hex();

Node.js

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

1var md5 = require('js-md5');

TypeScript

If you use TypeScript, you can import like this:

1import { md5 } from 'js-md5';

RequireJS

It supports AMD:

1require(['your/path/md5.js'], function(md5) {
2// ...
3});

See document

Example

1md5(''); // d41d8cd98f00b204e9800998ecf8427e
2md5('The quick brown fox jumps over the lazy dog'); // 9e107d9d372bb6826bd81d3542a419d6
3md5('The quick brown fox jumps over the lazy dog.'); // e4d909c290d0fb1ca068ffaddf22cbd0
4
5// It also supports UTF-8 encoding
6md5('中文'); // a7bac2239fcdcb3a067903d8077c4a07
7
8// It also supports byte `Array`, `Uint8Array`, `ArrayBuffer`
9md5([]); // d41d8cd98f00b204e9800998ecf8427e
10md5(new Uint8Array([])); // d41d8cd98f00b204e9800998ecf8427e
11
12// Different output
13md5(''); // d41d8cd98f00b204e9800998ecf8427e
14md5.hex(''); // d41d8cd98f00b204e9800998ecf8427e
15md5.array(''); // [212, 29, 140, 217, 143, 0, 178, 4, 233, 128, 9, 152, 236, 248, 66, 126]
16md5.digest(''); // [212, 29, 140, 217, 143, 0, 178, 4, 233, 128, 9, 152, 236, 248, 66, 126]
17md5.arrayBuffer(''); // ArrayBuffer
18md5.buffer(''); // ArrayBuffer, deprecated, This maybe confuse with Buffer in node.js. Please use arrayBuffer instead.
19md5.base64(''); // 1B2M2Y8AsgTpgAmY7PhCfg==
20
21// HMAC
22md5.hmac.hex('key', 'Message to hash');
23md5.hmac.array('key', 'Message to hash');
24// ...

License

The project is released under the MIT license.

Contact

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