File-size module for node.js for converting, manipulating, and handling file-sizes.
- Zero Dependencies.
- Supports IEC (power
1024, default), SI (power1000), and JEDEC (Alternative SI Unit Notation). - Conversion from
bytestoK,M,G, and so forth... - Customizable human-readable output.
$ npm install file-sizeNow require it in your files like so:
var filesize = require('file-size');filesize(Number bytes, Object options)Using filesize is very easy, a lot easier if you know the Specification Table. However, it's not required to know it, and in most cases you won't need it.
Initialization
Filesize works in a jQuery chainable manner so you can use multiple instances without trouble.
var size = filesize(186457865);Options
var size = filesize(186457865, {
fixed: 2,
spacer: ' '
});fixed- Number of positions after the decimal to show, default is2spacer- Space between the number and the unit, default is a space
Generates human readable filesize.
speccan be one of the following:siiecjedec
Default
Power of 1024
// outputs: 177.82 MiB
filesize(186457865).human();Power of 1000
// outputs: 186.46 MB
filesize(186457865).human('si');Changes IEC default unit notation iB to B for the following: KB, MB, GB
The rest are in iB notation, as per JEDEC Specification.
// outputs: 186.46 MB
filesize(186457865).human('jedec');Converts bytes to another filesize unit
unitof size can be one of the following:B,KB,MB,GB,TB,PB,EB,ZB,YB
speccan be one of the following:siiecjedec
Default
// outputs: 177.82
filesize(186457865).to('MB');// outputs: 186.46
filesize(186457865).to('MB', 'si');Calculates suffix, magnitude, fixed, non-fixed, bits (fixed, non-fixed) from specified bytes against the specified spec.
speccan be one of the following:siiecjedec
/*
* outputs:
*
* {
* suffix: 'Bytes',
* magnitude: 0,
* result: 8,
* fixed: '8.00',
* bits: { result: 1, fixed: '1.00' }
* }
*/
var result = filesize(8).calculate()
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent