Base64 Encoding

Fast Base64 encoding and decoding powered by WebAssembly.

Both API and implementation likely to change before the 1.0.0 release. {:.note}

This library is modeled after the WHATWG TextEncoder and TextDecoder API, providing a Base64Encoder and Base64Decoder class.

The C implementation was chosen based on https://github.com/gaspardpetit/base64.

Usage

const encoder = await new Base64Encoder().optimize();
encoder.encode(new TextEncoder().encode('foobar'))   // => Zm9vYmFy

const decoder = await new Base64Decoder().optimize();
new TextDecoder().decode(decoder.decode("Zm9vYmFy")) // => foobar

For one-shot usage, you can use the JS implementation without instantiating a WASM instance:

new Base64Encoder().encode(new TextEncoder().encode('foobar'))   // => Zm9vYmFy
new TextDecoder().decode(new Base64Decoder().decode("Zm9vYmFy")) // => foobar

URL-friendly Encoding

This implementation also supports a URL-friendly variant of Base64, where

• all '+' are mapped to '-'
• all '/' are mapped to '_'
• the padding characters '=' are omitted

To use this variant, provide the urlFriendly setting when creating the encoder.

const encoder = await new Base64Encoder({ urlFriendly: true }).optimize();

For decoding URL-friendly Base64 no extra steps are required.

Performance

TBD

Currently only the encoder provides a signification performance improvement over the pure JS implementation.

Distribution

This module is published on npm under the base64-encoding tag. The package contains the following:

• The mjs (Browse) folder exports ES modules in ES2018 syntax. All module paths are fully qualified, so they can be imported in Deno or the browser directly.
• The cjs (Browse) folder exports CommonJS modules in ES5 syntax.
• The dist (Browse) provides rolled up versions as UMD (ES5) as well as ES module (ES2018).

Both mjs and cjs include d.ts type declarations and source maps, so that IntelliSense works out of the box in VSCode.

The package.json properly sets the main, module, type and exports keys, so that package.json-based tools will pick the right version.

Browser

Ideally, you would bundle this library using you build tool of choice via the options provided above. However, this module can also be imported as a UMD module directly via script tag:

<script src="https://unpkg.com/base64-encoding/dist/index.js"></script>
<script>
 var Base64Encoder = window.base64Encoding.Base64Encoder; 
 var Base64Decoder = window.base64Encoding.Base64Decoder;
</script>

For modern browsers, using the rolled-up ES module works too:

<script type="module">
  import { Base64Encoder, Base64Decoder } from 'https://unpkg.com/base64-encoding/dist/module.js'
</script>

License

TBD

Currently the C code is licensed under an ancient Apache 1.0 license that comes with some pretty old-school requirements, such as including the following in all promotional materials:

This product includes software developed by the Apache Group for use in the Apache HTTP server project (http://www.apache.org/).

It is very likely that ap_base64.c has been shipped under a Apache-2.0 license somewhere. Once I locate it, this requirement will go away.

TODO

• Figure out why decoding is slow
• License
• Change API to accept a BufferSource instead of ArrayBuffer!?