To help you get started, we've collected the most common ways that ts-md5 is being used within popular public projects.

foli / ngFire-Course / src / app / shared / upload / upload.service.ts View on Github

uploadTask(path, file, meta, uploadType) {
    const nameHash = Md5.hashStr(file.name + new Date().getTime());
    const fileExt = file.type.split('/')[1];
    const name = `${nameHash}.${fileExt}`;

    const newMeta = {
      ...meta,
      someMoreData: 'Moooore data'
    };

    const ref = this.storage.ref(`${path}/${name}`);
    const task = ref.put(file, { customMetadata: newMeta });

    // add the following lines
    task.snapshotChanges().pipe(
      finalize(() => {
        this.downloadURL = ref.getDownloadURL();
        console.log('Image Uploaded!');

View more ways to use ts-md5

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: https://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:

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.

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