Zarith is an OCaml library that implements common operations over arbitrary-precision integers and rationals. It is implemented via a C api that primarily calls out to Gnu Multiple Precision Arithmetic Library. Because of that C API, Zarith could not be compiled via Js_of_ocaml until now.
Zarith Stubs JS is a reimplementation of the native C functions in JavaScript. It uses the native BigInt primitive type available in modern browsers (see the compatibility table).
In order to use zarith with js_of_ocaml, just provide the javascript
runtime files to the js_of_ocaml compiler and use zarith as you would
normally do.
In practice,
- if you use dune to build your project, just
add
zarith_stubs_jsas a library dependency. - if you don't use dune, you need to find a way to pass the
runtime.js file to the
js_of_ocamlcompiler command line.
This library uses the native BigInt primitive to represent values of type
Z.t, making it compatible with the structured clone algorithm. This
allows safely transfering values between different execution contexts such as
web workers.
This library requires a modern execution environment with support for the BigInt primitive (this includes all major browsers released after 2020 -- see the compatibility table). If support for legacy execution environments without support for the BigInt primitive is required, older versions of this library (up to v0.17) should be used (without support for data transfer to web workers).