AssemblyScript — a variant of TypeScript that compiles to WebAssembly. Since it is compiled, it outperforms JavaScript in some cases. AS follows the TypeScript syntax as closely as possible and even adds more features to it. AssemblyScript allows us to write fast WebAssembly for the Web and Server without learning another language.
AssemblyScript is very easy to use. All you need to do is install it via NPM.
Try it out online: Online editor
~ npm i assemblyscript --save-dev
~ npx asinit .
~ npm i
What did that do? First of all, it installed both the loader and the compiler. Secondly, it made a template project with an add function. Now, we just need to compile it to WebAssembly.
~ npm run asbuild
So, if you check out the /build folder, there are the .wasm files that were built. NodeJS and JavaScript both provide a way to run WebAssembly files and AssemblyScript provides its own loader to work with the code. To start our code, we need another file
test.js
const wasmModule = require('./index')
// This works just like a normal module
console.log(wasmModule.add(2,9))
// -- 11
Now, run it!
~ node test.js
It should have outputted the number 11.
JavaScript code for the add function would look like this:
function add(a, b) {
return a + b
}
module.exports = {
add: add
}
The AssemblyScript code looks like this:
export function add(a: i32, b: i32): i32 {
return a + b;
}
Pretty similar, right? When we compile it, we can require it just like a normal JavaScript file. Keep in mind that WebAssembly is sandboxed which means it can’t access the system, make HTTP requests, or log to the console. However, AssemblyScript supports both WASI and JS bindings (calling JS from AS).
If you have any questions or comments, feel free to comment or join the AssemblyScript Discord. Or, check out the website.😉
P.S: There is a tutorial at https://jtanaka.gitbook.io/guide/
Top comments (7)
But coming soon! How to use DOM APIs (via bindings) and to make websites written in AssemblyScript!...
Yeah, write an article when asdom gets released!
It's already visible in the following repo, but as soon as it has enough bindings to be useful for a majority of cases, then we'll make an article. Working on Shadow DOM bindings next. :)
lume / asdom
Use DOM APIs in AssemblyScript
asdom
Use DOM APIs in AssemblyScript (TypeScript compiled to WebAssembly).
This allows us to write WebAssembly applications that can manipulate the DOM, and with potential for more speed!
Early Stages!
Work in progress (probably may always be), but right now it's early and many APIs need to be added.
Supported APIs so far
See the outline of supported APIs.
Usage
First you should get familiar with AssemblyScript and learn how to run AssemlyScript code in a browser.
The following
asc
compiler options are required:--exportRuntime
--exportTable
.The
--explicitStart
option is required only if any of your ES modules use DOM APIs at their top level (read the comments in the below example).In your JavaScript code that loads your Wasm module, import
Asdom
and pass itswasmImports
to your Wasm module's imports. The following snippet assumes the use of native ES Modules in the browser and a…Definitely gonna give it a try :)
If you need any help, I'm always available in the discord server (discord.com/invite/assemblyscript) as @JairusSW 😀
Quite interesting. Had no idea bout assemblyScript.
Yeah, its a small project that started a while back. Its getting better and more powerful by the moment though. :)