1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
|
/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at <http://mozilla.org/MPL/2.0/>. */
import { getSelectedLocation } from "./selected-location";
import { getSource } from "../selectors/index";
/**
* Note that arguments can be created via `createLocation`.
* But they can also be created via `createPendingLocation` in reducer/pending-breakpoints.js.
* Both will have similar line and column attributes.
*/
export function comparePosition(a, b) {
return a && b && a.line == b.line && a.column == b.column;
}
export function createLocation({
source,
sourceActor = null,
// Line 0 represents no specific line chosen for action
line = 0,
column,
}) {
return {
source,
sourceActor,
sourceActorId: sourceActor?.id,
// `line` and `column` are 1-based.
// This data is mostly coming from and driven by
// JSScript::lineno and JSScript::column
// https://searchfox.org/mozilla-central/rev/90dce6b0223b4dc17bb10f1125b44f70951585f9/js/src/vm/JSScript.h#1545-1548
line,
column,
};
}
/**
* Convert location objects created via `createLocation` into
* the format used by the Source Map Loader/Worker.
* It only needs sourceId, line and column attributes.
*/
export function debuggerToSourceMapLocation(location) {
return {
sourceId: location.source.id,
// In case of errors loading the source, we might not have a precise location.
// Defaults to first line and column.
line: location.line || 1,
column: location.column || 0,
};
}
/**
* Pending location only need these three attributes,
* and especially doesn't need the large source and sourceActor objects of the regular location objects.
*
* @param {Object} location
*/
export function createPendingSelectedLocation(location) {
return {
url: location.source.url,
line: location.line,
column: location.column,
};
}
export function sortSelectedLocations(locations, selectedSource) {
return Array.from(locations).sort((locationA, locationB) => {
const aSelected = getSelectedLocation(locationA, selectedSource);
const bSelected = getSelectedLocation(locationB, selectedSource);
// Order the locations by line number…
if (aSelected.line < bSelected.line) {
return -1;
}
if (aSelected.line > bSelected.line) {
return 1;
}
// … and if we have the same line, we want to return location with undefined columns
// first, and then order them by column
if (aSelected.column == bSelected.column) {
return 0;
}
if (aSelected.column === undefined) {
return -1;
}
if (bSelected.column === undefined) {
return 1;
}
return aSelected.column < bSelected.column ? -1 : 1;
});
}
/**
* Source map Loader/Worker and debugger frontend don't use the same objects for locations.
* Worker uses 'sourceId' attributes whereas the frontend has 'source' attribute.
*/
export function sourceMapToDebuggerLocation(state, location) {
// From MapScopes modules, we might re-process the exact same location objects
// for which we would already have computed the source object,
// and which would lack sourceId attribute.
if (location.source) {
return location;
}
// SourceMapLoader doesn't known about debugger's source objects
// so that we have to fetch it from here
const source = getSource(state, location.sourceId);
if (!source) {
throw new Error(`Could not find source-map source ${location.sourceId}`);
}
return createLocation({
...location,
source,
});
}
|
