{% from 'utilities.cpp' import declare_enum_validation_variable, v8_value_to_local_cpp_value, check_origin_trial %} {##############################################################################} {% macro generate_method(method, world_suffix) %} {% if method.returns_promise and method.has_exception_state %} static void {{method.name}}{{method.overload_index}}Method{{world_suffix}}Promise(const v8::FunctionCallbackInfo& info, ExceptionState& exceptionState) {% else %} static void {{method.name}}{{method.overload_index}}Method{{world_suffix}}(const v8::FunctionCallbackInfo& info) {% endif %} { {# Local variables #} {% if method.has_exception_state and not method.returns_promise %} ExceptionState exceptionState(ExceptionState::ExecutionContext, "{{method.name}}", "{{interface_name}}", info.Holder(), info.GetIsolate()); {% endif %} {# Overloaded methods have length checked during overload resolution #} {% if method.number_of_required_arguments and not method.overload_index %} if (UNLIKELY(info.Length() < {{method.number_of_required_arguments}})) { {{throw_minimum_arity_type_error(method, method.number_of_required_arguments) | indent(8)}} } {% endif %} {% if not method.is_static %} {{cpp_class}}* impl = {{v8_class}}::toImpl(info.Holder()); {% endif %} {% if method.is_custom_element_callbacks %} CustomElementProcessingStack::CallbackDeliveryScope deliveryScope; {% endif %} {# Security checks #} {% if method.is_check_security_for_receiver %} {% if interface_name == 'EventTarget' %} // Performance hack for EventTarget. Checking whether it's a Window or not // prior to the call to BindingSecurity::shouldAllowAccessTo increases 30% // of speed performance on Android Nexus 7 as of Dec 2016. ALWAYS_INLINE // didn't work in this case. if (LocalDOMWindow* window = impl->toDOMWindow()) { if (!BindingSecurity::shouldAllowAccessTo(info.GetIsolate(), callingDOMWindow(info.GetIsolate()), window, exceptionState)) { {% if not method.returns_promise %} exceptionState.throwIfNeeded(); {% endif %} return; } } {% else %}{# interface_name == 'EventTarget' #} if (!BindingSecurity::shouldAllowAccessTo(info.GetIsolate(), callingDOMWindow(info.GetIsolate()), impl, exceptionState)) { {% if not method.returns_promise %} exceptionState.throwIfNeeded(); {% endif %} return; } {% endif %}{# interface_name == 'EventTarget' #} {% endif %} {% if method.is_check_security_for_return_value %} if (!BindingSecurity::shouldAllowAccessTo(info.GetIsolate(), callingDOMWindow(info.GetIsolate()), {{method.cpp_value}}, exceptionState)) { v8SetReturnValueNull(info); {% if not method.returns_promise %} exceptionState.throwIfNeeded(); {% endif %} return; } {% endif %} {# Call method #} {% if method.arguments %} {{generate_arguments(method, world_suffix) | indent}} {% endif %} {% if world_suffix %} {{cpp_method_call(method, method.v8_set_return_value_for_main_world, method.cpp_value) | indent}} {% else %} {{cpp_method_call(method, method.v8_set_return_value, method.cpp_value) | indent}} {% endif %} } {% if method.returns_promise and method.has_exception_state %} static void {{method.name}}{{method.overload_index}}Method{{world_suffix}}(const v8::FunctionCallbackInfo& info) { ExceptionState exceptionState(ExceptionState::ExecutionContext, "{{method.name}}", "{{interface_name}}", info.Holder(), info.GetIsolate()); {{method.name}}{{method.overload_index}}Method{{world_suffix}}Promise(info, exceptionState); if (exceptionState.hadException()) v8SetReturnValue(info, exceptionState.reject(ScriptState::current(info.GetIsolate())).v8Value()); } {% endif %} {% endmacro %} {######################################} {% macro generate_arguments(method, world_suffix) %} {% for argument in method.arguments %} {{generate_argument_var_declaration(argument)}}; {% endfor %} { {% if method.has_optional_argument_without_default_value %} {# Count the effective number of arguments. (arg1, arg2, undefined) is interpreted as two arguments are passed and (arg1, undefined, arg3) is interpreted as three arguments are passed. #} int numArgsPassed = info.Length(); while (numArgsPassed > 0) { if (!info[numArgsPassed - 1]->IsUndefined()) break; --numArgsPassed; } {% endif %} {% for argument in method.arguments %} {% if argument.set_default_value %} if (!info[{{argument.index}}]->IsUndefined()) { {{generate_argument(method, argument, world_suffix) | indent(8)}} } else { {{argument.set_default_value}}; } {% else %} {{generate_argument(method, argument, world_suffix) | indent}} {% endif %} {% endfor %} } {% endmacro %} {######################################} {% macro generate_argument_var_declaration(argument) %} {# FIXME: remove EventListener special case #} {% if argument.idl_type == 'EventListener' %} RefPtrWillBeRawPtr<{{argument.idl_type}}> {{argument.name}} {%- else %} {{argument.cpp_type}} {{argument.name}} {%- endif %}{# argument.idl_type == 'EventListener' #} {% endmacro %} {######################################} {% macro generate_argument(method, argument, world_suffix) %} {% if argument.is_optional_without_default_value %} {# Optional arguments without a default value generate an early call with fewer arguments if they are omitted. Optional Dictionary arguments default to empty dictionary. #} if (UNLIKELY(numArgsPassed <= {{argument.index}})) { {% if world_suffix %} {{cpp_method_call(method, argument.v8_set_return_value_for_main_world, argument.cpp_value) | indent}} {% else %} {{cpp_method_call(method, argument.v8_set_return_value, argument.cpp_value) | indent}} {% endif %} {% if argument.has_event_listener_argument %} {{hidden_dependency_action(method.name) | indent}} {% endif %} return; } {% endif %} {% if argument.is_callback_interface %} {# FIXME: remove EventListener special case #} {% if argument.idl_type == 'EventListener' %} {% if method.name == 'removeEventListener' or method.name == 'removeListener' %} {{argument.name}} = V8EventListenerList::getEventListener(ScriptState::current(info.GetIsolate()), info[{{argument.index}}], false, ListenerFindOnly); {% else %}{# method.name == 'addEventListener' #} {{argument.name}} = V8EventListenerList::getEventListener(ScriptState::current(info.GetIsolate()), info[{{argument.index}}], false, ListenerFindOrCreate); {% endif %}{# method.name #} {% else %}{# argument.idl_type == 'EventListener' #} {# Callback functions must be functions: http://www.w3.org/TR/WebIDL/#es-callback-function #} {% if argument.is_optional %} if (!isUndefinedOrNull(info[{{argument.index}}])) { if (!info[{{argument.index}}]->IsFunction()) { {{throw_type_error(method, '"The callback provided as parameter %s is not a function."' % (argument.index + 1)) | indent(8)}} } {{argument.name}} = V8{{argument.idl_type}}::create(v8::Local::Cast(info[{{argument.index}}]), ScriptState::current(info.GetIsolate())); } else { {{argument.name}} = nullptr; } {% else %}{# argument.is_optional #} if (info.Length() <= {{argument.index}} || !{% if argument.is_nullable %}(info[{{argument.index}}]->IsFunction() || info[{{argument.index}}]->IsNull()){% else %}info[{{argument.index}}]->IsFunction(){% endif %}) { {{throw_type_error(method, '"The callback provided as parameter %s is not a function."' % (argument.index + 1)) | indent}} } {{argument.name}} = {% if argument.is_nullable %}info[{{argument.index}}]->IsNull() ? nullptr : {% endif %}V8{{argument.idl_type}}::create(v8::Local::Cast(info[{{argument.index}}]), ScriptState::current(info.GetIsolate())); {% endif %}{# argument.is_optional #} {% endif %}{# argument.idl_type == 'EventListener' #} {% elif argument.is_callback_function %} if (!info[{{argument.index}}]->IsFunction(){% if argument.is_nullable %} && !info[{{argument.index}}]->IsNull(){% endif %}) { {{throw_type_error(method, '"The callback provided as parameter %s is not a function."' % (argument.index + 1)) | indent}} } {{v8_value_to_local_cpp_value(argument)}} {% elif argument.is_variadic_wrapper_type %} for (int i = {{argument.index}}; i < info.Length(); ++i) { if (!V8{{argument.idl_type}}::hasInstance(info[i], info.GetIsolate())) { {{throw_type_error(method, '"parameter %s is not of type \'%s\'."' % (argument.index + 1, argument.idl_type)) | indent(8)}} } {{argument.name}}.append(V8{{argument.idl_type}}::toImpl(v8::Local::Cast(info[i]))); } {% elif argument.is_dictionary %} {% if not argument.use_permissive_dictionary_conversion %} {# Dictionaries must have type Undefined, Null or Object: http://heycam.github.io/webidl/#es-dictionary #} if (!isUndefinedOrNull(info[{{argument.index}}]) && !info[{{argument.index}}]->IsObject()) { {{throw_type_error(method, '"parameter %s (\'%s\') is not an object."' % (argument.index + 1, argument.name)) | indent}} } {% endif %}{# not argument.use_permissive_dictionary_conversion #} {{v8_value_to_local_cpp_value(argument)}} {% elif argument.is_explicit_nullable %} if (!isUndefinedOrNull(info[{{argument.index}}])) { {{v8_value_to_local_cpp_value(argument) | indent}} } {% else %}{# argument.is_nullable #} {{v8_value_to_local_cpp_value(argument)}} {% endif %}{# argument.is_nullable #} {# Type checking, possibly throw a TypeError, per: http://www.w3.org/TR/WebIDL/#es-type-mapping #} {% if argument.has_type_checking_interface and not argument.is_variadic_wrapper_type %} {# Type checking for wrapper interface types (if interface not implemented, throw a TypeError), per http://www.w3.org/TR/WebIDL/#es-interface Note: for variadic arguments, the type checking is done for each matched argument instead; see argument.is_variadic_wrapper_type code-path above. #} if (!{{argument.name}}{% if argument.is_nullable %} && !isUndefinedOrNull(info[{{argument.index}}]){% endif %}) { {{throw_type_error(method, '"parameter %s is not of type \'%s\'."' % (argument.index + 1, argument.idl_type)) | indent}} } {% elif argument.enum_values %} {# Invalid enum values: http://www.w3.org/TR/WebIDL/#idl-enums #} {{declare_enum_validation_variable(argument.enum_values)}} if (!isValidEnum({{argument.name}}, validValues, WTF_ARRAY_LENGTH(validValues), "{{argument.enum_type}}", exceptionState)) { exceptionState.throwIfNeeded(); return; } {% elif argument.idl_type == 'Promise' %} {# We require this for our implementation of promises, though not in spec: http://heycam.github.io/webidl/#es-promise #} if (!{{argument.name}}.isUndefinedOrNull() && !{{argument.name}}.isObject()) { {{throw_type_error(method, '"parameter %s (\'%s\') is not an object."' % (argument.index + 1, argument.name)) | indent}} } {% endif %} {% endmacro %} {######################################} {% macro cpp_method_call(method, v8_set_return_value, cpp_value) %} {% if method.is_custom_call_prologue %} {{v8_class}}::{{method.name}}MethodPrologueCustom(info, impl); {% endif %} {# Local variables #} {% if method.is_call_with_script_state or method.is_call_with_this_value %} {# [ConstructorCallWith=ScriptState] #} {# [CallWith=ScriptState] #} ScriptState* scriptState = ScriptState::current(info.GetIsolate()); {% endif %} {% if method.is_call_with_execution_context %} {# [ConstructorCallWith=ExecutionContext] #} {# [CallWith=ExecutionContext] #} ExecutionContext* executionContext = currentExecutionContext(info.GetIsolate()); {% endif %} {% if method.is_call_with_script_arguments %} {# [CallWith=ScriptArguments] #} RefPtrWillBeRawPtr scriptArguments(ScriptArguments::create(scriptState, info, {{method.number_of_arguments}})); {% endif %} {% if method.is_call_with_document %} {# [ConstructorCallWith=Document] #} Document& document = *toDocument(currentExecutionContext(info.GetIsolate())); {% endif %} {# Call #} {% if method.idl_type == 'void' %} {{cpp_value}}; {% elif method.is_implemented_in_private_script %} {{method.cpp_type}} result{{method.cpp_type_initializer}}; if (!{{method.cpp_value}}) return; {% elif method.use_output_parameter_for_result %} {{method.cpp_type}} result; {{cpp_value}}; {% elif method.is_constructor %} {{method.cpp_type}} impl = {{cpp_value}}; {% elif method.use_local_result %} {{method.cpp_type}} result = {{cpp_value}}; {% endif %} {# Post-call #} {% if method.is_raises_exception %} if (exceptionState.hadException()) { {{propagate_error_with_exception_state(method) | indent}} } {% endif %} {# Set return value #} {% if method.is_constructor %} {{generate_constructor_wrapper(method)}} {%- elif v8_set_return_value %} {% if method.is_explicit_nullable %} if (result.isNull()) v8SetReturnValueNull(info); else {{v8_set_return_value}}; {% else %} {{v8_set_return_value}}; {% endif %} {%- endif %}{# None for void #} {% if method.is_custom_call_epilogue %} {{v8_class}}::{{method.name}}MethodEpilogueCustom(info, impl); {% endif %} {% endmacro %} {######################################} {% macro throw_type_error(method, error_message) %} {% if method.has_exception_state %} exceptionState.throwTypeError({{error_message}}); {{propagate_error_with_exception_state(method)}} {% elif method.idl_type == 'Promise' %} v8SetReturnValue(info, ScriptPromise::rejectRaw(ScriptState::current(info.GetIsolate()), V8ThrowException::createTypeError(info.GetIsolate(), {{type_error_message(method, error_message)}}))); return; {% else %} V8ThrowException::throwTypeError(info.GetIsolate(), {{type_error_message(method, error_message)}}); return; {% endif %}{# method.has_exception_state #} {% endmacro %} {######################################} {% macro type_error_message(method, error_message) %} {% if method.is_constructor %} ExceptionMessages::failedToConstruct("{{interface_name}}", {{error_message}}) {%- else %} ExceptionMessages::failedToExecute("{{method.name}}", "{{interface_name}}", {{error_message}}) {%- endif %} {%- endmacro %} {######################################} {% macro propagate_error_with_exception_state(method_or_overloads) %} {% if method_or_overloads.returns_promise_all %} v8SetReturnValue(info, exceptionState.reject(ScriptState::current(info.GetIsolate())).v8Value()); {% elif not method_or_overloads.returns_promise %} exceptionState.throwIfNeeded(); {% endif %} return; {%- endmacro %} {######################################} {% macro throw_minimum_arity_type_error(method, number_of_required_arguments) %} {% if method.has_exception_state %} setMinimumArityTypeError(exceptionState, {{number_of_required_arguments}}, info.Length()); {{propagate_error_with_exception_state(method)}} {%- elif method.idl_type == 'Promise' %} v8SetReturnValue(info, ScriptPromise::rejectRaw(ScriptState::current(info.GetIsolate()), {{create_minimum_arity_type_error_without_exception_state(method, number_of_required_arguments)}})); return; {%- else %} V8ThrowException::throwException({{create_minimum_arity_type_error_without_exception_state(method, number_of_required_arguments)}}, info.GetIsolate()); return; {%- endif %} {%- endmacro %} {######################################} {% macro create_minimum_arity_type_error_without_exception_state(method, number_of_required_arguments) %} {% if method.is_constructor %} createMinimumArityTypeErrorForConstructor(info.GetIsolate(), "{{interface_name}}", {{number_of_required_arguments}}, info.Length()) {%- else %} createMinimumArityTypeErrorForMethod(info.GetIsolate(), "{{method.name}}", "{{interface_name}}", {{number_of_required_arguments}}, info.Length()) {%- endif %} {%- endmacro %} {##############################################################################} {% macro runtime_determined_length_method(overloads) %} static int {{overloads.name}}MethodLength() { {% for length, runtime_enabled_functions in overloads.runtime_determined_lengths %} {% for runtime_enabled_function in runtime_enabled_functions %} {% filter runtime_enabled(runtime_enabled_function) %} return {{length}}; {% endfilter %} {% endfor %} {% endfor %} } {% endmacro %} {##############################################################################} {% macro runtime_determined_maxarg_method(overloads) %} static int {{overloads.name}}MethodMaxArg() { {% for length, runtime_enabled_functions in overloads.runtime_determined_maxargs %} {% for runtime_enabled_function in runtime_enabled_functions %} {% filter runtime_enabled(runtime_enabled_function) %} return {{length}}; {% endfilter %} {% endfor %} {% endfor %} } {% endmacro %} {##############################################################################} {# FIXME: We should return a rejected Promise if an error occurs in this function when ALL methods in this overload return Promise. In order to do so, we must ensure either ALL or NO methods in this overload return Promise #} {% macro overload_resolution_method(overloads, world_suffix) %} static void {{overloads.name}}Method{{world_suffix}}(const v8::FunctionCallbackInfo& info) { ExceptionState exceptionState(ExceptionState::ExecutionContext, "{{overloads.name}}", "{{interface_name}}", info.Holder(), info.GetIsolate()); {% if overloads.measure_all_as %} UseCounter::countIfNotPrivateScript(info.GetIsolate(), currentExecutionContext(info.GetIsolate()), UseCounter::{{overloads.measure_all_as}}); {% endif %} {% if overloads.deprecate_all_as %} Deprecation::countDeprecationIfNotPrivateScript(info.GetIsolate(), currentExecutionContext(info.GetIsolate()), UseCounter::{{overloads.deprecate_all_as}}); {% endif %} {# First resolve by length #} {# 2. Initialize argcount to be min(maxarg, n). #} switch (std::min({{overloads.maxarg}}, info.Length())) { {# 3. Remove from S all entries whose type list is not of length argcount. #} {% for length, tests_methods in overloads.length_tests_methods %} {# 10. If i = d, then: #} case {{length}}: {# Then resolve by testing argument #} {% for test, method in tests_methods %} {% if method.visible %} {% filter runtime_enabled(not overloads.runtime_enabled_function_all and method.runtime_enabled_function) %} if ({{test}}) { {% if method.measure_as and not overloads.measure_all_as %} UseCounter::countIfNotPrivateScript(info.GetIsolate(), currentExecutionContext(info.GetIsolate()), UseCounter::{{method.measure_as('Method')}}); {% endif %} {% if method.deprecate_as and not overloads.deprecate_all_as %} Deprecation::countDeprecationIfNotPrivateScript(info.GetIsolate(), currentExecutionContext(info.GetIsolate()), UseCounter::{{method.deprecate_as}}); {% endif %} {{method.name}}{{method.overload_index}}Method{{world_suffix}}(info); return; } {% endfilter %} {% endif %} {% endfor %} break; {% endfor %} {% if is_partial or not overloads.has_partial_overloads %} default: {# If methods are overloaded between interface and partial interface #} {# definitions, need to invoke methods defined in the partial #} {# interface. #} {# FIXME: we do not need to always generate this code. #} {# Invalid arity, throw error #} {# Report full list of valid arities if gaps and above minimum #} {% if overloads.valid_arities %} if (info.Length() >= {{overloads.length}}) { setArityTypeError(exceptionState, "{{overloads.valid_arities}}", info.Length()); {{propagate_error_with_exception_state(overloads) | indent(12)}} } {% endif %} break; {% endif %} } {% if not is_partial and overloads.has_partial_overloads %} ASSERT({{overloads.name}}MethodForPartialInterface); ({{overloads.name}}MethodForPartialInterface)(info); {% else %} {% if overloads.length != 0 %} if (info.Length() < {{overloads.length}}) { {# Otherwise just report "not enough arguments" #} exceptionState.throwTypeError(ExceptionMessages::notEnoughArguments({{overloads.length}}, info.Length())); {{propagate_error_with_exception_state(overloads) | indent(8)}} } {% endif %} {# No match, throw error #} exceptionState.throwTypeError("No function was found that matched the signature provided."); {{propagate_error_with_exception_state(overloads) | indent}} {% endif %} } {% endmacro %} {##############################################################################} {% macro generate_post_message_impl() %} void postMessageImpl(const char* interfaceName, {{cpp_class}}* instance, const v8::FunctionCallbackInfo& info) { ExceptionState exceptionState(ExceptionState::ExecutionContext, "postMessage", interfaceName, info.Holder(), info.GetIsolate()); if (UNLIKELY(info.Length() < 1)) { setMinimumArityTypeError(exceptionState, 1, info.Length()); exceptionState.throwIfNeeded(); return; } OwnPtrWillBeRawPtr ports = adoptPtrWillBeNoop(new MessagePortArray); ArrayBufferArray arrayBuffers; ImageBitmapArray imageBitmaps; if (info.Length() > 1) { const int transferablesArgIndex = 1; if (!SerializedScriptValue::extractTransferables(info.GetIsolate(), info[transferablesArgIndex], transferablesArgIndex, *ports, arrayBuffers, imageBitmaps, exceptionState)) { exceptionState.throwIfNeeded(); return; } } RefPtr message = SerializedScriptValueFactory::instance().create(info.GetIsolate(), info[0], ports.get(), &arrayBuffers, &imageBitmaps, exceptionState); if (exceptionState.throwIfNeeded()) return; // FIXME: Only pass context/exceptionState if instance really requires it. ExecutionContext* context = currentExecutionContext(info.GetIsolate()); instance->postMessage(context, message.release(), ports.get(), exceptionState); exceptionState.throwIfNeeded(); } {% endmacro %} {##############################################################################} {% macro method_callback(method, world_suffix) %} static void {{method.name}}MethodCallback{{world_suffix}}(const v8::FunctionCallbackInfo& info) { {% if not method.overloads %}{# Overloaded methods are measured in overload_resolution_method() #} {% if method.measure_as %} UseCounter::countIfNotPrivateScript(info.GetIsolate(), currentExecutionContext(info.GetIsolate()), UseCounter::{{method.measure_as('Method')}}); {% endif %} {% if method.deprecate_as %} Deprecation::countDeprecationIfNotPrivateScript(info.GetIsolate(), currentExecutionContext(info.GetIsolate()), UseCounter::{{method.deprecate_as}}); {% endif %} {% if method.is_origin_trial_enabled %} {{check_origin_trial(method) | indent}} {% endif %} {% endif %}{# not method.overloads #} {% if world_suffix in method.activity_logging_world_list %} ScriptState* scriptState = ScriptState::from(info.GetIsolate()->GetCurrentContext()); V8PerContextData* contextData = scriptState->perContextData(); {% if method.activity_logging_world_check %} if (scriptState->world().isIsolatedWorld() && contextData && contextData->activityLogger()) {% else %} if (contextData && contextData->activityLogger()) { {% endif %} ExceptionState exceptionState(ExceptionState::ExecutionContext, "{{method.name}}", "{{interface_name}}", info.Holder(), info.GetIsolate()); Vector> loggerArgs = toImplArguments>>(info, 0, exceptionState); contextData->activityLogger()->logMethod("{{interface_name}}.{{method.name}}", info.Length(), loggerArgs.data()); } {% endif %} {% if method.is_custom %} {{v8_class}}::{{method.name}}MethodCustom(info); {% elif method.is_post_message %} postMessageImpl("{{interface_name}}", {{v8_class}}::toImpl(info.Holder()), info); {% else %} {{cpp_class_or_partial}}V8Internal::{{method.name}}Method{{world_suffix}}(info); {% endif %} } {% endmacro %} {##############################################################################} {% macro origin_safe_method_getter(method, world_suffix) %} static void {{method.name}}OriginSafeMethodGetter{{world_suffix}}(const v8::PropertyCallbackInfo& info) { {% set signature = 'v8::Local()' if method.is_do_not_check_signature else 'v8::Signature::New(info.GetIsolate(), %s::domTemplate(info.GetIsolate()))' % v8_class %} static int domTemplateKey; // This address is used for a key to look up the dom template. V8PerIsolateData* data = V8PerIsolateData::from(info.GetIsolate()); {# FIXME: 1 case of [DoNotCheckSignature] in Window.idl may differ #} v8::Local domTemplate = data->domTemplate(&domTemplateKey, {{cpp_class}}V8Internal::{{method.name}}MethodCallback{{world_suffix}}, v8Undefined(), {{signature}}, {{method.length}}); // It is unsafe to use info.Holder() because OriginSafeMethodGetter is called // back without checking the type of info.Holder(). v8::Local holder = {{v8_class}}::findInstanceInPrototypeChain(info.This(), info.GetIsolate()); if (holder.IsEmpty()) { v8SetReturnValue(info, domTemplate->GetFunction(info.GetIsolate()->GetCurrentContext()).ToLocalChecked()); return; } {{cpp_class}}* impl = {{v8_class}}::toImpl(holder); if (!BindingSecurity::shouldAllowAccessTo(info.GetIsolate(), callingDOMWindow(info.GetIsolate()), impl, DoNotReportSecurityError)) { v8SetReturnValue(info, domTemplate->GetFunction(info.GetIsolate()->GetCurrentContext()).ToLocalChecked()); return; } {# The findInstanceInPrototypeChain() call above only returns a non-empty handle if info.This() is an Object. #} v8::Local hiddenValue = V8HiddenValue::getHiddenValue(ScriptState::current(info.GetIsolate()), v8::Local::Cast(info.This()), v8AtomicString(info.GetIsolate(), "{{method.name}}")); if (!hiddenValue.IsEmpty()) { v8SetReturnValue(info, hiddenValue); return; } v8SetReturnValue(info, domTemplate->GetFunction(info.GetIsolate()->GetCurrentContext()).ToLocalChecked()); } static void {{method.name}}OriginSafeMethodGetterCallback{{world_suffix}}(v8::Local, const v8::PropertyCallbackInfo& info) { {{cpp_class}}V8Internal::{{method.name}}OriginSafeMethodGetter{{world_suffix}}(info); } {% endmacro %} {##############################################################################} {% macro method_implemented_in_private_script(method) %} bool {{v8_class}}::PrivateScript::{{method.name}}Method({{method.argument_declarations_for_private_script | join(', ')}}) { if (!frame) return false; v8::HandleScope handleScope(toIsolate(frame)); ScriptForbiddenScope::AllowUserAgentScript script; ScriptState* scriptState = ScriptState::forWorld(frame, DOMWrapperWorld::privateScriptIsolatedWorld()); if (!scriptState) return false; ScriptState* scriptStateInUserScript = ScriptState::forMainWorld(frame); if (!scriptStateInUserScript) return false; ScriptState::Scope scope(scriptState); v8::Local holder = toV8(holderImpl, scriptState->context()->Global(), scriptState->isolate()); if (holder.IsEmpty()) return false; {% for argument in method.arguments %} v8::Local {{argument.handle}} = {{argument.private_script_cpp_value_to_v8_value}}; {% endfor %} {% if method.arguments %} v8::Local argv[] = { {{method.arguments | join(', ', 'handle')}} }; {% else %} {# Empty array initializers are illegal, and don\t compile in MSVC. #} v8::Local *argv = 0; {% endif %} ExceptionState exceptionState(ExceptionState::ExecutionContext, "{{method.name}}", "{{cpp_class}}", scriptState->context()->Global(), scriptState->isolate()); v8::Local v8Value = PrivateScriptRunner::runDOMMethod(scriptState, scriptStateInUserScript, "{{cpp_class}}", "{{method.name}}", holder, {{method.arguments | length}}, argv); if (v8Value.IsEmpty()) return false; {% if method.idl_type != 'void' %} {{v8_value_to_local_cpp_value(method.private_script_v8_value_to_local_cpp_value) | indent}} *result = cppValue; {% endif %} RELEASE_ASSERT(!exceptionState.hadException()); return true; } {% endmacro %} {##############################################################################} {% macro generate_constructor(constructor) %} {% set name = '%sConstructorCallback' % v8_class if constructor.is_named_constructor else 'constructor%s' % (constructor.overload_index or '') %} static void {{name}}(const v8::FunctionCallbackInfo& info) { {% if constructor.is_named_constructor %} if (!info.IsConstructCall()) { V8ThrowException::throwTypeError(info.GetIsolate(), ExceptionMessages::constructorNotCallableAsFunction("{{constructor.name}}")); return; } if (ConstructorMode::current(info.GetIsolate()) == ConstructorMode::WrapExistingObject) { v8SetReturnValue(info, info.Holder()); return; } {% endif %} {% if constructor.has_exception_state %} ExceptionState exceptionState(ExceptionState::ConstructionContext, "{{interface_name}}", info.Holder(), info.GetIsolate()); {% endif %} {# Overloaded constructors have length checked during overload resolution #} {% if constructor.number_of_required_arguments and not constructor.overload_index %} if (UNLIKELY(info.Length() < {{constructor.number_of_required_arguments}})) { {{throw_minimum_arity_type_error(constructor, constructor.number_of_required_arguments) | indent(8)}} } {% endif %} {% if constructor.arguments %} {{generate_arguments(constructor) | indent}} {% endif %} {{cpp_method_call(constructor, constructor.v8_set_return_value, constructor.cpp_value) | indent}} } {% endmacro %} {##############################################################################} {% macro generate_constructor_wrapper(constructor) %} {% set constructor_class = v8_class + ('Constructor' if constructor.is_named_constructor else '') %} v8::Local wrapper = info.Holder(); wrapper = impl->associateWithWrapper(info.GetIsolate(), &{{constructor_class}}::wrapperTypeInfo, wrapper); v8SetReturnValue(info, wrapper); {% endmacro %} {##############################################################################} {% macro method_configuration(method) %} {% from 'utilities.cpp' import property_location %} {% set method_callback = '%sV8Internal::%sMethodCallback' % (cpp_class_or_partial, method.name) %} {% set method_callback_for_main_world = '%sV8Internal::%sMethodCallbackForMainWorld' % (cpp_class_or_partial, method.name) if method.is_per_world_bindings else '0' %} {% set property_attribute = 'static_cast(%s)' % ' | '.join(method.property_attributes) if method.property_attributes else 'v8::None' %} {% set only_exposed_to_private_script = 'V8DOMConfiguration::OnlyExposedToPrivateScript' if method.only_exposed_to_private_script else 'V8DOMConfiguration::ExposedToAllScripts' %} {"{{method.name}}", {{method_callback}}, {{method_callback_for_main_world}}, {{method.length}}, {{property_attribute}}, {{only_exposed_to_private_script}}, {{property_location(method)}}} {%- endmacro %} {######################################} {% macro install_custom_signature(method, instance_template, prototype_template, interface_template, signature) %} const V8DOMConfiguration::MethodConfiguration {{method.name}}MethodConfiguration = {{method_configuration(method)}}; V8DOMConfiguration::installMethod(isolate, {{instance_template}}, {{prototype_template}}, {{interface_template}}, {{signature}}, {{method.name}}MethodConfiguration); {%- endmacro %} {######################################} {% macro install_conditionally_enabled_methods() %} {% if conditionally_enabled_methods %} {# Define operations with limited exposure #} v8::Local defaultSignature = v8::Signature::New(isolate, domTemplate(isolate)); ExecutionContext* executionContext = toExecutionContext(prototypeObject->CreationContext()); ASSERT(executionContext); {% for method in conditionally_enabled_methods %} {% filter exposed(method.overloads.exposed_test_all if method.overloads else method.exposed_test) %} {% filter runtime_enabled(method.overloads.runtime_enabled_function_all if method.overloads else method.runtime_enabled_function) %} const V8DOMConfiguration::MethodConfiguration {{method.name}}MethodConfiguration = {{method_configuration(method)}}; V8DOMConfiguration::installMethod(isolate, v8::Local(), prototypeObject, interfaceObject, defaultSignature, {{method.name}}MethodConfiguration); {% endfilter %}{# runtime_enabled() #} {% endfilter %}{# exposed() #} {% endfor %} {% endif %} {%- endmacro %}