为什么我为 Node.js 创建了一个新的 UUID 包-js教程-PHP中文网

为什么我为 Node.js 创建了一个新的 UUID 包

Susan Sarandon

发布： 2024-11-15 16:53:03

原创

562 人浏览过

Why I created a new UUID package for Node.js

我使用 Node.js 已经很长时间了，我一直使用 uuid 包在我的项目中生成 UUID。这是一个很棒的包，并且运行良好，但我总觉得它在某些方面还可以改进。

问题

简单的API

关于 uuid 包一直困扰我的事情之一是它仅限于默认格式的简单 UUID 生成。您必须知道如何将其转换为不同的格式，这对于初学者来说可能有点混乱。

长 UUID 字符串

虽然 UUID 字符串是标准格式，但它不太适合 URL 或需要更紧凑表示的其他上下文，例如 base64。这会迫使您解析 UUID 字符串并将其转换为不同的格式，这可能有点麻烦。

存储效率

此外，UUID 的字符串形式在存储空间方面也不是很高效。它使用 36 个字符来表示 16 字节的值，这对于存储或网络传输以及数据库存储来说效率都不是很高。

解决方案

为了解决这些问题，我决定创建一个名为 @uuid-ts/uuid 的新包，它提供更加用户友好的 API 和自动解析不同格式的 UUID。它还包括用于将 UUID 转换为不同格式并验证 UUID 的实用函数。

它是一个简单的 TypeScript 类，支持 UUID 版本 7，可在 Node.js 和浏览器环境中使用。它是同构的，可以与现代 JavaScript 和 TypeScript 一起使用，无需任何额外配置。

特征

自动从十六进制、base64 或缓冲区解析 UUID
自动生成UUID（默认为v7）
轻松将 UUID 转换为十六进制、base64 或缓冲区
验证现有字符串或缓冲区的实用方法

用法

将现有的 UUID 解析为字符串：

const uuidString = '01932c07-209c-7401-9658-4e7a759e7bf7';

const uuid = new Uuid(uuidString);

// methods
uuid.toHex(); // '01932c07-209c-7401-9658-4e7a759e7bf7';
uuid.toBase64(); // 'AZMsByCcdAGWWAAATnp1ng';
uuid.toBuffer(); // [Buffer]
uuid.toInstance<Binary>(Binary); // [Binary]

登录后复制

生成新的 UUID：

const uuid = new Uuid();

uuid.toString(); // '01932c0a-235b-7da6-8153-aee356735b58'

登录后复制

从 Node.js 缓冲区解析 UUID：

const uuid = new Uuid(buffer);

uuid.toString(); // '01932c0b-e834-7b5a-9bae-2964245fc0b6'

登录后复制

它还具有以下实用功能：

Uuid.bufferToUuidHex(buffer: Buffer): string
Uuid.uuidBufferFromHex(uuidHexString: string): Buffer
Uuid.isUuidHexString(uuid: string | Buffer): boolean
Uuid.isUuidBase64String（uuid：字符串|缓冲区）：缓冲区|空
Uuid.fromHex(hexString: string): Uuid
Uuid.fromBase64(base64String: string): Uuid
Uuid.fromBuffer(缓冲区: Buffer): Uuid