sqlite3 WASM Testing Page Index

---

Below is the list of test pages for the sqlite3 WASM builds. All of them require that this directory have been "make"d first. The intent is that this page be run using:

Copy

althttpd -enable-sab -page index.html

and the individual tests be started in their own tab. Warnings and Caveats:

• All of these pages must be served via an HTTP server. Browsers do not support loading WASM files via file:// URLs.
• Any OPFS-related pages or tests require:
  • An OPFS-capable browser released after February 2023. Some tests will work with Chromium-based browsers going back to around v102.
  • That the web server emit the so-called COOP and COEP headers. althttpd requires the -enable-sab flag for that.

The tests and demos...

• Core-most tests

  • tester1: Core unit and regression tests for the various APIs and surrounding utility code.
  • tester1-worker: same thing but running in a Worker.
  • tester1-esm: same as tester1 but loads sqlite3 in the main thread via an ES6 module.
  • tester1-worker?esm: same as tester1-esm but loads a Worker Module which then loads the sqlite3 API via an ES6 module. Note that not all browsers permit loading modules in Worker threads.

• High-level apps and demos...

  • fiddle is an HTML front-end to a wasm build of the sqlite3 shell.
  • demo-123 provides a no-nonsense example of adding sqlite3 support to a web page in the UI thread.
  • demo-123-worker is the same as demo-123 but loads and runs sqlite3 from a Worker thread.
  • demo-jsstorage: very basic demo of using the key-value VFS for storing a persistent db in JS localStorage or sessionStorage.
  • demo-worker1: Worker-based wrapper of the OO API #1. Its Promise-based wrapper is significantly easier to use, however.
  • demo-worker1-promiser: a demo of the Promise-based wrapper of the Worker1 API.

• speedtest1 ports (sqlite3's primary benchmarking tool)...

  • speedtest1: a main-thread WASM build of speedtest1.
  • speedtest1?vfs=kvvfs: speedtest1 with the kvvfs.
  • speedtest1-worker: an interactive Worker-thread variant of speedtest1.
  • speedtest1-worker?vfs=opfs: speedtest1-worker with the OPFS VFS preselected and configured for a moderate workload.
  • speedtest1-worker?vfs=opfs-sahpool: speedtest1-worker with the OPFS-SAHPOOL VFS preselected and configured for a moderate workload.

• The obligatory "misc." category...

  • module-symbols gives a high-level overview of the symbols exposed by the JS module.
  • test-opfs-vfs (same with verbose output and sanity-checking tests) is an sqlite3_vfs OPFS proxy using SharedArrayBuffer and the Atomics APIs to regulate communication between the synchronous sqlite3_vfs interface and the async OPFS impl.
  • OPFS concurrency tests using multiple workers.

• WASMFS -specific tests which require that the WASMFS build is available on this server (it is not by default) and that this server emits the COOP/COEP headers.

  • scratchpad-wasmfs: experimenting with WASMFS/OPFS-based persistence.
  • speedtest1-wasmfs: a variant of speedtest1 built solely for the wasmfs/opfs feature.