Initial release of Web Tools 0.0.5

tests/bytes.test.ts

@@ -0,0 +1,56 @@
+import { describe, expect, it } from 'vitest'
+import {
+  bytesToHex,
+  bytesToText,
+  decodeBase64,
+  encodeBase64,
+  formatBytes,
+  parseHex,
+  textToBytes,
+} from '../src/lib/bytes'
+
+describe('parseHex', () => {
+  it('accepts contiguous hex, separators and optional 0x prefixes', () => {
+    const expected = '00112233445566778899AABBCCDDEEFF'
+    expect(bytesToHex(parseHex(expected), '')).toBe(expected)
+    expect(bytesToHex(parseHex('00 11 22 33 44 55 66 77 88 99 AA BB CC DD EE FF'), '')).toBe(expected)
+    expect(bytesToHex(parseHex('00，11，22，33，44，55，66，77，88，99，AA，BB，CC，DD，EE，FF'), '')).toBe(expected)
+    expect(bytesToHex(parseHex('0x00 0x11 0x22 0x33 0x44 0x55 0x66 0x77 0x88 0x99 0xAA 0xBB 0xCC 0xDD 0xEE 0xFF'), '')).toBe(expected)
+    expect(bytesToHex(parseHex(`0x${expected}`), '')).toBe(expected)
+  })
+
+  it('reports invalid characters, odd length and exact byte count', () => {
+    expect(() => parseHex('GG')).toThrow('无效')
+    expect(() => parseHex('10x2')).toThrow('无效')
+    expect(() => parseHex('AA0xBB')).toThrow('无效')
+    expect(() => parseHex('ABC')).toThrow('偶数')
+    expect(() => parseHex('0011', 16)).toThrow('当前为 2 字节')
+  })
+})
+
+describe('UTF-8 and Base64', () => {
+  it('round-trips Unicode text', () => {
+    const source = '你好，Web Tools'
+    expect(bytesToText(textToBytes(source))).toBe(source)
+    expect(bytesToText(decodeBase64(encodeBase64(textToBytes(source))))).toBe(source)
+  })
+
+  it('formats decoded binary as continuous hex and source-code bytes', () => {
+    const bytes = decodeBase64('SJ87vWNeyh907uXD4bRteQ==')
+    expect(formatBytes(bytes)).toBe('489F3BBD635ECA1F74EEE5C3E1B46D79')
+    expect(formatBytes(bytes, { format: 'byte-array', uppercase: false })).toBe('0x48, 0x9f, 0x3b, 0xbd, 0x63, 0x5e, 0xca, 0x1f, 0x74, 0xee, 0xe5, 0xc3, 0xe1, 0xb4, 0x6d, 0x79')
+  })
+
+  it('supports URL-safe Base64 without padding', () => {
+    const bytes = Uint8Array.from([251, 255, 239])
+    expect(encodeBase64(bytes, true)).toBe('-__v')
+    expect(decodeBase64('-__v', true)).toEqual(bytes)
+  })
+
+  it('rejects invalid Base64', () => {
+    expect(() => decodeBase64('abcde')).toThrow('长度')
+    expect(() => decodeBase64('ab*c')).toThrow('无效')
+    expect(() => decodeBase64('Zh==')).toThrow('无效')
+    expect(() => decodeBase64('Zm9=')).toThrow('无效')
+  })
+})