wuggy/Dactyloidae
wuggy/Dactyloidae
1
0
Fork 0
mirror of https://repo.dactyloidae.xyz/Dactyloidae/UXP.git synced 2026-09-22 16:37:31 +09:00
Code Issues Projects Releases Packages Wiki Activity

(from mypal68) Full webRequest support

Browse source
This commit is contained in:
ownedbywuigi 2026-03-31 23:52:46 +01:00
commit ea6b948f3b
28 changed files with 6431 additions and 13 deletions
Download patch file Download diff file Expand all files Collapse all files

491
dom/webidl/ChannelWrapper.webidl Normal file
View file

@ -0,0 +1,491 @@
/* 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/. */
interface MozChannel;
interface URI;
interface nsISupports;
/**
* Load types that correspond to the external types in nsIContentPolicy.idl.
* Please also update that IDL when updating this list.
*/
enum MozContentPolicyType {
"main_frame",
"sub_frame",
"stylesheet",
"script",
"image",
"object",
"object_subrequest",
"xmlhttprequest",
"fetch",
"xslt",
"ping",
"beacon",
"xml_dtd",
"font",
"media",
"websocket",
"csp_report",
"imageset",
"web_manifest",
"speculative",
"other"
};
/**
* A thin wrapper around nsIChannel and nsIHttpChannel that allows JS
* callers to access them without XPConnect overhead.
*/
[ChromeOnly, Exposed=Window]
interface ChannelWrapper : EventTarget {
/**
* Returns the wrapper instance for the given channel. The same wrapper is
* always returned for a given channel.
*/
static ChannelWrapper get(MozChannel channel);
/**
* Returns the wrapper instance for the given channel. The same wrapper is
* always returned for a given channel.
*/
static ChannelWrapper? getRegisteredChannel(unsigned long long aChannelId,
DOMString extensionId,
nsISupports? remoteTab);
/**
* A unique ID for for the requests which remains constant throughout the
* redirect chain.
*/
[Constant, StoreInSlot]
readonly attribute unsigned long long id;
// Not technically pure, since it's backed by a weak reference, but if JS
// has a reference to the previous value, we can depend on it not being
// collected.
[Pure]
attribute MozChannel? channel;
/**
* Cancels the request with the given nsresult status code.
*
* The optional reason parameter should be one of the BLOCKING_REASON
* constants from nsILoadInfo.idl
*/
[Throws]
void cancel(unsigned long result, optional unsigned long reason = 0);
/**
* Redirects the wrapped HTTP channel to the given URI. For other channel
* types, this method will throw. The redirect is an internal redirect, and
* the behavior is the same as nsIHttpChannel.redirectTo.
*/
[Throws]
void redirectTo(URI url);
/**
* Requests an upgrade of the HTTP channel to a secure request. For other channel
* types, this method will throw. The redirect is an internal redirect, and
* the behavior is the same as nsIHttpChannel.upgradeToSecure. Setting this
* flag is only effective during the WebRequest.onBeforeRequest in
* Web Extensions, calling this at any other point during the request will
* have no effect. Setting this flag in addition to calling redirectTo
* results in the redirect happening rather than the upgrade request.
*/
[Throws]
void upgradeToSecure();
/**
* The content type of the request, usually as read from the Content-Type
* header. This should be used in preference to the header to determine the
* content type of the channel.
*/
[Pure]
attribute ByteString contentType;
/**
* For HTTP requests, the request method (e.g., GET, POST, HEAD). For other
* request types, returns an empty string.
*/
[Cached, Pure]
readonly attribute ByteString method;
/**
* For requests with LoadInfo, the content policy type that corresponds to
* the request. For requests without LoadInfo, returns "other".
*/
[Cached, Pure]
readonly attribute MozContentPolicyType type;
/**
* When true, the request is currently suspended by the wrapper. When false,
* the request is not suspended by the wrapper, but may still be suspended
* by another caller.
*/
[Pure, SetterThrows]
attribute boolean suspended;
/**
* The final URI of the channel (as returned by NS_GetFinalChannelURI) after
* any redirects have been processed.
*/
[Cached, Pure]
readonly attribute URI finalURI;
/**
* The string version of finalURI (but cheaper to access than
* finalURI.spec).
*/
[Cached, Pure]
readonly attribute DOMString finalURL;
/**
* Returns true if the request matches the given request filter, and the
* given extension has permission to access it.
*/
boolean matches(optional MozRequestFilter filter,
DOMString extensionId,
optional MozRequestMatchOptions options);
/**
* Register's this channel as traceable by the given add-on when accessed
* via the process of the given remote browser.
*/
void registerTraceableChannel(DOMString extensionId, nsISupports? remoteTab);
/**
* The current HTTP status code of the request. This will be 0 if a response
* has not yet been received, or if the request is not an HTTP request.
*/
[Cached, Pure]
readonly attribute unsigned long statusCode;
/**
* The HTTP status line for the request (e.g., "HTTP/1.0 200 Success"). This
* will be an empty string if a response has not yet been received, or if
* the request is not an HTTP request.
*/
[Cached, Pure]
readonly attribute ByteString statusLine;
/**
* If the request has failed or been canceled, an opaque string representing
* the error. For requests that failed at the NSS layer, this is an NSS
* error message. For requests that failed for any other reason, it is the
* name of an nsresult error code. For requests which haven't failed, this
* is null.
*
* This string is used in the error message when notifying extension
* webRequest listeners of failure. The documentation specifically states
* that this value MUST NOT be parsed, and is only meant to be displayed to
* humans, but we all know how that works in real life.
*/
[Cached, Pure]
readonly attribute DOMString? errorString;
/**
* Dispatched when the channel is closed with an error status. Check
* errorString for the error details.
*/
attribute EventHandler onerror;
/**
* Checks the request's current status and dispatches an error event if the
* request has failed and one has not already been dispatched.
*/
void errorCheck();
/**
* Dispatched when the channel begins receiving data.
*/
attribute EventHandler onstart;
/**
* Dispatched when the channel has finished receiving data.
*/
attribute EventHandler onstop;
/**
* Information about the proxy server which is handling this request, or
* null if the request is not proxied.
*/
[Cached, Frozen, GetterThrows, Pure]
readonly attribute MozProxyInfo? proxyInfo;
/**
* For HTTP requests, the IP address of the remote server handling the
* request. For other request types, returns null.
*/
[Cached, Pure]
readonly attribute ByteString? remoteAddress;
/**
* True if this load was triggered by a system caller. This currently always
* false if the request has no LoadInfo or is a top-level document load.
*/
[Cached, Pure]
readonly attribute boolean isSystemLoad;
/**
* The URL of the principal that triggered this load. This is equivalent to
* the LoadInfo's triggeringPrincipal, and will only ever be null for
* requests without LoadInfo.
*/
[Cached, Pure]
readonly attribute ByteString? originURL;
/**
* The URL of the document loading the content for this request. This is
* equivalent to the LoadInfo's loadingPrincipal. This may only ever be null
* for top-level requests and requests without LoadInfo.
*/
[Cached, Pure]
readonly attribute ByteString? documentURL;
/**
* The URI version of originURL. Will be null only when originURL is null.
*/
[Pure]
readonly attribute URI? originURI;
/**
* The URI version of documentURL. Will be null only when documentURL is
* null.
*/
[Pure]
readonly attribute URI? documentURI;
/**
* True if extensions may modify this request. This is currently false only
* if the request belongs to a document which has access to the
* mozAddonManager API.
*/
[Cached, GetterThrows, Pure]
readonly attribute boolean canModify;
/**
* The outer window ID of the frame that the request belongs to, or 0 if it
* is a top-level load or does not belong to a document.
*/
[Cached, Constant]
readonly attribute long long windowId;
/**
* The outer window ID of the parent frame of the window that the request
* belongs to, 0 if that parent frame is the top-level frame, and -1 if the
* request belongs to a top-level frame.
*/
[Cached, Constant]
readonly attribute long long parentWindowId;
/**
* For cross-process requests, the <browser> or <iframe> element to which the
* content loading this request belongs. For requests that don't originate
* from a remote browser, this is null.
*
* This is not an Element because those are by default only exposed in
* Window, but we're exposed in System.
*/
[Cached, Pure]
readonly attribute nsISupports? browserElement;
/**
* Returns an array of objects that combine the url and frameId from the
* ancestorPrincipals and ancestorOuterWindowIDs on loadInfo.
* The immediate parent is the first entry, the last entry is always the top
* level frame. It will be an empty list for toplevel window loads and
* non-subdocument resource loads within a toplevel window. For the latter,
* originURL will provide information on what window is doing the load. It
* will be null if the request is not associated with a window (e.g. XHR with
* mozBackgroundRequest = true).
*/
[Cached, Frozen, GetterThrows, Pure]
readonly attribute sequence<MozFrameAncestorInfo>? frameAncestors;
/**
* For HTTP requests, returns an array of request headers which will be, or
* have been, sent with this request.
*
* For non-HTTP requests, throws NS_ERROR_UNEXPECTED.
*/
[Throws]
sequence<MozHTTPHeader> getRequestHeaders();
/**
* For HTTP requests: returns the value of the request header, null if not set.
*
* For non-HTTP requests, throws NS_ERROR_UNEXPECTED.
*/
[Throws]
ByteString? getRequestHeader(ByteString header);
/**
* For HTTP requests, returns an array of response headers which were
* received for this request, in the same format as returned by
* getRequestHeaders.
* Throws NS_ERROR_NOT_AVAILABLE if a response has not yet been received, or
* NS_ERROR_UNEXPECTED if the channel is not an HTTP channel.
*
* Note: The Content-Type header is handled specially. That header is
* usually not mutable after the request has been received, and the content
* type must instead be changed via the contentType attribute. If a caller
* attempts to set the Content-Type header via setRequestHeader, however,
* that value is assigned to the contentType attribute and its original
* string value is cached. That original value is returned in place of the
* actual Content-Type header.
*/
[Throws]
sequence<MozHTTPHeader> getResponseHeaders();
/**
* Sets the given request header to the given value, overwriting any
* previous value. Setting a header to a null string has the effect of
* removing it. If merge is true, then the passed value will be merged
* to any existing value that exists for the header. Otherwise, any prior
* value for the header will be overwritten. Merge is ignored for headers
* that cannot be merged.
*
* For non-HTTP requests, throws NS_ERROR_UNEXPECTED.
*/
[Throws]
void setRequestHeader(ByteString header,
ByteString value,
optional boolean merge = false);
/**
* Sets the given response header to the given value, overwriting any
* previous value. Setting a header to a null string has the effect of
* removing it. If merge is true, then the passed value will be merged
* to any existing value that exists for the header (e.g. handling multiple
* Set-Cookie headers). Otherwise, any prior value for the header will be
* overwritten. Merge is ignored for headers that cannot be merged.
*
* For non-HTTP requests, throws NS_ERROR_UNEXPECTED.
*
* Note: The content type header is handled specially by this function. See
* getResponseHeaders() for details.
*/
[Throws]
void setResponseHeader(ByteString header,
ByteString value,
optional boolean merge = false);
};
/**
* Information about the proxy server handing a request. This is approximately
* equivalent to nsIProxyInfo.
*/
dictionary MozProxyInfo {
/**
* The hostname of the server.
*/
required ByteString host;
/**
* The TCP port of the server.
*/
required long port;
/**
* The type of proxy (e.g., HTTP, SOCKS).
*/
required ByteString type;
/**
* True if the proxy is responsible for DNS lookups.
*/
required boolean proxyDNS;
/**
* The authentication username for the proxy, if any.
*/
ByteString? username = null;
/**
* The timeout, in seconds, before the network stack will failover to the
* next candidate proxy server if it has not received a response.
*/
unsigned long failoverTimeout;
/**
* Any non-empty value will be passed directly as Proxy-Authorization header
* value for the CONNECT request attempt. However, this header set on the
* resource request itself takes precedence.
*/
ByteString? proxyAuthorizationHeader = null;
/**
* An optional key used for additional isolation of this proxy connection.
*/
ByteString? connectionIsolationKey = null;
};
/**
* MozFrameAncestorInfo combines loadInfo::AncestorPrincipals with
* loadInfo::AncestorOuterWindowIDs for easier access in the WebRequest API.
*
* url represents the parent of the loading window.
* frameId is the outerWindowID for the parent of the loading window.
*
* For further details see nsILoadInfo.idl and Document::AncestorPrincipals.
*/
dictionary MozFrameAncestorInfo {
required ByteString url;
required unsigned long long frameId;
};
/**
* Represents an HTTP request or response header.
*/
dictionary MozHTTPHeader {
/**
* The case-insensitive, non-case-normalized header name.
*/
required ByteString name;
/**
* The header value.
*/
required ByteString value;
};
/**
* An object used for filtering requests.
*/
dictionary MozRequestFilter {
/**
* If present, the request only matches if its `type` attribute matches one
* of the given types.
*/
sequence<MozContentPolicyType>? types = null;
/**
* If present, the request only matches if its finalURI matches the given
* match pattern set.
*/
sequence<DOMString>? urls = null;
/**
* If present, the request only matches if the loadInfo privateBrowsingId matches
* against the given incognito value.
*/
boolean? incognito = null;
};
dictionary MozRequestMatchOptions {
/**
* True if we're matching for the proxy portion of a proxied request.
*/
boolean isProxy = false;
};

