Skip to content

fix(wasm): Fix wasm integration stacktrace parsing for filename #15572

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Mar 4, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
93 changes: 93 additions & 0 deletions packages/browser/test/tracekit/chromium.test.ts
Original file line number Diff line number Diff line change
Expand Up @@ -643,4 +643,97 @@ describe('Tracekit - Chrome Tests', () => {
},
});
});

it('should correctly parse a wasm stack trace', () => {
const WASM_ERROR = {
message: 'memory access out of bounds',
name: 'RuntimeError',
stack: `RuntimeError: memory access out of bounds
at MyClass::bar(int) const (http://localhost:8001/main.wasm:wasm-function[190]:0x5aeb)
at MyClass::foo(int) const (http://localhost:8001/main.wasm:wasm-function[186]:0x5637)
at MyClass::getAt(int) const (http://localhost:8001/main.wasm:wasm-function[182]:0x540b)
at emscripten::internal::MethodInvoker<int (MyClass::*)(int) const, int, MyClass const*, int>::invoke(int (MyClass::* const&)(int) const, MyClass const*, int) (http://localhost:8001/main.wasm:wasm-function[152]:0x47df)
at ClassHandle.MyClass$getAt [as getAt] (eval at newFunc (http://localhost:8001/main.js:2201:27), <anonymous>:9:10)
at myFunctionVectorOutOfBounds (http://localhost:8001/main.html:18:22)
at captureError (http://localhost:8001/main.html:27:11)
at Object.onRuntimeInitialized (http://localhost:8001/main.html:39:9)
at doRun (http://localhost:8001/main.js:7084:71)
at run (http://localhost:8001/main.js:7101:5)`,
};

const ex = exceptionFromError(parser, WASM_ERROR);

// This is really ugly but the wasm integration should clean up these stack frames
expect(ex).toStrictEqual({
stacktrace: {
frames: [
{
colno: 5,
filename: 'http://localhost:8001/main.js',
function: 'run',
in_app: true,
lineno: 7101,
},
{
colno: 71,
filename: 'http://localhost:8001/main.js',
function: 'doRun',
in_app: true,
lineno: 7084,
},
{
colno: 9,
filename: 'http://localhost:8001/main.html',
function: 'Object.onRuntimeInitialized',
in_app: true,
lineno: 39,
},
{
colno: 11,
filename: 'http://localhost:8001/main.html',
function: 'captureError',
in_app: true,
lineno: 27,
},
{
colno: 22,
filename: 'http://localhost:8001/main.html',
function: 'myFunctionVectorOutOfBounds',
in_app: true,
lineno: 18,
},
{
colno: 27,
filename: 'http://localhost:8001/main.js',
function: 'ClassHandle.MyClass$getAt [as getAt]',
in_app: true,
lineno: 2201,
},
{
filename:
'int) const, int, MyClass const*, int>::invoke(int (MyClass::* const&)(int) const, MyClass const*, int) (http://localhost:8001/main.wasm:wasm-function[152]:0x47df',
function: 'emscripten::internal::MethodInvoker<int (MyClass::*)',
in_app: true,
},
{
filename: 'int) const (http://localhost:8001/main.wasm:wasm-function[182]:0x540b',
function: 'MyClass::getAt',
in_app: true,
},
{
filename: 'int) const (http://localhost:8001/main.wasm:wasm-function[186]:0x5637',
function: 'MyClass::foo',
in_app: true,
},
{
filename: 'int) const (http://localhost:8001/main.wasm:wasm-function[190]:0x5aeb',
function: 'MyClass::bar',
in_app: true,
},
],
},
type: 'RuntimeError',
value: 'memory access out of bounds',
});
});
});
2 changes: 2 additions & 0 deletions packages/wasm/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -56,6 +56,8 @@
"build:transpile:watch": "rollup -c rollup.npm.config.mjs --watch",
"build:types:watch": "tsc -p tsconfig.types.json --watch",
"build:tarball": "npm pack",
"test": "vitest run",
"test:watch": "vitest --watch",
"circularDepCheck": "madge --circular src/index.ts",
"clean": "rimraf build coverage sentry-wasm-*.tgz",
"fix": "eslint . --format stylish --fix",
Expand Down
25 changes: 21 additions & 4 deletions packages/wasm/src/index.ts
Original file line number Diff line number Diff line change
Expand Up @@ -36,20 +36,36 @@ const _wasmIntegration = (() => {

export const wasmIntegration = defineIntegration(_wasmIntegration);

const PARSER_REGEX = /^(.*?):wasm-function\[\d+\]:(0x[a-fA-F0-9]+)$/;

/**
* Patches a list of stackframes with wasm data needed for server-side symbolication
* if applicable. Returns true if the provided list of stack frames had at least one
* matching registered image.
*/
function patchFrames(frames: Array<StackFrame>): boolean {
// Only exported for tests
export function patchFrames(frames: Array<StackFrame>): boolean {
let hasAtLeastOneWasmFrameWithImage = false;
frames.forEach(frame => {
if (!frame.filename) {
return;
}
const match = frame.filename.match(/^(.*?):wasm-function\[\d+\]:(0x[a-fA-F0-9]+)$/) as
| null
| [string, string, string];

const split = frame.filename.split('(');
// eslint-disable-next-line @typescript-eslint/no-non-null-assertion
const lastSplit = split[split.length - 1]!;

// Let's call this first match a "messy match".
// The browser stacktrace parser spits out frames that have a filename like this: "int) const (http://localhost:8001/main.wasm:wasm-function[190]:0x5aeb"
// It contains some leftover mess because wasm stack frames are more complicated than our parser can handle: "at MyClass::bar(int) const (http://localhost:8001/main.wasm:wasm-function[190]:0x5aeb)"
// This first match simply tries to mitigate the mess up until the first opening parens.
// The match afterwards is a sensible fallback
let match = lastSplit.match(PARSER_REGEX) as null | [string, string, string];

if (!match) {
match = frame.filename.match(PARSER_REGEX) as null | [string, string, string];
}

if (match) {
const index = getImage(match[1]);
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We could check the length of the match array before here

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If there is a match it is 100% guaranteed to have 3 entries so I don't think it would matter and it saves bundle size.

frame.instruction_addr = match[2];
Expand All @@ -62,5 +78,6 @@ function patchFrames(frames: Array<StackFrame>): boolean {
}
}
});

return hasAtLeastOneWasmFrameWithImage;
}
159 changes: 159 additions & 0 deletions packages/wasm/test/stacktrace-parsing.test.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,159 @@
import { describe, it, expect } from 'vitest';
import { patchFrames } from '../src/index';

describe('patchFrames()', () => {
it('should correctly extract instruction addresses', () => {
const frames = [
{
colno: 5,
filename: 'http://localhost:8001/main.js',
function: 'run',
in_app: true,
lineno: 7101,
},
{
colno: 71,
filename: 'http://localhost:8001/main.js',
function: 'doRun',
in_app: true,
lineno: 7084,
},
{
colno: 9,
filename: 'http://localhost:8001/main.html',
function: 'Object.onRuntimeInitialized',
in_app: true,
lineno: 39,
},
{
colno: 11,
filename: 'http://localhost:8001/main.html',
function: 'captureError',
in_app: true,
lineno: 27,
},
{
colno: 22,
filename: 'http://localhost:8001/main.html',
function: 'myFunctionVectorOutOfBounds',
in_app: true,
lineno: 18,
},
{
colno: 27,
filename: 'http://localhost:8001/main.js',
function: 'ClassHandle.MyClass$getAt [as getAt]',
in_app: true,
lineno: 2201,
},
{
filename:
'int) const, int, MyClass const*, int>::invoke(int (MyClass::* const&)(int) const, MyClass const*, int) (http://localhost:8001/main.wasm:wasm-function[152]:0x47df',
function: 'emscripten::internal::MethodInvoker<int (MyClass::*)',
in_app: true,
},
{
filename: 'int) const (http://localhost:8001/main.wasm:wasm-function[182]:0x540b',
function: 'MyClass::getAt',
in_app: true,
},
{
filename: 'int) const (http://localhost:8001/main.wasm:wasm-function[186]:0x5637',
function: 'MyClass::foo',
in_app: true,
},
{
filename: 'int) const (http://localhost:8001/main.wasm:wasm-function[190]:0x5aeb',
function: 'MyClass::bar',
in_app: true,
},
{
filename: 'http://localhost:8001/main.wasm:wasm-function[190]:0x5aeb',
function: 'MyClass::bar',
in_app: true,
},
];

patchFrames(frames);

expect(frames).toStrictEqual([
{
colno: 5,
filename: 'http://localhost:8001/main.js',
function: 'run',
in_app: true,
lineno: 7101,
},
{
colno: 71,
filename: 'http://localhost:8001/main.js',
function: 'doRun',
in_app: true,
lineno: 7084,
},
{
colno: 9,
filename: 'http://localhost:8001/main.html',
function: 'Object.onRuntimeInitialized',
in_app: true,
lineno: 39,
},
{
colno: 11,
filename: 'http://localhost:8001/main.html',
function: 'captureError',
in_app: true,
lineno: 27,
},
{
colno: 22,
filename: 'http://localhost:8001/main.html',
function: 'myFunctionVectorOutOfBounds',
in_app: true,
lineno: 18,
},
{
colno: 27,
filename: 'http://localhost:8001/main.js',
function: 'ClassHandle.MyClass$getAt [as getAt]',
in_app: true,
lineno: 2201,
},
{
filename: 'http://localhost:8001/main.wasm',
function: 'emscripten::internal::MethodInvoker<int (MyClass::*)',
in_app: true,
instruction_addr: '0x47df',
platform: 'native',
},
{
filename: 'http://localhost:8001/main.wasm',
function: 'MyClass::getAt',
in_app: true,
instruction_addr: '0x540b',
platform: 'native',
},
{
filename: 'http://localhost:8001/main.wasm',
function: 'MyClass::foo',
in_app: true,
instruction_addr: '0x5637',
platform: 'native',
},
{
filename: 'http://localhost:8001/main.wasm',
function: 'MyClass::bar',
in_app: true,
instruction_addr: '0x5aeb',
platform: 'native',
},
{
filename: 'http://localhost:8001/main.wasm',
function: 'MyClass::bar',
in_app: true,
instruction_addr: '0x5aeb',
platform: 'native',
},
]);
});
});
3 changes: 3 additions & 0 deletions packages/wasm/test/tsconfig.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
{
"extends": "../tsconfig.test.json"
}
8 changes: 8 additions & 0 deletions packages/wasm/tsconfig.test.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
{
"extends": "./tsconfig.json",
"include": ["test/**/*", "vite.config.ts"],
"compilerOptions": {
"types": ["node"],
"lib": ["DOM", "ESNext"]
}
}
8 changes: 8 additions & 0 deletions packages/wasm/vite.config.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
import baseConfig from '../../vite/vite.config';

export default {
...baseConfig,
test: {
...baseConfig.test,
},
};
Loading