Generates a unique string from a parameter.

I cannot say this library will not change. Please only use this for short term hashing purposes, or lock the version you are using of this library.

Given a parameter in javascript if we wanted to hash it we would first need to convert it into a string, that's what this library aims to do. It will create a hashable string from just about anything.

const paramToString = require('param-to-string');

paramToString('hello there');
// string:hello%20there;

We can create a string from arrays, objects and more.

const paramToString = require('param-to-string');

paramToString([11, 21, 'hello there']);
// array:number:11;number:21;string:hello%20there;;

'array:{paramToString(param[index])};{...etc};;'

Object keys are sorted alphabetically.

'object:{key}:{paramToString(param[key])};{...etc};;'

'date:{utc(param)};'

'null;'

'undefined;'

Functions are rendered to strings.

'function:{param.name}:{escape(stringify(param))};'

The following types are converted into an array prepended with their actual type. ['uint8array', 'uint8clampedarray', 'int8array', 'uint16array', 'int16array', 'uint32array', 'int32array', 'float32array', 'float64array', 'arraybuffer', 'set', 'weakset'] In the following format.

'type(param):array:{...etc};;'

The following types are converted into an object prepended with their actual type. ['map', 'weakmap'] In the following format.

'type(param):object:{...etc};;'

You can nest arrays and objects.

'{type(param)}:{escape(stringify(param))};'

Object keys are sorted alphabetically. It doesn't matter what order parameters are inserted in the object, this is true for how Map and Weakmap are handled as well, insertion order is ignored. Functions are rendered to strings.

Sure!