languages/dart-sdk
languages/dart-sdk
1
0
Fork 0
mirror of https://github.com/dart-lang/sdk synced 2024-09-05 00:13:50 +00:00
Code Issues Packages Projects Releases Wiki Activity

[dart2js] update documentation on source-map extensions to mention VLQ encoding.

Browse source 
Change-Id: Ic564a992310591ee25a9aba1e1dc391160c47df2
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/296680
Reviewed-by: Stephen Adams <sra@google.com>
Commit-Queue: Sigmund Cherem <sigmund@google.com>
This commit is contained in:
Sigmund Cherem 2023-04-20 20:02:33 +00:00 committed by Commit Queue
parent 51fe275a62
commit eda54b0e93
1 changed files with 11 additions and 15 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

26
pkg/compiler/doc/sourcemap_extensions.md
View file

@ -21,7 +21,7 @@ share between dart2js and the deobfuscation tools:
mappings: "AAAA,E;;ABCDE;"
x_org_dartlang_dart2js: {
minified_names: {...},
frames: [...]
frames: "o1WCuboBqyBuB;uCAAAA6B;"
}
}
```
@ -127,8 +127,8 @@ function declaration can create a mismatch in the deobfuscated stack trace: the
deobfuscated frame may show the name of a caller, but the location of an
inlined method.
The `frames` extension is a table with details about inlining information.
Each entry in this table consists of:
The `frames` extension is a VLQ-encoded table with details about inlining
information. Each entry in this table consists of:
* An offset in the program
* A list of one or more frame entries, which in turn can be:
* push: indicates that we entered an inlined context
@ -142,19 +142,15 @@ A push operation includes details about the call site, in particular:
* the name of the inlined method (as and index in the name table), note that
dart2js encodes instance methods as a compound name "ClassName.methodName".
Here is an example of what the encoded format would look like:
Here is an example of what the decoded VLQ in the frames section would look like:
```
...
x_org_dartlang_dart2js: {
...
frames: [
[ 2310, // offset containing data
[2, 34, 11, 4]], // a list encodes a push operation
[ 2320, [4, 4, 2, 9]],
[ 2330, -1], // -1 encodes a pop operation
[ 2333, 0] // 0 encodes a pop-and-empty operation
]
}
[
[ 2310, // offset containing data
[2, 34, 11, 4]], // a list encodes a push operation
[ 2320, [4, 4, 2, 9]],
[ 2330, -1], // -1 encodes a pop operation
[ 2333, 0] // 0 encodes a pop-and-empty operation
]
```
A few details worth noting about the format: