bytes2 v1.0.1

bytes2

  _______ ___ ___ _______ _______ _______ _______
 |   _   |   Y   |       |   _   |   _   |       |
 |.  1   |   1   |.|   | |.  1___|   1___|___|   |
 |.  _   \\_   _/`-|.  |-|.  __)_|____   |/  ___/
 |:  1    \|:  |   |:  | |:  1   |:  1   |:  1  \
 |::.. .  /|::.|   |::.| |::.. . |::.. . |::.. . |
 `-------' `---'   `---' `-------`-------`-------'

Convert bytes to another unit of information.

Note Implementation based on this wikipedia article.

Note Some related modules:

• byte-converter
• bytes

Install

npm install bytes2

Examples

Require the module:

var bytes2 = require('bytes2');

Convert 1000 bytes to KB:

var value = bytes2('KB', 1000)
console.log(value) // 1

Convert 1000 bytes to KiB:

var value = bytes2('KiB', 1000)
console.log(value) // 0.9765625

Convert 1000 bytes to KiB, showing only 2 decimal places:

var value = bytes2('KiB', 1000, { decimals: 2 })
console.log(value) // 0.98

Convert 1000 bytes to KiB, prepending the units:

var value = bytes2('KiB', 1000, { prepend: true })
console.log(value) // '0.9765625 KiB'

Convert 1000 bytes to jedecKB, prepending the units:

var value = bytes2('jedecKB', 1000, { prepend: true })
console.log(value) // '0.9765625 KB'

Convert 1000 bytes to KiB, showing only 3 decimal places, prepending the units and using '-' as the seperator:

var value = bytes2('KiB', 1000, {
  decimals: 3,
  prepend: true,
  seperator: '-',
})
console.log(value) // '0.977-KiB'

bytes2(to, bytes, opts)

Returns bytes in to units of information.

Base-10, decimal, SI and metric:

Base-2, binary and IEC

JEDEC

Note JEDEC options works basically the same as the base-2 ones, except that if you use the prepend option, it will, for example, correctly add 'KB' and not 'KiB'.

Testing

Using Mocha:

npm install
npm test

Contributing

Just send a PR, or create an issue if you are not sure.

Areas ripe for contribution:

• performance
• bugs

License

MIT