as-loader

as-loader

AssemblyScript loader for webpack

⚠️ In development ⚠️

Installation

This loader requires minimum AssemblyScript 0.18, Node.js 10 and webpack 4 or webpack 5

# with npm
npm install --save-dev as-loader

# with yarn
yarn add --dev as-loader

The minimal webpack.config.js:

module.exports = {
  entry: "src/index.ts",
  resolve: {
    extensions: [".ts", ".js"],
  },
  module: {
    rules: [
      {
        test: /\.ts$/,
        include: path.resolve(__dirname, "src/assembly"),
        loader: "as-loader",
        options: {
          // optional loader and compiler options
        }
      },
      {
        test: /\.ts$/,
        exclude: path.resolve(__dirname, "src/assembly"),
        loader: "ts-loader",
      },
    ],
  },
};

Usage

By default, the loader emits .wasm file (+ .wasm.map if source maps are enabled) and creates CommonJS module that exports URL to the emitted .wasm file.

import * as myModule from "./assembly/myModule";
import { instantiateStreaming } from "@assemblyscript/loader";

async function loadAndRun() {
  const module = await instantiateStreaming<typeof myModule>(
    // workaround for TypeScript
    fetch((myModule as unknown) as string)
  );
  module.exports.myFunction(100);
}

loadAndRun();

You can also use it with experimental webpack features: syncWebAssembly and asyncWebAssembly

Configuration example for syncWebAssembly

// webpack.config.js
module.exports = {
  entry: "src/index.ts",
  resolve: {
    extensions: [".ts", ".js"],
  },
  module: {
    rules: [
      {
        test: /\.ts$/,
        include: path.resolve(__dirname, "src/assembly"),
        loader: "as-loader",
        type: "webassembly/sync"
      },
      {
        test: /\.ts$/,
        exclude: path.resolve(__dirname, "src/assembly"),
        loader: "ts-loader",
      },
    ],
  },
  experiments: { 
    syncWebAssembly: true
  }
};

Options

Loader Options

Name	Type	Description
name	string	Output asset name template, [name].[contenthash].wasm by default.
raw	boolean	If true, returns binary instead of emitting file. Use for chaining with other loaders.

Compiler Options

Options passed to the AssemblyScript compiler.

Name	Type	Description
optimizeLevel	number	How much to focus on optimizing code. [0-3]
shrinkLevel	number	How much to focus on shrinking code size. [0-2]
coverage	boolean	Re-optimizes until no further improvements can be made.
noAssert	boolean	Replaces assertions with just their value without trapping.
runtime	string	Specifies the runtime variant to include in the program. Available runtimes are: "full", "half", "stub", "none"
debug	boolean	Enables debug information in emitted binaries.
trapMode	string	Sets the trap mode to use. Available modes are: "allow", "clamp", "js"
noValidate	boolean	Skips validating the module using Binaryen.
importMemory	boolean	Imports the memory provided as 'env.memory'.
noExportMemory	boolean	Does not export the memory as 'memory'.
initialMemory	number	Sets the initial memory size in pages.
maximumMemory	number	Sets the maximum memory size in pages.
sharedMemory	boolean	Declare memory as shared. Requires maximumMemory.
importTable	boolean	Imports the function table provided as 'env.table'.
exportTable	boolean	Exports the function table as 'table'.
explicitStart	boolean	Exports an explicit '_start' function to call.
enable	string[]	Enables WebAssembly features being disabled by default. Available features are: "sign-extension", "bulk-memory", "simd", "threads", "reference-types"
disable	string[]	Disables WebAssembly features being enabled by default. Available features are: "mutable-globals"
lowMemoryLimit	boolean	Enforces very low (<64k) memory constraints.
memoryBase	number	Sets the start offset of emitted memory segments.
tableBase	number	Sets the start offset of emitted table elements.

License

MIT