From 26a029d407be480d791972afb5975cf62c9360a6 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Fri, 19 Apr 2024 02:47:55 +0200 Subject: Adding upstream version 124.0.1. Signed-off-by: Daniel Baumann --- dom/bindings/Exceptions.h | 64 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 64 insertions(+) create mode 100644 dom/bindings/Exceptions.h (limited to 'dom/bindings/Exceptions.h') diff --git a/dom/bindings/Exceptions.h b/dom/bindings/Exceptions.h new file mode 100644 index 0000000000..19084aee2f --- /dev/null +++ b/dom/bindings/Exceptions.h @@ -0,0 +1,64 @@ +/* -*- 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_Exceptions_h__ +#define mozilla_dom_Exceptions_h__ + +// DOM exception throwing machinery (for both main thread and workers). + +#include +#include "jspubtd.h" +#include "nsString.h" +#include "jsapi.h" + +class nsIStackFrame; +class nsPIDOMWindowInner; +template +struct already_AddRefed; + +namespace mozilla::dom { + +class Exception; + +// If we're throwing a DOMException and message is empty, the default +// message for the nsresult in question will be used. +bool Throw(JSContext* cx, nsresult rv, const nsACString& message = ""_ns); + +// Create, throw and report an exception to a given window. +void ThrowAndReport(nsPIDOMWindowInner* aWindow, nsresult aRv); + +// Both signatures of ThrowExceptionObject guarantee that an exception is set on +// aCx before they return. +void ThrowExceptionObject(JSContext* aCx, Exception* aException); + +// Create an exception object for the given nsresult and message. If we're +// throwing a DOMException and aMessage is empty, the default message for the +// nsresult in question will be used. +// +// This never returns null. +already_AddRefed CreateException(nsresult aRv, + const nsACString& aMessage = ""_ns); + +// aMaxDepth can be used to define a maximal depth for the stack trace. If the +// value is -1, a default maximal depth will be selected. Will return null if +// there is no JS stack right now. +already_AddRefed GetCurrentJSStack(int32_t aMaxDepth = -1); + +// Internal stuff not intended to be widely used. +namespace exceptions { + +already_AddRefed CreateStack(JSContext* aCx, + JS::StackCapture&& aCaptureMode); + +// Like the above, but creates a JSStackFrame wrapper for an existing +// JS::SavedFrame object, passed as aStack. +already_AddRefed CreateStack(JSContext* aCx, + JS::Handle aStack); + +} // namespace exceptions +} // namespace mozilla::dom + +#endif -- cgit v1.2.3