Skip to main content
Version: 2x

Class: Symbolicator

Class for transforming stack traces from React Native application with using Source Map. Raw stack frames produced by React Native, points to some location from the bundle eg index.bundle?platform=ios:567:1234. By using Source Map for that bundle Symbolicator produces frames that point to source code inside your project eg Hello.tsx:10:9.

Table of contents

Constructors

Properties

Methods

Constructors

constructor

new Symbolicator(projectRoot, logger, readFileFromWdm, readSourceMapFromWdm)

Constructs new Symbolicator instance.

Parameters

NameTypeDescription
projectRootstringAbsolute path to root directory of the project.
loggerFastifyLoggerInstanceFastify logger instance.
readFileFromWdm(fileUrl: string) => Promise<string>Function to read arbitrary file from webpack-dev-middleware.
readSourceMapFromWdm(fileUrl: string) => Promise<string>Function to read Source Map file from webpack-dev-middleware.

Defined in

packages/repack/src/server/Symbolicator.ts:103

Properties

sourceMapConsumerCache

sourceMapConsumerCache: Record<string, SourceMapConsumer> = {}

Cache with initialized SourceMapConsumer to improve symbolication performance.

Defined in

packages/repack/src/server/Symbolicator.ts:93

Methods

process

process(stack): Promise<SymbolicatorResults>

Process raw React Native stack frames and transform them using Source Maps. Method will try to symbolicate as much data as possible, but if the Source Maps are not available, invalid or the original positions/data is not found in Source Maps, the method will return raw values - the same as supplied with stack parameter. For example out of 10 frames, it's possible that only first 7 will be symbolicated and the remaining 3 will be unchanged.

Parameters

NameTypeDescription
stackReactNativeStackFrame[]Raw stack frames.

Returns

Promise<SymbolicatorResults>

Symbolicated stack frames.

Defined in

packages/repack/src/server/Symbolicator.ts:121


inferPlatformFromStack

Static inferPlatformFromStack(stack): undefined | string

Infer platform from stack frames. Usually at least one frame has file field with the bundle URL eg: http://localhost:8081/index.bundle?platform=ios&..., which can be used to infer platform.

Parameters

NameTypeDescription
stackReactNativeStackFrame[]Array of stack frames.

Returns

undefined | string

Inferred platform or undefined if cannot infer.

Defined in

packages/repack/src/server/Symbolicator.ts:70