WebAssembly.Exception.prototype.stack
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Nicht standardisiert: Diese Funktion ist nicht standardisiert. Wir raten davon ab, nicht-standardisierte Funktionen auf produktiven Webseiten zu verwenden, da sie nur von bestimmten Browsern unterstützt werden und sich in Zukunft ändern oder entfernt werden können. Unter Umständen kann sie jedoch eine geeignete Option sein, wenn es keine standardisierte Alternative gibt.
Die stack-Eigenschaft, die schreibgeschützt ist, des WebAssembly.Exception-Objekts kann einen Stack-Trace enthalten.
Wert
Ein String, der den Stack-Trace enthält, oder undefined, wenn kein Trace zugewiesen wurde.
Der Stack-Trace-String listet die Positionen jeder Operation auf dem Stack im WebAssembly-Format auf. Dies ist ein menschenlesbarer String, der die URL, den Namen des aufgerufenen Funktionstyps, den Funktionsindex und dessen Offset im Modul-Binärformat angibt. Er hat ungefähr folgendes Format (siehe Konventionen für Stack-Traces in der Spezifikation für weitere Informationen):
${url}:wasm-function[${funcIndex}]:${pcOffset}
Beschreibung
Ausnahmen vom WebAssembly-Code enthalten standardmäßig keinen Stack-Trace.
Wenn WebAssembly-Code einen Stack-Trace bereitstellen muss, muss eine JavaScript-Funktion aufgerufen werden, um die Ausnahme zu erstellen, und der Parameter options.traceStack=true muss im Konstruktor übergeben werden.
Die virtuelle Maschine kann dann der vom Konstruktor zurückgegebenen Ausnahme ein Stack-Trace anhängen.
Hinweis: Stack-Traces werden normalerweise nicht vom WebAssembly-Code gesendet, um die Leistung zu verbessern. Die Möglichkeit, diesen Ausnahmen Stack-Traces hinzuzufügen, ist für Entwickler-Tools gedacht und wird im Allgemeinen nicht zur breiten Verwendung empfohlen.
Beispiele
Dieses Beispiel zeigt, wie man eine Ausnahme von WebAssembly aus wirft, die einen Stack-Trace enthält.
Betrachten Sie den folgenden WebAssembly-Code, der angenommen wird, dass er in eine Datei namens example.wasm kompiliert wird.
Dieser importiert ein Tag, das intern als $tagname bezeichnet wird, und importiert eine Funktion, die intern als $throwExnWithStack bezeichnet wird.
Er exportiert die Methode run, die von externem Code aufgerufen werden kann, um $throwExnWithStack aufzurufen.
(module
;; import tag that will be referred to here as $tagname
(import "extmod" "exttag" (tag $tagname (param i32)))
;; import function that will be referred to here as $throwExnWithStack
(import "extmod" "throwExnWithStack" (func $throwExnWithStack (param i32)))
;; call $throwExnWithStack passing 42 as parameter
(func (export "run")
i32.const 42
call $throwExnWithStack
)
)
Der folgende JavaScript-Code definiert ein neues Tag tag und die Funktion throwExceptionWithStack().
Diese werden dem WebAssembly-Modul im importObject übergeben, wenn es instanziiert wird.
Sobald das Modul instanziiert ist, ruft der Code die exportierte WebAssembly-Methode run() auf, die sofort eine Ausnahme auslöst.
Der Stack wird dann aus dem catch-Statement geloggt.
const tag = new WebAssembly.Tag({ parameters: ["i32"] });
function throwExceptionWithStack(param) {
// Note: We declare the exception with "{traceStack: true}"
throw new WebAssembly.Exception(tag, [param], { traceStack: true });
}
// Note: importObject properties match the WebAssembly import statements.
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(`stack: ${e.stack}`);
});
// Log output (something like):
// stack: throwExceptionWithStack@http://<url>/main.js:76:9
// @http://<url>/example.wasm:wasm-function[3]:0x73
// @http://<url>/main.js:82:38
Der bedeutendste Teil dieses Codes ist die Zeile, in der die Ausnahme erstellt wird:
new WebAssembly.Exception(tag, [param], { traceStack: true });
Das Übergeben von {traceStack: true} weist die WebAssembly-Virtual-Maschine an, dass sie einen Stack-Trace an die zurückgegebene WebAssembly.Exception anhängen soll.
Ohne dies wäre der Stack undefined.