我使用 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
结论
我希望这个包对您有用,并帮助您以更高效和用户友好的方式使用 uuid。如果您有任何反馈或建议,请告诉我。
您可以在 npm 上找到该软件包:https://www.npmjs.com/package/@uuid-ts/uuid。