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
sury11.0.0n/aJIT70 ns
90 ns
io-ts2.2.22n/aNone72 ns
90 ns
zod/mini4.6.5n/aJIT105 ns
117 ns
zod/mini (compile)4.6.5n/aJIT111 ns
122 ns
zod4.6.5n/aJIT112 ns
119 ns
zod (compile)4.6.5n/aJIT119 ns
116 ns
effect4.0.2n/aNone249 ns
269 ns
effect (unknown)4.0.2n/aNone263 ns
299 ns
typebox1.3.36n/aJIT3 μs
3 μs

Preferences

Style
Theme
NPM browser
Code ligatures