File-size.js

File-size module for node.js for converting, manipulating, and handling file-sizes.

Features

• Zero Dependencies.
• Supports IEC (power 1024, default), SI (power 1000), and JEDEC (Alternative SI Unit Notation).
• Conversion from bytes to K, M, G, and so forth...
• Customizable human-readable output.

Installation

1$ npm install file-size

Now require it in your files like so:

1var filesize = require('file-size');

Usage

1filesize(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.

1var size = filesize(186457865);

Options

1var size = filesize(186457865, {
2  fixed: 2,
3  spacer: ' '
4});

• fixed - Number of positions after the decimal to show, default is 2
• spacer - Space between the number and the unit, default is a space

size.human(String spec) -> String

Generates human readable filesize.

• spec can be one of the following:
  • si
  • iec
  • jedec

IEC Specification

Default

Power of 1024

1// outputs: 177.82 MiB
2filesize(186457865).human();

SI Specification

Power of 1000

1// outputs: 186.46 MB
2filesize(186457865).human('si');

JEDEC Specification

Changes IEC default unit notation iB to B for the following: KB, MB, GB

The rest are in iB notation, as per JEDEC Specification.

1// outputs: 186.46 MB
2filesize(186457865).human('jedec');

size.to(String unit, String spec) -> String

Converts bytes to another filesize unit

• unit of size can be one of the following:
  • B, KB, MB, GB, TB, PB, EB, ZB, YB
• spec can be one of the following:
  • si
  • iec
  • jedec

IEC Specification

Default

1// outputs: 177.82
2filesize(186457865).to('MB');

SI Specification

1// outputs: 186.46
2filesize(186457865).to('MB', true);

size.calculate(String spec) -> Object

Calculates suffix, magnitude, fixed, non-fixed, bits (fixed, non-fixed) from specified bytes against the specified spec.

• spec can be one of the following:
  • si
  • iec
  • jedec

1/*
2 * outputs:
3 *
4 *    {
5 *      suffix: 'Bytes',
6 *      magnitude: 0,
7 *      result: 8,
8 *      fixed: '8.00',
9 *      bits: { result: 1, fixed: '1.00' }
10 *    }
11*/
12
13var result = filesize(8).calculate()