wasmts-main v0.1.6

Wasmts，将TypeScript编译为wasm，让你的Web应用和C一样快

1、核心原理，是把TypeScript先编译成C，然后再编译为wasm，因而性能是跟C一样的。

2、自带内存回收机制，不需要手动释放内存，也无需像C一样担心内存泄露。

3、支持大部分TypeScript特性，包括内联函数，闭包，Class，多文件导入等等。

4、不用学新语言，只要会TypeScript，直接就能用。

5、底层本质编译的都是C，因而，你也可以把已有的C代码混编进来，直接利用C已有的生态。

基本入门

1、安装

npm install wasm-ts-dev --save

2、简单的helloworld

新建一个ts文件helloworld.ts，并输入以下内容

console.log("hello world");

3、执行编译

打开终端，进入当前目录，输入命令：

wasmts helloworld.ts

4、运行编译结果

前面步骤，会在当前目录生成一个文件：helloworld.wasm.w.js，可直接用node执行

node helloworld.wasm.w.js

此例子中，wasm是以bytes形式内嵌在js文件中的，你也可以添加参数”--wasm“，生成独立的wasm文件

复杂例子

wasm的执行速度通常比js快5到10倍，所以它能即时渲染更加复杂的页面，让你的浏览器跑出C一样的速度。下面3个例子，是用Wasmts编译的，纯js运行无法达到此效果。点击查看相应代码，或者直接查看运行的效果。

与AssemblyScript的差别

Wasmts跟AssemblyScript性能差别不大，上面3个复杂的例子，就是参考AssemblyScript官网上的例子用Wasmts修改过来的。同样的运行效果，彼此性能是差不多的。

虽然性能差不多，但是两者差别还是较大：

1、彼此定位不同。AssemblyScript是定位于一门新语言，虽然它宣称是类似TypeScript的语言，但本质还是一门新语言，数据类型和语法规范跟TypeScript差异还是较大。Wasmts，则定位于一个前端框架，全面拥抱TypeScript和C两门语言，不创造新语言。

2、对TypeScript的支持程度不同。目前AssemblyScript并不支持内联函数、闭包等高级功能，Wasmts则支持。Wasmts的目标是，尽可能兼容TypeScript的所有特性，用纯粹的TypeScript写出C一样高性能的web前端应用。

3、Wasmts能跟C混编，因为Wasmts本质是C，因而能与已有的C代码生态无缝衔接。AssemblyScript是一门独立的新语言，暂无法做到此功能。

你也可以查看AssemblyScript同样的例子相应代码：gameoflife，interference，mandelbrot

与WasmEdge的差别

WasmEdge是倾向于云端的wasm runtime，不倾向于web前端。虽然它可以在wasm运行javascript，但它只是把一个javascript解析引擎（quickjs）嵌入runtime，运行的本质还是将javascript作为动态语言进行解析运行。所以在性能上，还不如带JIT的V8引擎。WasmEdge的优势在用rust，go等语言写wasm，并不在javascript。

相比之下，Wasmts，是针对前端设计的框架，采用的技术路线是把typescript编译成C，再编译为wasm，其性能跟C是一样的。这跟WasmEdge运行的javascript有本质的不同。

语法支持

内置对象

上面所有例子源码都在【src/examples/】目录内，都可以用wasmts命令直接编译

注意事项

1、不能出现不确定类型的变量、参数和返回值，不能有any、known等

2、暂不支持union类型

3、数组目前仅支持string和number，下一版本会支持任意类型

输出配置

在src/WSProgram.ts文件内，定义了输出配置：

export type outputConfig = {
    type?: 'html' | 'js' | 'ts',
    moduleName?: string,
    wasmType?: 'bytes' | 'file',
    wasmFileUrl?: string,
    exports?: { [key: string]: Function | any },
    onReady?: (runtime: WSRuntime, module?: any) => any,
    outDir?: string,
    template?: { content: string, toReplace: string },
    autoLoad?: boolean,
};

使用时，调用wasmts.output接口，可指定输出的配置，比如：

import { wasmts } from "wasmts-main";

console.log("Hello Wrold");

wasmts.output({
    type: 'html', //定义编译后文件以html格式输出
});

配置参数说明：