Skip to content
This repository has been archived by the owner on Jun 24, 2024. It is now read-only.

Deprecate x_google_ignoreList in favor of ignoreList, remove Known Extensions #19

Merged
merged 3 commits into from
Oct 12, 2023
Merged

Deprecate x_google_ignoreList in favor of ignoreList, remove Known Extensions #19

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
4856929
Turn x_google_ignoreList into an official field named ignoreList
EricSL Oct 5, 2023
f45183e
Update x_google_ignoreList deprecation info
EricSL Oct 5, 2023
fc07434
Update source-map.bs
EricSL Oct 10, 2023
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
24 changes: 10 additions & 14 deletions source-map.bs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -146,7 +146,8 @@ following structure:
"sources": ["foo.js", "bar.js"],
"sourcesContent": [null, null],
"names": ["src", "maps", "are", "fun"],
"mappings": "A,AAAB;;ABCDE;"
"mappings": "A,AAAB;;ABCDE;",
"ignoreList": [0]
}
```

Expand Down Expand Up @@ -180,6 +181,14 @@ can't be hosted. The contents are listed in the same order as the [=sources=].

<dfn><code>mappings</code></dfn> a string with the encoded mapping data (see [[#mappings-structure]]).

<dfn><code>ignoreList</code></dfn> an optional list of indices of files that
should be considered third party code, such as framework code or bundler-generated code. This
allows developer tools to avoid code that developers likely don't want to see
or step through, without requiring developers to configure this beforehand.
It refers to the [=sources=] array and lists the indices of all the known third-party sources
in the source map. Some browsers may also use the deprecated <code>x_google_ignoreList</code>
field if <code>ignoreList</code> is not present.

Mappings Structure {#mappings-structure}
----------------------------------------

Expand Down Expand Up @@ -245,19 +254,6 @@ organization providing the extension, such as `x_google_linecount`. Field nam
the `x_` namespace are reserved for future revisions. It is recommended that fields be
namespaced by domain, i.e. `x_com_google_gwt_linecount`.

Known Extensions
----------------

<dfn export><code>x_google_linecount</code></dfn> The number of lines represented by this source map.

<dfn export><code>x_google_ignoreList</code></dfn> Identifies third-party sources (such as framework
code or bundler-generated code), allowing developers to avoid code that they don't want to see
or step through, without having to configure this beforehand.

It refers to the [=sources=] array and lists the indices of all the known third-party sources
in that source map. When parsing the source map, developer tools can use this to determine
sections of the code that the browser loads and runs that could be automatically ignore-listed.

Notes on File Offsets
---------------------

Expand Down