@uxf/core 11.47.0 → 11.51.0

package/README.md

@@ -405,6 +405,14 @@ const submitHandler: FormEventHandler<HTMLFormElement> = () => {
 };
 ```
 
+### formatBytes
+
+Appends suitable unit to the byte value of data size.
+```ts
+formatBytes(17.5 * 1024);
+//=> "17.5 kB"
+```
+
 ## Validators
 ```tsx
 import { Validator } from "@uxf/core";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@uxf/core",
-    "version": "11.47.0",
+    "version": "11.51.0",
     "description": "UXF Core",
     "author": "Petr Vejvoda <vejvoda@uxf.cz>",
     "homepage": "https://gitlab.com/uxf-npm/core#readme",

package/utils/format-bytes.d.ts

@@ -0,0 +1 @@
+export declare function formatBytes(bytes: number, decimals?: number): string;

package/utils/format-bytes.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatBytes = formatBytes;
+function formatBytes(bytes, decimals = 2) {
+    const k = 1024;
+    const dm = decimals < 0 ? 0 : decimals;
+    const sizes = ["B", "kB", "MB", "GB", "TB", "PB", "EB", "ZB", "YB"];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return `${parseFloat((bytes / Math.pow(k, i)).toFixed(dm))} ${sizes[i]}`;
+}

package/utils/format-bytes.test.d.ts

@@ -0,0 +1 @@
+export {};

package/utils/format-bytes.test.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const format_bytes_1 = require("./format-bytes");
+test("format-bytes", () => {
+    expect((0, format_bytes_1.formatBytes)(1)).toEqual("1 B");
+    expect((0, format_bytes_1.formatBytes)(1024)).toEqual("1 kB");
+    expect((0, format_bytes_1.formatBytes)(1024 * 1024)).toEqual("1 MB");
+    expect((0, format_bytes_1.formatBytes)(17.55 * 1024)).toEqual("17.55 kB");
+});