Terrible-Bytes 🍰

Convey size information in human friendly format to your js runtime.
Bid adieu to those numbers without units 🥳.

Simple to use, Easy to Understand

import {b} from 'terrible-bytes';

const uploadLimitBytes = b`8MB`
const xInBytes = b`5G` + b`640M` // approx. 5.64Gigabytes
const yInBytes = b`5.64G`       // approximately similar to above

Interpolation Support

const filesize = 256;
const unit = 'MiB';

const lol = b`${filesize}${unit}`;
const xox = b`468 ${unit}`;

Let's get rid of those KB, MB, GB constants. And stop doing size=8*MB

Installation

npm install terrible-bytes

Supported Units

Only S.I and ISO/IEC standard unit prefixes are allowed.
In the case of K we make an exception and treat it as kilobyte.
However, a warning is consoled when K is provided as the unit.

The ISO and IEC table are given below for the sake of convenience,

Value	SI Unit
1000	k	kilo
10002	M	mega
10003	G	giga
10004	T	tera
10005	P	peta
10006	E	exa
10007	Z	zetta
10008	Y	yotta

Value	IEC	Unit
1000	Ki	kibi
10002	Mi	mebi
10003	Gi	gibi
10004	Ti	tebi
10005	Pi	pebi
10006	Ei	exbi
10007	Zi	zebi
10008	Yi	yobi

Apart from the values in the table, 'B' can be used to mean byte. Here are some valid strings

[ 
  b`4`, 
  b`4B`,
  b`4M`,
  b`4MB`,
  b`4Mi`, 
  b`4MiB`,
]

You can read more about unit prefixes in wikipedia

What Does this have that other libs don't?

1. I haven't seen the use of tagged template for specifying sizes before(its probably because i haven't looked hard enough)
2. Does this question have to be strawmaned every time someone reinvents the wheel :|
3. Idk, go use the other lib if you like that better, no one has the authority to stop you from doing that champ. May the 🪄 help in your journey.

License

Libre Expat(MIT) License