WebAssembly.Exception.prototype.stack
非标准: 该特性是非标准的,请尽量不要在生产环境中使用它!
WebAssembly.Exception
类型的一个对象实例的只读 stack
属性可能包含堆栈跟踪。
来自 WebAssembly 代码的异常默认不会包含堆栈跟踪。
如果 WebAssembly 代码需要提供堆栈跟踪,它必须调用 JavaScript 函数来创建异常,并为其构造函数传递 options.trackStack=true
参数。然后虚拟机会将堆栈跟踪附着到该构造函数返回的异常对象上。
备注: 通常不会从 WebAssembly 代码发送堆栈跟踪以改善性能。给异常添加堆栈跟踪的能力是为开发者工具提供的,一般不建议更广泛的使用。
值
示例
这个例子展示如何从 WebAssembly 抛出一个包含堆栈跟踪的异常。
考虑下面的 WebAssembly 代码,假设其被编译为一个名为 example.wasm 的文件。它导入一个标签,内部引用为 $tagname
,并导入一个引用为 $throwExnWithStack
的函数。它导出一个可被外部代码调用的方法 run
,以调用 throwExnWithStack
(就是 JavaScript 函数)
(module ;; 导入的标签在这引用为 $tagname (import "extmod" "exttag" (tag $tagname (param i32))) ;; 导入的函数在这引用为 $throwExnWithStack (import "extmod" "throwExnWithStack" (func $throwExnWithStack (param i32))) ;; 将 42 作为参数调用 $throwExnWithStack (func (export "run") i32.const 42 call $throwExnWithStack ) )
下面的 JavaScript 代码定义一个新标签 tag
和函数 throwExceptionWithStack
。在实例化 WebAssembly 模块时,将它们放在 importObject
中传递给 WebAssembly 模块。
一旦文件被实例化,代码就调用导出的 WebAssembly run()
方法,该方法会立即抛出一个异常。然后 catch
语句会打印栈。
const tag = new WebAssembly.Tag({ parameters: ["i32"] }); function throwExceptionWithStack(param) { // 注意:我们用“{traceStack: true}”申明异常 throw new WebAssembly.Exception(tag, [param], { traceStack: true }); } // 注意:importObject 属性要和 WebAssembly import 语句相匹配。 const importObject = { extmod: { exttag: tag, throwExnWithStack: throwExceptionWithStack, }, }; WebAssembly.instantiateStreaming(fetch("example.wasm"), importObject) .then((obj) => { console.log(obj.instance.exports.run()); }) .catch((e) => { console.log(`栈:${e.stack}`); }); // 日志输出(像这样): // 栈:throwExceptionWithStack@http://<url>/main.js:76:9 // @http://<url>/example.wasm:wasm-function[3]:0x73 // @http://<url>/main.js:82:38
该代码中最“相关”的部分是创建异常的那行:
new WebAssembly.Exception(tag, [param], { traceStack: true });
传递 {traceStack: true}
是告诉 WebAssembly 虚拟机它应该将堆栈跟踪附着到返回的 WebAssembly.Exception
。如果没有的话,栈将会是 undefined
。