Adding fullforms for overriding full form

Author: avoidwork

README.md

@@ -20,6 +20,9 @@ _*(number)*_ Specifies the SI suffix via exponent, e.g. `2` is `MB` for bytes, d
 ### fullform
 _*(boolean)*_ Enables full form of unit of measure, default is `false`
 
+### fullforms
+_*(array)*_ Array of full form overrides, default is `[]`
+
 ### output
 _*(string)*_ Output of function (`array`, `exponent`, `object`, or `string`), default is `string`
 
@@ -57,6 +60,7 @@ filesize(1024, {exponent: 0});        // "1024 B"
 filesize(1024, {output: "exponent"}); // 1
 filesize(265318, {standard: "iec"});  // "259.1 KiB"
 filesize(265318, {standard: "iec", fullform: true}); // "259.1 kibibytes"
+filesize(0, {fullform: true, fullforms: ["байт"]});  // "0 байт"
 ```
 
 ## Partial Application

lib/filesize.es6.js

@@ -3,7 +3,7 @@
  *
  * @copyright 2017 Jason Mulligan <[email protected]>
  * @license BSD-3-Clause
- * @version 3.5.3
+ * @version 3.5.4
  */
 (function (global) {
 	const b = /^(b|B)$/,
@@ -33,7 +33,7 @@
 	function filesize (arg, descriptor = {}) {
 		let result = [],
 			val = 0,
-			e, base, bits, ceil, full, neg, num, output, round, unix, spacer, standard, symbols;
+			e, base, bits, ceil, full, fullforms, neg, num, output, round, unix, spacer, standard, symbols;
 
 		if (isNaN(arg)) {
 			throw new Error("Invalid arguments");
@@ -48,6 +48,7 @@
 		standard = base === 2 ? descriptor.standard || "jedec" : "jedec";
 		output = descriptor.output || "string";
 		full = descriptor.fullform === true;
+		fullforms = descriptor.fullforms instanceof Array ? descriptor.fullforms : [];
 		e = descriptor.exponent !== undefined ? descriptor.exponent : -1;
 		num = Number(arg);
 		neg = num < 0;
@@ -124,7 +125,7 @@
 		}
 
 		if (full) {
-			result[1] = fullform[standard][e] + (bits ? "bit" : "byte") + (result[0] === 1 ? "" : "s");
+			result[1] = fullforms[e] ? fullforms[e] : fullform[standard][e] + (bits ? "bit" : "byte") + (result[0] === 1 ? "" : "s");
 		}
 
 		return result.join(spacer);

lib/filesize.js

@@ -5,7 +5,7 @@
  *
  * @copyright 2017 Jason Mulligan <[email protected]>
  * @license BSD-3-Clause
- * @version 3.5.3
+ * @version 3.5.4
  */
 (function (global) {
 	var b = /^(b|B)$/,
@@ -42,6 +42,7 @@
 		    bits = void 0,
 		    ceil = void 0,
 		    full = void 0,
+		    fullforms = void 0,
 		    neg = void 0,
 		    num = void 0,
 		    output = void 0,
@@ -64,6 +65,7 @@
 		standard = base === 2 ? descriptor.standard || "jedec" : "jedec";
 		output = descriptor.output || "string";
 		full = descriptor.fullform === true;
+		fullforms = descriptor.fullforms instanceof Array ? descriptor.fullforms : [];
 		e = descriptor.exponent !== undefined ? descriptor.exponent : -1;
 		num = Number(arg);
 		neg = num < 0;
@@ -140,7 +142,7 @@
 		}
 
 		if (full) {
-			result[1] = fullform[standard][e] + (bits ? "bit" : "byte") + (result[0] === 1 ? "" : "s");
+			result[1] = fullforms[e] ? fullforms[e] : fullform[standard][e] + (bits ? "bit" : "byte") + (result[0] === 1 ? "" : "s");
 		}
 
 		return result.join(spacer);