summaryrefslogtreecommitdiffstats
path: root/dom/promise/PromiseDebugging.h
diff options
context:
space:
mode:
Diffstat (limited to 'dom/promise/PromiseDebugging.h')
-rw-r--r--dom/promise/PromiseDebugging.h108
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