diff options
Diffstat (limited to 'dom/promise/PromiseDebugging.h')
-rw-r--r-- | dom/promise/PromiseDebugging.h | 108 |
1 files changed, 108 insertions, 0 deletions
diff --git a/dom/promise/PromiseDebugging.h b/dom/promise/PromiseDebugging.h new file mode 100644 index 000000000..218a64c2e --- /dev/null +++ b/dom/promise/PromiseDebugging.h @@ -0,0 +1,108 @@ +/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */ +/* vim: set ts=8 sts=2 et sw=2 tw=80: */ +/* 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/. */ + +#ifndef mozilla_dom_PromiseDebugging_h +#define mozilla_dom_PromiseDebugging_h + +#include "js/TypeDecls.h" +#include "nsTArray.h" +#include "mozilla/RefPtr.h" + +namespace mozilla { + +class ErrorResult; + +namespace dom { +namespace workers { +class WorkerPrivate; +} // namespace workers + +class Promise; +struct PromiseDebuggingStateHolder; +class GlobalObject; +class UncaughtRejectionObserver; +class FlushRejections; + +void TriggerFlushRejections(); + +class PromiseDebugging +{ +public: + static void Init(); + static void Shutdown(); + + static void GetState(GlobalObject&, JS::Handle<JSObject*> aPromise, + PromiseDebuggingStateHolder& aState, + ErrorResult& aRv); + + static void GetPromiseID(GlobalObject&, JS::Handle<JSObject*>, nsString&, + ErrorResult&); + + static void GetAllocationStack(GlobalObject&, JS::Handle<JSObject*> aPromise, + JS::MutableHandle<JSObject*> aStack, + ErrorResult& aRv); + static void GetRejectionStack(GlobalObject&, JS::Handle<JSObject*> aPromise, + JS::MutableHandle<JSObject*> aStack, + ErrorResult& aRv); + static void GetFullfillmentStack(GlobalObject&, + JS::Handle<JSObject*> aPromise, + JS::MutableHandle<JSObject*> aStack, + ErrorResult& aRv); + +#ifndef SPIDERMONKEY_PROMISE + static void GetDependentPromises(GlobalObject&, + JS::Handle<JSObject*> aPromise, + nsTArray<RefPtr<Promise>>& aPromises, + ErrorResult& aRv); + static double GetPromiseLifetime(GlobalObject&, + JS::Handle<JSObject*> aPromise, + ErrorResult& aRv); + static double GetTimeToSettle(GlobalObject&, JS::Handle<JSObject*> aPromise, + ErrorResult& aRv); +#endif // SPIDERMONKEY_PROMISE + + // Mechanism for watching uncaught instances of Promise. + static void AddUncaughtRejectionObserver(GlobalObject&, + UncaughtRejectionObserver& aObserver); + static bool RemoveUncaughtRejectionObserver(GlobalObject&, + UncaughtRejectionObserver& aObserver); + +#ifdef SPIDERMONKEY_PROMISE + // Mark a Promise as having been left uncaught at script completion. + static void AddUncaughtRejection(JS::HandleObject); + // Mark a Promise previously added with `AddUncaughtRejection` as + // eventually consumed. + static void AddConsumedRejection(JS::HandleObject); +#else + // Mark a Promise as having been left uncaught at script completion. + static void AddUncaughtRejection(Promise&); + // Mark a Promise previously added with `AddUncaughtRejection` as + // eventually consumed. + static void AddConsumedRejection(Promise&); +#endif // SPIDERMONKEY_PROMISE + // Propagate the informations from AddUncaughtRejection + // and AddConsumedRejection to observers. + static void FlushUncaughtRejections(); + +protected: + static void FlushUncaughtRejectionsInternal(); + friend class FlushRejections; + friend class mozilla::dom::workers::WorkerPrivate; +private: + // Identity of the process. + // This property is: + // - set during initialization of the layout module, + // prior to any Worker using it; + // - read by both the main thread and the Workers; + // - unset during shutdown of the layout module, + // after any Worker has been shutdown. + static nsString sIDPrefix; +}; + +} // namespace dom +} // namespace mozilla + +#endif // mozilla_dom_PromiseDebugging_h |