mirror of
https://github.com/mozilla/gecko-dev.git
synced 2024-10-28 04:35:33 +00:00
01d4e4cfa4
Backed out changeset 9f46e7d52b9b (bug 1442931) Backed out changeset 608e21fcd167 (bug 1442931) --HG-- rename : dom/chrome-webidl/ChannelWrapper.webidl => dom/webidl/ChannelWrapper.webidl rename : dom/chrome-webidl/ChromeUtils.webidl => dom/webidl/ChromeUtils.webidl rename : dom/chrome-webidl/DominatorTree.webidl => dom/webidl/DominatorTree.webidl rename : dom/chrome-webidl/HeapSnapshot.webidl => dom/webidl/HeapSnapshot.webidl rename : dom/chrome-webidl/InspectorUtils.webidl => dom/webidl/InspectorUtils.webidl rename : dom/chrome-webidl/MatchGlob.webidl => dom/webidl/MatchGlob.webidl rename : dom/chrome-webidl/MatchPattern.webidl => dom/webidl/MatchPattern.webidl rename : dom/chrome-webidl/MozStorageAsyncStatementParams.webidl => dom/webidl/MozStorageAsyncStatementParams.webidl rename : dom/chrome-webidl/MozStorageStatementParams.webidl => dom/webidl/MozStorageStatementParams.webidl rename : dom/chrome-webidl/MozStorageStatementRow.webidl => dom/webidl/MozStorageStatementRow.webidl rename : dom/chrome-webidl/PrecompiledScript.webidl => dom/webidl/PrecompiledScript.webidl rename : dom/chrome-webidl/PromiseDebugging.webidl => dom/webidl/PromiseDebugging.webidl rename : dom/chrome-webidl/StructuredCloneHolder.webidl => dom/webidl/StructuredCloneHolder.webidl rename : dom/chrome-webidl/WebExtensionContentScript.webidl => dom/webidl/WebExtensionContentScript.webidl rename : dom/chrome-webidl/WebExtensionPolicy.webidl => dom/webidl/WebExtensionPolicy.webidl
109 lines
3.6 KiB
Plaintext
109 lines
3.6 KiB
Plaintext
/* -*- Mode: IDL; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
|
|
/* 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 utility namespace for promise-debugging functionality */
|
|
|
|
|
|
dictionary PromiseDebuggingStateHolder {
|
|
PromiseDebuggingState state = "pending";
|
|
any value;
|
|
any reason;
|
|
};
|
|
enum PromiseDebuggingState { "pending", "fulfilled", "rejected" };
|
|
|
|
/**
|
|
* An observer for Promise that _may_ be leaking uncaught rejections.
|
|
*
|
|
* It is generally a programming error to leave a Promise rejected and
|
|
* not consume its rejection. The information exposed by this
|
|
* interface is designed to allow clients to track down such Promise,
|
|
* i.e. Promise that are currently
|
|
* - in `rejected` state;
|
|
* - last of their chain.
|
|
*
|
|
* Note, however, that a promise in such a state at the end of a tick
|
|
* may eventually be consumed in some ulterior tick. Implementers of
|
|
* this interface are responsible for presenting the information
|
|
* in a meaningful manner.
|
|
*/
|
|
callback interface UncaughtRejectionObserver {
|
|
/**
|
|
* A Promise has been left in `rejected` state and is the
|
|
* last in its chain.
|
|
*
|
|
* @param p A currently uncaught Promise. If `p` is is eventually
|
|
* caught, i.e. if its `then` callback is called, `onConsumed` will
|
|
* be called.
|
|
*/
|
|
void onLeftUncaught(object p);
|
|
|
|
/**
|
|
* A Promise previously left uncaught is not the last in its
|
|
* chain anymore.
|
|
*
|
|
* @param p A Promise that was previously left in uncaught state is
|
|
* now caught, i.e. it is not the last in its chain anymore.
|
|
*/
|
|
void onConsumed(object p);
|
|
};
|
|
|
|
[ChromeOnly, Exposed=(Window,System)]
|
|
interface PromiseDebugging {
|
|
/**
|
|
* The various functions on this interface all expect to take promises but
|
|
* don't want the WebIDL behavior of assimilating random passed-in objects
|
|
* into promises. They also want to treat Promise subclass instances as
|
|
* promises instead of wrapping them in a vanilla Promise, which is what the
|
|
* IDL spec says to do. So we list all our arguments as "object" instead of
|
|
* "Promise" and check for them being a Promise internally.
|
|
*/
|
|
|
|
/**
|
|
* Get the current state of the given promise.
|
|
*/
|
|
[Throws]
|
|
static PromiseDebuggingStateHolder getState(object p);
|
|
|
|
/**
|
|
* Return an identifier for a promise. This identifier is guaranteed
|
|
* to be unique to the current process.
|
|
*/
|
|
[Throws]
|
|
static DOMString getPromiseID(object p);
|
|
|
|
/**
|
|
* Return the stack to the promise's allocation point. This can
|
|
* return null if the promise was not created from script.
|
|
*/
|
|
[Throws]
|
|
static object? getAllocationStack(object p);
|
|
|
|
/**
|
|
* Return the stack to the promise's rejection point, if the
|
|
* rejection happened from script. This can return null if the
|
|
* promise has not been rejected or was not rejected from script.
|
|
*/
|
|
[Throws]
|
|
static object? getRejectionStack(object p);
|
|
|
|
/**
|
|
* Return the stack to the promise's fulfillment point, if the
|
|
* fulfillment happened from script. This can return null if the
|
|
* promise has not been fulfilled or was not fulfilled from script.
|
|
*/
|
|
[Throws]
|
|
static object? getFullfillmentStack(object p);
|
|
|
|
/**
|
|
* Watching uncaught rejections on the current thread.
|
|
*
|
|
* Adding an observer twice will cause it to be notified twice
|
|
* of events.
|
|
*/
|
|
static void addUncaughtRejectionObserver(UncaughtRejectionObserver o);
|
|
static boolean removeUncaughtRejectionObserver(UncaughtRejectionObserver o);
|
|
};
|