Add experimental supprot for the proposed JS base64 API

See https://github.com/tc39/proposal-arraybuffer-base64

Author: sbc100

src/lib/libbase64.js

@@ -22,6 +22,9 @@ addToLibrary({
 `,
   $base64Decode__docs: '/** @noinline */',
   $base64Decode: (b64) => {
+#if JS_BASE64_API
+    return Uint8Array.fromBase64(b64);
+#else
 #if ENVIRONMENT_MAY_BE_NODE
     if (ENVIRONMENT_IS_NODE) {
       var buf = Buffer.from(b64, 'base64');
@@ -42,5 +45,6 @@ addToLibrary({
       output[j+2] = b2 << 6 | base64ReverseLookup[b64.charCodeAt(i+3)];
     }
     return output;
+#endif
   },
 });

src/settings.js

@@ -2193,6 +2193,12 @@ var SOURCE_PHASE_IMPORTS = false;
 // [link]
 var WASM_ESM_INTEGRATION = false;
 
+// Enable to use of the proposed arraybuffer-base64 API:
+// https://github.com/tc39/proposal-arraybuffer-base64
+// To run the resulting code currently requires passing `--js_base_64` to node
+// or chrome.
+var JS_BASE64_API = false;
+
 // For renamed settings the format is:
 // [OLD_NAME, NEW_NAME]
 // For removed settings (which now effectively have a fixed value and can no

test/test_other.py

@@ -16017,3 +16017,12 @@ def test_locate_file_abspath_esm(self, args):
                  output_suffix='.mjs',
                  emcc_args=['--pre-js', 'pre.js',
                             '--extern-post-js', test_file('modularize_post_js.js')] + args)
+
+  @requires_node_canary
+  def test_js_base64_api(self):
+    self.node_args += ['--js_base_64']
+    self.do_runf('hello_world.c', 'hello, world!', emcc_args=['-sSINGLE_FILE'], output_basename='baseline')
+    self.do_runf('hello_world.c', 'hello, world!', emcc_args=['-sSINGLE_FILE', '-sJS_BASE64_API', '-Wno-experimental'])
+    baseline_size = os.path.getsize('baseline.js')
+    js_api_size = os.path.getsize('hello_world.js')
+    self.assertLess(js_api_size, baseline_size)

tools/link.py

@@ -784,6 +784,9 @@ def phase_linker_setup(options, linker_args):  # noqa: C901, PLR0912, PLR0915
   if options.oformat == OFormat.MJS:
     default_setting('EXPORT_ES6', 1)
 
+  if settings.JS_BASE64_API:
+    diagnostics.warning('experimental', '-sJS_BASE64_API is still experimental and not yet supported in browsers')
+
   if settings.WASM_ESM_INTEGRATION:
     diagnostics.warning('experimental', '-sWASM_ESM_INTEGRATION is still experimental and not yet supported in browsers')
     default_setting('EXPORT_ES6', 1)