/* * Copyright (C) 2016 Apple Inc. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * 1. Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * 2. Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * THIS SOFTWARE IS PROVIDED BY APPLE INC. AND ITS CONTRIBUTORS ``AS IS'' * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR ITS CONTRIBUTORS * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF * THE POSSIBILITY OF SUCH DAMAGE. */ #pragma once #include "root.h" #include "ZigGlobalObject.h" #include "JSDOMGlobalObject.h" #include "JSDOMExceptionHandling.h" #include namespace WebCore { // Conversion from JSValue -> Implementation template struct Converter; namespace Detail { template inline T* getPtrOrRef(const T* p) { return const_cast(p); } template inline T& getPtrOrRef(const T& p) { return const_cast(p); } template inline T* getPtrOrRef(const RefPtr& p) { return p.get(); } template inline T& getPtrOrRef(const Ref& p) { return p.get(); } } struct DefaultExceptionThrower { void operator()(JSC::JSGlobalObject& lexicalGlobalObject, JSC::ThrowScope& scope) { throwTypeError(&lexicalGlobalObject, scope); } }; template typename Converter::ReturnType convert(JSC::JSGlobalObject&, JSC::JSValue); template typename Converter::ReturnType convert(JSC::JSGlobalObject&, JSC::JSValue, JSC::JSObject&); template typename Converter::ReturnType convert(JSC::JSGlobalObject&, JSC::JSValue, JSDOMGlobalObject&); template typename Converter::ReturnType convert(JSC::JSGlobalObject&, JSC::JSValue, ExceptionThrower&&); template typename Converter::ReturnType convert(JSC::JSGlobalObject&, JSC::JSValue, JSC::JSObject&, ExceptionThrower&&); template typename Converter::ReturnType convert(JSC::JSGlobalObject&, JSC::JSValue, JSDOMGlobalObject&, ExceptionThrower&&); template inline typename Converter::ReturnType convert(JSC::JSGlobalObject& lexicalGlobalObject, JSC::JSValue value) { return Converter::convert(lexicalGlobalObject, value); } template inline typename Converter::ReturnType convert(JSC::JSGlobalObject& lexicalGlobalObject, JSC::JSValue value, JSC::JSObject& thisObject) { return Converter::convert(lexicalGlobalObject, value, thisObject); } template inline typename Converter::ReturnType convert(JSC::JSGlobalObject& lexicalGlobalObject, JSC::JSValue value, JSDOMGlobalObject& globalObject) { return Converter::convert(lexicalGlobalObject, value, globalObject); } template inline typename Converter::ReturnType convert(JSC::JSGlobalObject& lexicalGlobalObject, JSC::JSValue value, ExceptionThrower&& exceptionThrower) { return Converter::convert(lexicalGlobalObject, value, std::forward(exceptionThrower)); } template inline typename Converter::ReturnType convert(JSC::JSGlobalObject& lexicalGlobalObject, JSC::JSValue value, JSC::JSObject& thisObject, ExceptionThrower&& exceptionThrower) { return Converter::convert(lexicalGlobalObject, value, thisObject, std::forward(exceptionThrower)); } template inline typename Converter::ReturnType convert(JSC::JSGlobalObject& lexicalGlobalObject, JSC::JSValue value, JSDOMGlobalObject& globalObject, ExceptionThrower&& exceptionThrower) { return Converter::convert(lexicalGlobalObject, value, globalObject, std::forward(exceptionThrower)); } // Conversion from Implementation -> JSValue template struct JSConverter; template inline JSC::JSValue toJS(U&&); template inline JSC::JSValue toJS(JSC::JSGlobalObject&, U&&); template inline JSC::JSValue toJS(JSC::JSGlobalObject&, JSDOMGlobalObject&, U&&); template inline JSC::JSValue toJSNewlyCreated(JSC::JSGlobalObject&, JSDOMGlobalObject&, U&&); template inline JSC::JSValue toJS(JSC::JSGlobalObject&, JSC::ThrowScope&, U&& valueOrFunctor); template inline JSC::JSValue toJS(JSC::JSGlobalObject&, JSDOMGlobalObject&, JSC::ThrowScope&, U&& valueOrFunctor); template inline JSC::JSValue toJSNewlyCreated(JSC::JSGlobalObject&, JSDOMGlobalObject&, JSC::ThrowScope&, U&& valueOrFunctor); template::needsState, bool needsGlobalObject = JSConverter::needsGlobalObject> struct JSConverterOverloader; template struct JSConverterOverloader { template static JSC::JSValue convert(JSC::JSGlobalObject& lexicalGlobalObject, JSDOMGlobalObject& globalObject, U&& value) { return JSConverter::convert(lexicalGlobalObject, globalObject, std::forward(value)); } }; template struct JSConverterOverloader { template static JSC::JSValue convert(JSC::JSGlobalObject& lexicalGlobalObject, U&& value) { return JSConverter::convert(lexicalGlobalObject, std::forward(value)); } template static JSC::JSValue convert(JSC::JSGlobalObject& lexicalGlobalObject, JSDOMGlobalObject&, U&& value) { return JSConverter::convert(lexicalGlobalObject, std::forward(value)); } }; template struct JSConverterOverloader { template static JSC::JSValue convert(JSC::JSGlobalObject&, U&& value) { return JSConverter::convert(std::forward(value)); } template static JSC::JSValue convert(JSC::JSGlobalObject&, JSDOMGlobalObject&, U&& value) { return JSConverter::convert(std::forward(value)); } }; template inline JSC::JSValue toJS(U&& value) { return JSConverter::convert(std::forward(value)); } template inline JSC::JSValue toJS(JSC::JSGlobalObject& lexicalGlobalObject, U&& value) { return JSConverterOverloader::convert(lexicalGlobalObject, std::forward(value)); } template inline JSC::JSValue toJS(JSC::JSGlobalObject& lexicalGlobalObject, JSDOMGlobalObject& globalObject, U&& value) { return JSConverterOverloader::convert(lexicalGlobalObject, globalObject, std::forward(value)); } template inline JSC::JSValue toJSNewlyCreated(JSC::JSGlobalObject& lexicalGlobalObject, JSDOMGlobalObject& globalObject, U&& value) { return JSConverter::convertNewlyCreated(lexicalGlobalObject, globalObject, std::forward(value)); } template inline JSC::JSValue toJS(JSC::JSGlobalObject& lexicalGlobalObject, JSC::ThrowScope& throwScope, U&& valueOrFunctor) { if constexpr (std::is_invocable_v) { using FunctorReturnType = std::invoke_result_t; if constexpr (std::is_same_v) { valueOrFunctor(); return JSC::jsUndefined(); } else if constexpr (std::is_same_v, FunctorReturnType>) { auto result = valueOrFunctor(); if (UNLIKELY(result.hasException())) { propagateException(lexicalGlobalObject, throwScope, result.releaseException()); return {}; } return JSC::jsUndefined(); } else return toJS(lexicalGlobalObject, throwScope, valueOrFunctor()); } else { if constexpr (IsExceptionOr) { if (UNLIKELY(valueOrFunctor.hasException())) { propagateException(lexicalGlobalObject, throwScope, valueOrFunctor.releaseException()); return {}; } return toJS(lexicalGlobalObject, valueOrFunctor.releaseReturnValue()); } else return toJS(lexicalGlobalObject, std::forward(valueOrFunctor)); } } template inline JSC::JSValue toJS(JSC::JSGlobalObject& lexicalGlobalObject, JSDOMGlobalObject& globalObject, JSC::ThrowScope& throwScope, U&& valueOrFunctor) { if constexpr (std::is_invocable_v) { using FunctorReturnType = std::invoke_result_t; if constexpr (std::is_same_v) { valueOrFunctor(); return JSC::jsUndefined(); } else if constexpr (std::is_same_v, FunctorReturnType>) { auto result = valueOrFunctor(); if (UNLIKELY(result.hasException())) { propagateException(lexicalGlobalObject, throwScope, result.releaseException()); return {}; } return JSC::jsUndefined(); } else return toJS(lexicalGlobalObject, globalObject, throwScope, valueOrFunctor()); } else { if constexpr (IsExceptionOr) { if (UNLIKELY(valueOrFunctor.hasException())) { propagateException(lexicalGlobalObject, throwScope, valueOrFunctor.releaseException()); return {}; } return toJS(lexicalGlobalObject, globalObject, valueOrFunctor.releaseReturnValue()); } else return toJS(lexicalGlobalObject, globalObject, std::forward(valueOrFunctor)); } } template inline JSC::JSValue toJSNewlyCreated(JSC::JSGlobalObject& lexicalGlobalObject, JSDOMGlobalObject& globalObject, JSC::ThrowScope& throwScope, U&& valueOrFunctor) { if constexpr (std::is_invocable_v) { using FunctorReturnType = std::invoke_result_t; if constexpr (std::is_same_v) { valueOrFunctor(); return JSC::jsUndefined(); } else if constexpr (std::is_same_v, FunctorReturnType>) { auto result = valueOrFunctor(); if (UNLIKELY(result.hasException())) { propagateException(lexicalGlobalObject, throwScope, result.releaseException()); return {}; } return JSC::jsUndefined(); } else return toJSNewlyCreated(lexicalGlobalObject, globalObject, throwScope, valueOrFunctor()); } else { if constexpr (IsExceptionOr) { if (UNLIKELY(valueOrFunctor.hasException())) { propagateException(lexicalGlobalObject, throwScope, valueOrFunctor.releaseException()); return {}; } return toJSNewlyCreated(lexicalGlobalObject, globalObject, valueOrFunctor.releaseReturnValue()); } else return toJSNewlyCreated(lexicalGlobalObject, globalObject, std::forward(valueOrFunctor)); } } template struct DefaultConverter { using ReturnType = typename T::ImplementationType; // We assume the worst, subtypes can override to be less pessimistic. // An example of something that can have side effects // is having a converter that does JSC::JSValue::toNumber. // toNumber() in JavaScript can call arbitrary JS functions. // // An example of something that does not have side effects // is something having a converter that does JSC::JSValue::toBoolean. // toBoolean() in JS can't call arbitrary functions. static constexpr bool conversionHasSideEffects = true; }; // Conversion from JSValue -> Implementation for variadic arguments template struct VariadicConverter; } // namespace WebCore