diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-19 00:47:55 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-19 00:47:55 +0000 |
commit | 26a029d407be480d791972afb5975cf62c9360a6 (patch) | |
tree | f435a8308119effd964b339f76abb83a57c29483 /dom/base/TimeoutHandler.h | |
parent | Initial commit. (diff) | |
download | firefox-26a029d407be480d791972afb5975cf62c9360a6.tar.xz firefox-26a029d407be480d791972afb5975cf62c9360a6.zip |
Adding upstream version 124.0.1.upstream/124.0.1
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'dom/base/TimeoutHandler.h')
-rw-r--r-- | dom/base/TimeoutHandler.h | 104 |
1 files changed, 104 insertions, 0 deletions
diff --git a/dom/base/TimeoutHandler.h b/dom/base/TimeoutHandler.h new file mode 100644 index 0000000000..f8dd350af6 --- /dev/null +++ b/dom/base/TimeoutHandler.h @@ -0,0 +1,104 @@ +/* -*- 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_timeout_handler_h +#define mozilla_dom_timeout_handler_h + +#include "nsCOMPtr.h" +#include "nsIGlobalObject.h" +#include "nsISupports.h" +#include "nsCycleCollectionParticipant.h" +#include "nsString.h" +#include "mozilla/Attributes.h" +#include "mozilla/dom/FunctionBinding.h" + +namespace mozilla::dom { + +/** + * Utility class for implementing nsITimeoutHandlers, designed to be subclassed. + */ +class TimeoutHandler : public nsISupports { + public: + MOZ_CAN_RUN_SCRIPT virtual bool Call(const char* /* unused */); + // Get the location of the script. + // Note: The memory pointed to by aFileName is owned by the + // nsITimeoutHandler and should not be freed by the caller. + virtual void GetLocation(const char** aFileName, uint32_t* aLineNo, + uint32_t* aColumn); + // Append a UTF-8 string to aOutString that describes the callback function, + // for use in logging or profiler markers. + // The string contains the function name and its source location, if + // available, in the following format: + // "<functionName> (<sourceURL>:<lineNumber>:<columnNumber>)" + virtual void GetDescription(nsACString& aOutString); + virtual void MarkForCC() {} + + protected: + TimeoutHandler() : mFileName(""), mLineNo(0), mColumn(1) {} + explicit TimeoutHandler(JSContext* aCx); + + virtual ~TimeoutHandler() = default; + + // filename, line number and JS language version string of the + // caller of setTimeout() + nsCString mFileName; + uint32_t mLineNo; + uint32_t mColumn; + + private: + TimeoutHandler(const TimeoutHandler&) = delete; + TimeoutHandler& operator=(const TimeoutHandler&) = delete; + TimeoutHandler& operator=(const TimeoutHandler&&) = delete; +}; + +class ScriptTimeoutHandler : public TimeoutHandler { + public: + NS_DECL_CYCLE_COLLECTING_ISUPPORTS + NS_DECL_CYCLE_COLLECTION_CLASS(ScriptTimeoutHandler) + + ScriptTimeoutHandler(JSContext* aCx, nsIGlobalObject* aGlobal, + const nsAString& aExpression); + + MOZ_CAN_RUN_SCRIPT virtual bool Call(const char* /* unused */) override { + return false; + }; + virtual void GetDescription(nsACString& aOutString) override; + + protected: + virtual ~ScriptTimeoutHandler() = default; + + nsCOMPtr<nsIGlobalObject> mGlobal; + // The expression to evaluate or function to call. If mFunction is non-null + // it should be used, else use mExpr. + nsString mExpr; +}; + +class CallbackTimeoutHandler final : public TimeoutHandler { + public: + NS_DECL_CYCLE_COLLECTING_ISUPPORTS + NS_DECL_CYCLE_COLLECTION_SCRIPT_HOLDER_CLASS(CallbackTimeoutHandler) + + CallbackTimeoutHandler(JSContext* aCx, nsIGlobalObject* aGlobal, + Function* aFunction, + nsTArray<JS::Heap<JS::Value>>&& aArguments); + + MOZ_CAN_RUN_SCRIPT virtual bool Call(const char* aExecutionReason) override; + virtual void MarkForCC() override; + virtual void GetDescription(nsACString& aOutString) override; + + void ReleaseJSObjects(); + + private: + virtual ~CallbackTimeoutHandler() { ReleaseJSObjects(); } + + nsCOMPtr<nsIGlobalObject> mGlobal; + RefPtr<Function> mFunction; + nsTArray<JS::Heap<JS::Value>> mArgs; +}; + +} // namespace mozilla::dom + +#endif // mozilla_dom_timeout_handler_h |