Skip to content

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 等等。

查看术语表

动手做项目

通过引导式项目应用所学,含起始代码与解决方案。

查看项目

解读错误信息

用大白话解释常见错误——什么意思、为什么发生、如何修复。

查看错误