@massimo-cassandro/minimo 1.14.6 → 1.15.0

package/index.js

@@ -11,6 +11,7 @@ export { escapeHTML, unescapeHTML } from './src/utilities/escape-html.js';
 export { generatePwd } from './src/utilities/generate-pwd.js';
 export { getCookie, setCookie } from './src/utilities/cookies.js';
 export { linkedDates } from './src/utilities/linked-dates.js';
+export { parseFileSize } from './src/utilities/parse-file-size.js';
 export { randomId } from './src/utilities/random-id.js';
 export { relativeDate } from './src/utilities/relative-date.js';
 export { sentenceCase } from './src/utilities/sentence-case.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@massimo-cassandro/minimo",
-  "version": "1.14.6",
+  "version": "1.15.0",
   "description": "Light css framework & utilities",
   "type": "module",
   "main": "./index.js",

package/src/utilities/parse-file-size.js

@@ -0,0 +1,32 @@
+// @ts-check
+
+/**
+ * Converts a file size in bytes to a human readable string,
+ * using the most appropriate unit (bytes, KB, MB or GB).
+ *
+ * @example
+ * parseFileSize(1536);      // "1.5 KB"
+ * parseFileSize(10485760);  // "10 MB"
+ *
+ * @param {number} bytes - file size in bytes
+ * @param {number} [decimals=1] - max number of decimal digits
+ * @returns {string} formatted size (e.g. "1.5 MB")
+ */
+export function parseFileSize(bytes, decimals = 1) {
+
+  if(typeof bytes !== 'number' || isNaN(bytes) || bytes < 0) {
+    return '';
+  }
+
+  const units = ['bytes', 'KB', 'MB', 'GB'],
+    k = 1024;
+
+  const exp = bytes === 0
+    ? 0
+    : Math.min(Math.floor(Math.log(bytes) / Math.log(k)), units.length - 1);
+
+  const value = bytes / Math.pow(k, exp);
+
+  // \u202f = narrow no-break space
+  return `${parseFloat(value.toFixed(decimals))}\u202f${units[exp]}`;
+}