Repository files navigation

filesize.js provides a simple way to get a human readable file size string from a number (float or integer) or string.

filesize() accepts an optional descriptor Object as a second argument, so you can customize the output.

(number) Number base, default is2

(boolean) Enablesbit sizes, default isfalse

(number) Specifies the SI suffix via exponent, e.g.2 isMB for bytes, default is-1

(string) Output of function (array,exponent,object, orstring), default isstring

(number) Decimal place, default is2

(string) Character between theresult andsuffix, default is" "

(string) Standard unit of measure, can beiec orjedec, default isjedec; can be overruled bybase

(object) Dictionary of SI/JEDEC symbols to replace for localization, defaults to english if no match is found

(object) Dictionary of SI/JEDEC symbols to replace for localization, defaults to english if no match is found

(boolean) Enables unix style human readable output, e.gls -lh, default isfalse

filesize(500);// "500 B"filesize(500,{bits:true});// "4 Kb"filesize(265318,{base:10});// "265.32 kB"filesize(265318);// "259.1 KB"filesize(265318,{round:0});// "259 KB"filesize(265318,{output:"array"});// [259.1, "KB"]filesize(265318,{output:"object"});// {value: 259.1, suffix: "KB", symbol: "KB"}filesize(1,{symbols:{B:"Б"}});// "1 Б"filesize(1024);// "1 KB"filesize(1024,{exponent:0});// "1024 B"filesize(1024,{output:"exponent"});// 1filesize(265318,{standard:"iec"});// "259.1 KiB"

filesize.js supports AMD loaders (require.js, curl.js, etc.), node.js & npm (npm install filesize), or using a script tag.

Copyright (c) 2016 Jason MulliganLicensed under the BSD-3 license.