143
dom/webidl/StreamFilter.webidl Normal file
View file

@ -0,0 +1,143 @@
/* 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/.
*/
/**
* This is a Mozilla-specific WebExtension API, which is not available to web
* content. It allows monitoring and filtering of HTTP response stream data.
*
* This API should currently be considered experimental, and is not defined by
* any standard.
*/
enum StreamFilterStatus {
/**
* The StreamFilter is not fully initialized. No methods may be called until
* a "start" event has been received.
*/
"uninitialized",
/**
* The underlying channel is currently transferring data, which will be
* dispatched via "data" events.
*/
"transferringdata",
/**
* The underlying channel has finished transferring data. Data may still be
* written via write() calls at this point.
*/
"finishedtransferringdata",
/**
* Data transfer is currently suspended. It may be resumed by a call to
* resume(). Data may still be written via write() calls in this state.
*/
"suspended",
/**
* The channel has been closed by a call to close(). No further data wlil be
* delivered via "data" events, and no further data may be written via
* write() calls.
*/
"closed",
/**
* The channel has been disconnected by a call to disconnect(). All further
* data will be delivered directly, without passing through the filter. No
* further events will be dispatched, and no further data may be written by
* write() calls.
*/
"disconnected",
/**
* An error has occurred and the channel is disconnected. The `error`
* property contains the details of the error.
*/
"failed",
};
/**
* An interface which allows an extension to intercept, and optionally modify,
* response data from an HTTP request.
*/
[Exposed=Window,
Func="mozilla::extensions::StreamFilter::IsAllowedInContext"]
interface StreamFilter : EventTarget {
/**
* Creates a stream filter for the given add-on and the given extension ID.
*/
[ChromeOnly]
static StreamFilter create(unsigned long long requestId, DOMString addonId);
/**
* Suspends processing of the request. After this is called, no further data
* will be delivered until the request is resumed.
*/
[Throws]
void suspend();
/**
* Resumes delivery of data for a suspended request.
*/
[Throws]
void resume();
/**
* Closes the request. After this is called, no more data may be written to
* the stream, and no further data will be delivered.
*
* This *must* be called after the consumer is finished writing data, unless
* disconnect() has already been called.
*/
[Throws]
void close();
/**
* Disconnects the stream filter from the request. After this is called, no
* further data will be delivered to the filter, and any unprocessed data
* will be written directly to the output stream.
*/
[Throws]
void disconnect();
/**
* Writes a chunk of data to the output stream. This may not be called
* before the "start" event has been received.
*/
[Throws]
void write((ArrayBuffer or Uint8Array) data);
/**
* Returns the current status of the stream.
*/
[Pure]
readonly attribute StreamFilterStatus status;
/**
* After an "error" event has been dispatched, this contains a message
* describing the error.
*/
[Pure]
readonly attribute DOMString error;
/**
* Dispatched with a StreamFilterDataEvent whenever incoming data is
* available on the stream. This data will not be delivered to the output
* stream unless it is explicitly written via a write() call.
*/
attribute EventHandler ondata;
/**
* Dispatched when the stream is opened, and is about to begin delivering
* data.
*/
attribute EventHandler onstart;
/**
* Dispatched when the stream has closed, and has no more data to deliver.
* The output stream remains open and writable until close() is called.
*/
attribute EventHandler onstop;
/**
* Dispatched when an error has occurred. No further data may be read or
* written after this point.
*/
attribute EventHandler onerror;
};

