github

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.

import * 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


import * 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
LibraryVersion/wkOptimizationsEncodeDecode
io-ts2.2.22n/aNone87 ns
120 ns
sury11.0.0n/aJIT89 ns
125 ns
zod/mini (compile)4.6.5n/aJIT157 ns
157 ns
zod (compile)4.6.5n/aJIT174 ns
160 ns
zod/mini4.6.5n/aJIT136 ns
161 ns
zod4.6.5n/aJIT145 ns
179 ns
effect (unknown)4.0.2n/aNone332 ns
359 ns
effect4.0.2n/aNone334 ns
360 ns
typebox1.3.36n/aJIT4 μs
4 μs

Preferences

Style
Theme
NPM browser
Code ligatures