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/. */
"use strict";
const {
Arg,
RetVal,
types,
generateActorSpec,
} = require("resource://devtools/shared/protocol.js");
types.addDictType("AllocationsRecordingOptions", {
// The probability we sample any given allocation when recording
// allocations. Must be between 0.0 and 1.0. Defaults to 1.0, or sampling
// every allocation.
probability: "number",
// The maximum number of of allocation events to keep in the allocations
// log. If new allocations arrive, when we are already at capacity, the oldest
// allocation event is lost. This number must fit in a 32 bit signed integer.
maxLogLength: "number",
});
const memorySpec = generateActorSpec({
typeName: "memory",
/**
* The set of unsolicited events the MemoryActor emits that will be sent over
* the RDP (by protocol.js).
*/
events: {
// Same format as the data passed to the
// `Debugger.Memory.prototype.onGarbageCollection` hook. See
// `js/src/doc/Debugger/Debugger.Memory.md` for documentation.
"garbage-collection": {
type: "garbage-collection",
data: Arg(0, "json"),
},
// Same data as the data from `getAllocations` -- only fired if
// `autoDrain` set during `startRecordingAllocations`.
allocations: {
type: "allocations",
data: Arg(0, "json"),
},
},
methods: {
attach: {
request: {},
response: {
type: RetVal("string"),
},
},
detach: {
request: {},
response: {
type: RetVal("string"),
},
},
getState: {
response: {
state: RetVal(0, "string"),
},
},
takeCensus: {
request: {},
response: RetVal("json"),
},
startRecordingAllocations: {
request: {
options: Arg(0, "nullable:AllocationsRecordingOptions"),
},
response: {
// Accept `nullable` in the case of server Gecko <= 37, handled on the front
value: RetVal(0, "nullable:number"),
},
},
stopRecordingAllocations: {
request: {},
response: {
// Accept `nullable` in the case of server Gecko <= 37, handled on the front
value: RetVal(0, "nullable:number"),
},
},
getAllocationsSettings: {
request: {},
response: {
options: RetVal(0, "json"),
},
},
getAllocations: {
request: {},
response: RetVal("json"),
},
forceGarbageCollection: {
request: {},
response: {},
},
forceCycleCollection: {
request: {},
response: {},
},
measure: {
request: {},
response: RetVal("json"),
},
residentUnique: {
request: {},
response: { value: RetVal("number") },
},
saveHeapSnapshot: {
request: {
boundaries: Arg(0, "nullable:json"),
},
response: {
snapshotId: RetVal("string"),
},
},
},
});
exports.memorySpec = memorySpec;
|