28
dom/webidl/StreamFilterDataEvent.webidl Normal file
View file

@ -0,0 +1,28 @@
/* 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/. */
/**
* This is a Mozilla-specific WebExtension API, which is not available to web
* content. It allows monitoring and filtering of HTTP response stream data.
*
* This API should currently be considered experimental, and is not defined by
* any standard.
*/
[Constructor(DOMString type,
optional StreamFilterDataEventInit eventInitDict),
Func="mozilla::extensions::StreamFilter::IsAllowedInContext",
Exposed=Window]
interface StreamFilterDataEvent : Event {
/**
* Contains a chunk of data read from the input stream.
*/
[Pure]
readonly attribute ArrayBuffer data;
};
dictionary StreamFilterDataEventInit : EventInit {
required ArrayBuffer data;
};

3
dom/webidl/moz.build
View file

@ -67,6 +67,7 @@ WEBIDL_FILES = [
'CDATASection.webidl',
'ChannelMergerNode.webidl',
'ChannelSplitterNode.webidl',
'ChannelWrapper.webidl',
'CharacterData.webidl',
'CheckerboardReportService.webidl',
'ChildNode.webidl',
@ -418,6 +419,8 @@ WEBIDL_FILES = [
'StorageEvent.webidl',
'StorageManager.webidl',
'StorageType.webidl',
'StreamFilter.webidl',
'StreamFilterDataEvent.webidl',
'StyleSheet.webidl',
'StyleSheetList.webidl',
'SubtleCrypto.webidl',