WebAssembly-JS 互操作深入
掌握 JS 与 WASM 间的边界:调用函数、共享内存和传递数据。
你将学到
- 从 JS 调用 WASM 函数及反向
- 通过线性内存共享数据
- 在边界传递字符串和复杂类型
- JS-WASM 边界的性能成本
概念讲解
WebAssembly-JS 互操作深入
JS-WASM 边界是两个世界交汇处。高效互操作至关重要——跨越边界有成本。
函数调用
WASM 导出 JS 直接调用的函数。WASM 导入 JS 函数。原始类型调用快,复杂类型需小心。
共享内存
WASM 线性内存是 JS 可访问的 ArrayBuffer。传数据:JS 在偏移写入字节,用偏移+长度调用 WASM,WASM 从内存读取。
字符串传递
字符串不是 WASM 原生类型。用 TextEncoder 编码为 UTF-8,写入内存,传指针+长度。返回时 WASM 写 UTF-8 并返回指针;JS 用 TextDecoder 读取。
性能成本
每次边界跨越有开销。小操作中开销主导。批量:用数组调用一次而非 1000 次。将数据保持在 WASM 侧减少跨越。
示例代码
const memory = new WebAssembly.Memory({initial: 1});
const buf = new Uint8Array(memory.buffer);
function writeString(str, off) { const enc = new TextEncoder().encode(str); for (let i = 0; i < enc.length; i++) buf[off+i] = enc[i]; return {ptr: off, len: enc.length}; }
function readString(ptr, len) { return new TextDecoder().decode(buf.slice(ptr, ptr+len)); }
function writeArray(arr, off) { const v = new Float32Array(memory.buffer, off, arr.length); for (let i = 0; i < arr.length; i++) v[i] = arr[i]; return {ptr: off, len: arr.length}; }
const si = writeString('Hello WASM!', 0);
console.log('Written:', si, 'Read:', readString(si.ptr, si.len));
const ai = writeArray([1.5, 2.5, 3.5], 1024);
console.log('Array at 1024:', ai);
writeString 编码为 UTF-8 并写入 WASM 内存。readString 读取并解码。writeArray 用类型化数组视图。批量调用最小化跨越。
动手试一试
- JSON Formatter
WASM 导入/导出对象是 JS 对象——格式化用于调试互操作。
常见错误
错误写法
在紧密 JS 循环中调用 WASM,每次付边界成本。
正确做法
批量工作:传数组到 WASM 并在 WASM 内循环处理。
错误写法
字符串不用 TextEncoder/TextDecoder。
正确做法
TextEncoder/TextDecoder 是优化原生 API。手动转换更慢且对多字节 UTF-8 不正确。
查阅不认识的术语
新手友好的术语表用大白话解释编程术语——变量、函数、DOM、Promise 等等。
动手做项目
通过引导式项目应用所学,含起始代码与解决方案。
解读错误信息
用大白话解释常见错误——什么意思、为什么发生、如何修复。