Hello! 欢迎来到小浪资源网!



为什么我为 Nodejs 创建了一个新的 UUID 包


avatar
1986424546 2024-11-15 29

为什么我为 Nodejs 创建了一个新的 UUID 包

我使用 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 和浏览器环境中使用。它是同构的,可以与现代 JavaScripttypescript 一起使用,无需任何额外配置。

特征

  • 自动从十六进制、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

结论

我希望这个包对您有用,并帮助您以更高效和用户友好的方式使用 uuid。如果您有任何反馈或建议,请告诉我。

您可以在 npm 上找到该软件包:https://www.npmjs.com/package/@uuid-ts/uuid。

相关阅读