You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
102 lines
2.3 KiB
102 lines
2.3 KiB
2 years ago
|
# Introduction
|
||
|
|
|
||
|
|
A MD5 implementation for TypeScript
|
||
|
|
|
||
|
|
* Can handle Unicode strings
|
||
|
|
* Supports incremental hashing
|
||
|
|
* Works with Files and Blobs
|
||
|
|
|
||
|
|
This library also includes tools for:
|
||
|
|
|
||
|
|
* Hashing a file or blob
|
||
|
|
* A webworker for performing hashing
|
||
|
|
* A webworker handler for requesting files or blobs to be hashed
|
||
|
|
* promise based
|
||
|
|
* files or blobs are queued for processing on the webworker
|
||
|
|
|
||
|
|
|
||
|
|
Based on work by
|
||
|
|
|
||
|
|
* Joseph Myers: http://www.myersdaily.org/joseph/javascript/md5-text.html
|
||
|
|
* André Cruz: https://github.com/satazor/SparkMD5
|
||
|
|
* Raymond Hill: https://github.com/gorhill/yamd5.js
|
||
|
|
|
||
|
|
|
||
|
|
## Usage
|
||
|
|
|
||
|
|
### Install
|
||
|
|
|
||
|
|
Install the node module with `npm install ts-md5`
|
||
|
|
|
||
|
|
### Basic Hashing
|
||
|
|
|
||
|
|
1. Import the class
|
||
|
|
* `import {Md5} from 'ts-md5';`
|
||
|
|
2. Hash some things
|
||
|
|
* `Md5.hashStr('blah blah blah')` => hex:string
|
||
|
|
* `Md5.hashStr('blah blah blah', true)` => raw:Int32Array(4)
|
||
|
|
* `Md5.hashAsciiStr('blah blah blah')` => hex:string
|
||
|
|
* `Md5.hashAsciiStr('blah blah blah', true)` => raw:Int32Array(4)
|
||
|
|
|
||
|
|
For more complex uses:
|
||
|
|
|
||
|
|
```typescript
|
||
|
|
|
||
|
|
md5 = new Md5();
|
||
|
|
|
||
|
|
// Append incrementally your file or other input
|
||
|
|
// Methods are chainable
|
||
|
|
md5.appendStr('somestring')
|
||
|
|
.appendAsciiStr('a different string')
|
||
|
|
.appendByteArray(blob);
|
||
|
|
|
||
|
|
// Generate the MD5 hex string
|
||
|
|
md5.end();
|
||
|
|
|
||
|
|
```
|
||
|
|
|
||
|
|
|
||
|
|
### Hashing a File
|
||
|
|
|
||
|
|
NOTE:: You have to make sure `ts-md5/dist/md5_worker.js` is made available in your build so it can be accessed directly by a browser
|
||
|
|
It should always remain as a seperate file.
|
||
|
|
|
||
|
|
```typescript
|
||
|
|
|
||
|
|
import {ParallelHasher} from 'ts-md5';
|
||
|
|
|
||
|
|
let hasher = new ParallelHasher('/path/to/ts-md5/dist/md5_worker.js');
|
||
|
|
hasher.hash(fileBlob).then(function(result) {
|
||
|
|
console.log('md5 of fileBlob is', result);
|
||
|
|
});
|
||
|
|
|
||
|
|
```
|
||
|
|
|
||
|
|
|
||
|
|
## Building from src
|
||
|
|
|
||
|
|
The project is written in typescript and transpiled into ES5.
|
||
|
|
|
||
|
|
1. Install TypeScript: `npm install -g typescript` (if you haven't already)
|
||
|
|
2. Configure compile options in `tsconfig.json`
|
||
|
|
3. Perform build using: `tsc`
|
||
|
|
|
||
|
|
You can find more information here: https://github.com/Microsoft/TypeScript/wiki/tsconfig.json
|
||
|
|
|
||
|
|
## Scripts
|
||
|
|
|
||
|
|
1. Build Script: `npm run build`
|
||
|
|
2. Test Script: `npm run test`
|
||
|
|
|
||
|
|
|
||
|
|
## Publishing
|
||
|
|
|
||
|
|
1. Sign up to https://www.npmjs.com/
|
||
|
|
2. Configure `package.json` https://docs.npmjs.com/files/package.json
|
||
|
|
3. run `npm publish` https://docs.npmjs.com/cli/publish
|
||
|
|
|
||
|
|
|
||
|
|
# License
|
||
|
|
|
||
|
|
MIT
|