Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten.Erfahre mehr über dieses Experiment.
WebAssembly.Exception.prototype.stack
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
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 schreibgeschütztestack-Eigenschaft einer Objektinstanz vom TypWebAssembly.Exceptionkann einen Stack-Trace enthalten.
Ausnahmen aus WebAssembly-Code enthalten standardmäßig keinen Stack-Trace.
Wenn WebAssembly-Code einen Stack-Trace bereitstellen muss, muss er eine JavaScript-Funktion aufrufen, um die Ausnahme zu erstellen, und den Parameteroptions.traceStack=true imKonstruktor übergeben.Die virtuelle Maschine kann dann einen Stack-Trace an das von dem Konstruktor zurückgegebene Ausnahmeobjekt anhängen.
Hinweis:Stack-Traces werden normalerweise nicht vom WebAssembly-Code gesendet, um die Leistung zu verbessern.Die Möglichkeit, Stack-Traces zu diesen Ausnahmen hinzuzufügen, wird für Entwickler-Tools bereitgestellt und wird im Allgemeinen nicht für den breiteren Gebrauch empfohlen.
Wert
Ein String, der den Stack-Trace enthält, oderundefined, wenn kein Trace zugewiesen wurde.
Der Stack-Trace-String listet die Speicherorte 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 seinen Offset im Modul-Binärformat angibt.Er hat ungefähr folgendes Format (sieheStack-Trace-Konventionen in der Spezifikation für weitere Informationen):
${url}:wasm-function[${funcIndex}]:${pcOffset}Beispiele
Dieses Beispiel demonstriert, wie man aus WebAssembly eine Ausnahme wirft, die einen Stack-Trace enthält.
Betrachten Sie den folgenden WebAssembly-Code, von dem angenommen wird, dass er in eine Datei namensexample.wasm kompiliert wurde.Er importiert ein Tag, das intern als$tagname bezeichnet wird, und importiert eine Funktion, die als$throwExnWithStack bezeichnet wird.Er exportiert die Methoderun, die von externem Code aufgerufen werden kann, um$throwExnWithStack (und somit die JavaScript-Funktion) zu rufen.
(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 unten stehende JavaScript-Code definiert ein neues Tagtag und die FunktionthrowExceptionWithStack.Diese werden dem WebAssembly-Modul imimportObject übergeben, wenn es instanziiert wird.
Sobald die Datei instanziiert ist, ruft der Code die exportierte WebAssembly-Methoderun() auf, die sofort eine Ausnahme wirft.Der Stack wird dann aus dercatch-Anweisung protokolliert.
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:38Der "relevanteste" Teil dieses Codes ist die Zeile, in der die Ausnahme erstellt wird:
new WebAssembly.Exception(tag, [param], { traceStack: true });Das Übergeben von{traceStack: true} teilt der WebAssembly-virtuellen Maschine mit, dass sie einen Stack-Trace an die zurückgegebeneWebAssembly.Exception anhängen soll.Ohne dies wäre der Stackundefined.