Some schema libraries support two way conversion of data, often referred to as "encoding" and "decoding".
We benchmark the time taken to encode and decode a bigint to and from a string.
Copy to clipboardimport * as z from "zod"; const bigIntFromString = z.codec( z.string(), z.bigint(), { decode: (str) => BigInt(str), encode: (bigint) => bigint.toString(), }, ); bigIntFromString.encode( 1234567890123456789n, ); // "1234567890123456789" bigIntFromString.decode( "1234567890123456789", ); // 1234567890123456789n
Copy to clipboardimport * as z from "zod"; const bigIntFromString = z.codec(z.string(), z.bigint(), { decode: (str) => BigInt(str), encode: (bigint) => bigint.toString(), }); bigIntFromString.encode(1234567890123456789n); // "1234567890123456789" bigIntFromString.decode("1234567890123456789"); // 1234567890123456789n
Invalid data
We don't benchmark codecs with invalid data, as many libraries require the input to be correctly typed before passing it to the codec.
Optimizations
| Library | Version | /wk | Optimizations | Encode | Decode | |||||
|---|---|---|---|---|---|---|---|---|---|---|
sury | 11.0.0 | 538.18K | JIT | Code snippet(Setup code is not benchmarked) | 87 ns | Code snippet(Setup code is not benchmarked) | 120 ns | |||
io-ts | 2.2.22 | 3.67M | None | Code snippet(Setup code is not benchmarked) | 88 ns | Code snippet(Setup code is not benchmarked) | 125 ns | |||
zod/mini | 4.6.5 | 387.37M | JIT | Code snippet | 140 ns | Code snippet | 173 ns | |||
zod/mini (compile) | 4.6.5 | 387.37M | JIT | Code snippet | 146 ns | Code snippet | 157 ns | |||
zod | 4.6.5 | 387.37M | JIT | Code snippet | 148 ns | Code snippet | 169 ns | |||
zod (compile) | 4.6.5 | 387.37M | JIT | Code snippet(Setup code is not benchmarked) | 161 ns | Code snippet(Setup code is not benchmarked) | 160 ns | |||
effect (unknown) | Accepts unknown valuesThis codec allows unknown input, requiring extra validation. | 4.0.1 | 51.26M | None | Code snippet | 322 ns | Code snippet | 356 ns | ||
effect | 4.0.1 | 51.26M | None | Code snippet | 329 ns | Code snippet | 336 ns | |||
typebox | Accepts unknown valuesThis codec allows unknown input, requiring extra validation. | 1.3.36 | 15.54M | JIT | Code snippet(Setup code is not benchmarked) | 4 μs | Code snippet(Setup code is not benchmarked) | 4 μs | ||