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
|
/* 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/. */
const lazy = {};
ChromeUtils.defineESModuleGetters(lazy, {
EventEmitter: "resource://gre/modules/EventEmitter.sys.mjs",
NetworkObserver:
"resource://devtools/shared/network-observer/NetworkObserver.sys.mjs",
NetworkEventRecord:
"chrome://remote/content/shared/listeners/NetworkEventRecord.sys.mjs",
});
/**
* The NetworkListener listens to all network activity from the parent
* process.
*
* Example:
* ```
* const listener = new NetworkListener();
* listener.on("before-request-sent", onBeforeRequestSent);
* listener.startListening();
*
* const onBeforeRequestSent = (eventName, data = {}) => {
* const { cntextId, redirectCount, requestData, requestId, timestamp } = data;
* ...
* };
* ```
*
* @fires before-request-sent
* The NetworkListener emits "before-request-sent" events, with the
* following object as payload:
* - {number} browsingContextId - The browsing context id of the browsing
* context where this request was performed.
* - {number} redirectCount - The request's redirect count.
* - {RequestData} requestData - The request's data as expected by
* WebDriver BiDi.
* - {string} requestId - The id of the request, consistent across
* redirects.
* - {number} timestamp - Timestamp when the event was generated.
*/
export class NetworkListener {
#devtoolsNetworkObserver;
#listening;
constructor() {
lazy.EventEmitter.decorate(this);
this.#listening = false;
}
destroy() {
this.stopListening();
}
startListening() {
if (this.#listening) {
return;
}
this.#devtoolsNetworkObserver = new lazy.NetworkObserver({
ignoreChannelFunction: this.#ignoreChannelFunction,
onNetworkEvent: this.#onNetworkEvent,
});
// Enable the auth prompt listening to support the auth-required event and
// phase.
this.#devtoolsNetworkObserver.setAuthPromptListenerEnabled(true);
this.#listening = true;
}
stopListening() {
if (!this.#listening) {
return;
}
this.#devtoolsNetworkObserver.destroy();
this.#devtoolsNetworkObserver = null;
this.#listening = false;
}
#ignoreChannelFunction = channel => {
// Bug 1826210: Ignore file channels which don't support the same APIs as
// regular HTTP channels.
if (channel instanceof Ci.nsIFileChannel) {
return true;
}
// Ignore chrome-privileged or DevTools-initiated requests
if (
channel.loadInfo?.loadingDocument === null &&
(channel.loadInfo.loadingPrincipal ===
Services.scriptSecurityManager.getSystemPrincipal() ||
channel.loadInfo.isInDevToolsContext)
) {
return true;
}
return false;
};
#onNetworkEvent = (networkEvent, channel) => {
return new lazy.NetworkEventRecord(networkEvent, channel, this);
};
}
|