xref: /sqlite-3.40.0/ext/wasm/index.html (revision 0db30895)
1<!doctype html>
2<html lang="en-us">
3  <head>
4    <meta charset="utf-8">
5    <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
6    <link rel="shortcut icon" href="data:image/x-icon;," type="image/x-icon">
7    <link rel="stylesheet" href="common/testing.css"/>
8    <title>sqlite3 WASM Testing Page Index</title>
9  </head>
10  <body>
11    <header id='titlebar'><span>sqlite3 WASM test pages</span></header>
12    <hr>
13    <div>Below is the list of test pages for the sqlite3 WASM
14      builds. All of them require that this directory have been
15      "make"d first. The intent is that <em>this</em> page be run
16      using:</div>
17    <blockquote><pre>althttpd -page index.html</pre></blockquote>
18    <div>and the individual tests be started in their own tab.</div>
19    <div>Warnings and Caveats:
20      <ul class='warning'>
21        <li>Some of these pages require that
22          the web server emit the so-called COOP and COEP headers. The
23          default build of althttpd <em>does not</em>.
24        </li>
25        <li>Whether or not WASMFS/OPFS support is enabled on any given
26          page may depend on build-time options which are <em>off by
27          default</em> because they currently (as of 2022-09-08) break
28          with Worker-based pages.
29        </li>
30      </ul>
31    </div>
32    <div>The tests...
33      <ul id='test-list'>
34        <li><a href='testing1.html'>testing1</a>: sanity tests of the core APIs and surrounding utility code.</li>
35        <li><a href='testing2.html'>testing2</a>: Worker-based test of OO API #1.</li>
36        <li><a href='testing-worker1-promiser.html'>testing-worker1-promiser</a>:
37          tests for the Promise-based wrapper of the Worker-based API.</li>
38        <li><a href='demo-oo1.html'>demo-oo1</a>: demonstration of the OO API #1.</li>
39        <li><a href='batch-runner.html'>batch-runner</a>: runs batches of SQL exported from speedtest1.</li>
40        <li><a href='batch-runner-kvvfs.html'>batch-runner-kvvfs</a>: KVVFS-specific variant of batch-runner.html.</li>
41        <li><a href='speedtest1.html'>speedtest1</a>: a main-thread WASM build of speedtest1.</li>
42        <li><a href='speedtest1-worker.html'>speedtest1-worker</a>: an interactive Worker-thread variant of speedtest1.</li>
43        <li><a href='speedtest1-wasmfs.html'>speedtest1-wasmfs</a>: a variant of speedtest1 built solely for the wasmfs/opfs feature.</li>
44        <li><a href='speedtest1-kvvfs.html'>speedtest1-kvvfs</a>: a variant of speedtest1 built solely for the kv-vfs feature.</li>
45        <li><a href='kvvfs1.html'>kvvfs1</a>: very basic demo of using the key-value vfs for storing
46          a persistent db in JS localStorage or sessionStorage.</li>
47        <li><a href='scratchpad-wasmfs-main.html'>scratchpad-wasmfs-main</a>:
48          experimenting with WASMFS/OPFS-based persistence. Maintenance
49          reminder: we cannot currently (2022-09-15) load WASMFS in a
50          worker due to an Emscripten limitation.</li>
51        <li><a href='scratchpad-opfs-worker.html'>scratchpad-opfs-worker</a>:
52          experimenting with OPFS from a Worker thread (without WASMFS).</li>
53        <li><a href='test-opfs-vfs.html'>test-opfs-vfs</a>
54          (<a href='test-opfs-vfs.html?opfs-sanity-check&opfs-verbose'>same
55          with verbose output and sanity-checking tests</a>) is an
56          experiment in implementing a syncronous sqlite3 VFS proxy
57          for a fully asynchronous backend interface (namely OPFS),
58          using SharedArrayBuffer and the Atomics APIs to regulate
59          communication between the synchronous interface and the
60          async impl.
61        </li>
62        <!--li><a href='x.html'></a></li-->
63      </ul>
64    </div>
65    <style>
66      #test-list { font-size: 120%; }
67    </style>
68    <script>//Assign a distinct target tab name for each test page...
69      document.querySelectorAll('a').forEach(function(e){
70          e.target = e.href;
71      });
72    </script>
73  </body>
74</html>
75