esm: experimental wasm modules

This is a first pass at a loader for wasm modules. It offers support for both named imports as well as deafult. It may be possible to move some of this logic down to C++, but I think the current implementation might be good enough. It doesn't currently use the ESM cache, but AFAICT it isn't currently exposed. Will dig in more with tests / examples / cache after initial implementation gets feedback.

Author: MylesBorins

lib/internal/modules/esm/default_resolve.js

@@ -10,6 +10,7 @@ const preserveSymlinksMain = getOptionValue('--preserve-symlinks-main');
 const { ERR_INVALID_PACKAGE_CONFIG,
  ERR_TYPE_MISMATCH,
  ERR_UNKNOWN_FILE_EXTENSION } = require('internal/errors').codes;
+const experimentalWasmModules = getOptionValue('--experimental-wasm-modules');
 const { resolve: moduleWrapResolve } = internalBinding('module_wrap');
 const { pathToFileURL, fileURLToPath, URL } = require('internal/url');
 const asyncESM = require('internal/process/esm_loader');
@@ -34,6 +35,16 @@ const legacyExtensionFormatMap = {
  '.node': 'commonjs'
 };
 
+if (experimentalWasmModules) {
+ // This is a total hack
+ Object.assign(extensionFormatMap, {
+ '.wasm': 'wasm'
+ });
+ Object.assign(legacyExtensionFormatMap, {
+ '.wasm': 'wasm'
+ });
+}
+
 function readPackageConfig(path, parentURL) {
  const existing = pjsonCache.get(path);
  if (existing !== undefined)

lib/internal/modules/esm/translators.js

@@ -13,7 +13,7 @@ const fs = require('fs');
 const {
  SafeMap,
 } = primordials;
-const { URL } = require('url');
+const { fileURLToPath, URL } = require('url');
 const { debuglog, promisify } = require('util');
 const esmLoader = require('internal/process/esm_loader');
 
@@ -94,3 +94,24 @@ translators.set('builtin', async function(url) {
  reflect.exports.default.set(module.exports);
  });
 });
+
+// Strategy for loading a wasm module
+translators.set('wasm', async function(url) {
+ const pathname = fileURLToPath(url);
+ const buffer = await readFileAsync(pathname);
+ debug(`Translating WASMModule ${url}`);
+ let result, keys;
+ try {
+ WebAssembly.validate(buffer);
+ result = await WebAssembly.instantiate(buffer, {});
+ keys = Object.keys(result.instance.exports);
+ } catch (err) {
+ err.message = pathname + ': ' + err.message;
+ throw err;
+ }
+ return createDynamicModule([...keys, 'default'], url, (reflect) => {
+ for (const key of keys)
+ reflect.exports[key].set(result.instance.exports[key]);
+ reflect.exports.default.set(result.instance.exports);
+ });
+});

src/node_options.cc

@@ -216,6 +216,10 @@ EnvironmentOptionsParser::EnvironmentOptionsParser() {
  "experimental ES Module support and caching modules",
  &EnvironmentOptions::experimental_modules,
  kAllowedInEnvironment);
+ AddOption("--experimental-wasm-modules",
+ "experimental ES Module support for webassembly modules",
+ &EnvironmentOptions::experimental_wasm_modules,
+ kAllowedInEnvironment);
  AddOption("--experimental-policy",
  "use the specified file as a "
  "security policy",

src/node_options.h

@@ -87,6 +87,7 @@ class EnvironmentOptions : public Options {
  bool abort_on_uncaught_exception = false;
  bool experimental_modules = false;
  std::string es_module_specifier_resolution = "explicit";
+ bool experimental_wasm_modules = false;
  std::string module_type;
  std::string experimental_policy;
  bool experimental_repl_await = false;

test/es-module/test-esm-wasm.mjs

@@ -0,0 +1,9 @@
+// Flags: --experimental-modules --experimental-wasm-modules
+/* eslint-disable node-core/required-modules */
+import wasmMod from '../fixtures/simple.wasm'
+import {add} from '../fixtures/simple.wasm';
+import {strictEqual} from 'assert';
+
+strictEqual(wasmMod.add(10, 20), 30);
+strictEqual(add(10, 20), 30);
+strictEqual(wasmMod.add, add);