ladybird/Libraries/LibJS/Runtime/FunctionConstructor.h

/*
 * Copyright (c) 2020-2022, Linus Groh <linusg@serenityos.org>
 *
 * SPDX-License-Identifier: BSD-2-Clause
 */

#pragma once

#include <LibJS/Runtime/FunctionKind.h>
#include <LibJS/Runtime/NativeFunction.h>

namespace JS {

class FunctionConstructor final : public NativeFunction {
    JS_OBJECT(FunctionConstructor, NativeFunction);
    GC_DECLARE_ALLOCATOR(FunctionConstructor);

public:
    static ThrowCompletionOr<GC::Ref<ECMAScriptFunctionObject>> create_dynamic_function(VM&, FunctionObject& constructor, FunctionObject* new_target, FunctionKind kind, ReadonlySpan<Value> parameter_args, Value body_arg);

    virtual void initialize(Realm&) override;
    virtual ~FunctionConstructor() override = default;

    virtual ThrowCompletionOr<Value> call() override;
    virtual ThrowCompletionOr<GC::Ref<Object>> construct(FunctionObject& new_target) override;

private:
    explicit FunctionConstructor(Realm&);

    virtual bool has_constructor() const override { return true; }
};

}
LibJS: Add Function() and Function.prototype 2020-04-04 10:34:31 -03:00			`/*`
LibJS: Replace GlobalObject with VM in remaining AOs [Part 19/19] 2022-08-21 16:38:35 -03:00			`* Copyright (c) 2020-2022, Linus Groh <linusg@serenityos.org>`
LibJS: Add Function() and Function.prototype 2020-04-04 10:34:31 -03:00			`*`
Everything: Move to SPDX license identifiers in all files. SPDX License Identifiers are a more compact / standardized way of representing file license information. See: https://spdx.dev/resources/use/#identifiers This was done with the `ambr` search and replace tool. ambr --no-parent-ignore --key-from-file --rep-from-file key.txt rep.txt * 2021-04-22 05:24:48 -03:00			`* SPDX-License-Identifier: BSD-2-Clause`
LibJS: Add Function() and Function.prototype 2020-04-04 10:34:31 -03:00			`*/`

			`#pragma once`

LibJS: Implement create_dynamic_function() according to the spec The three major changes are: - Parsing parameters, the function body, and then the full assembled function source all separately. This is required by the spec, as function parameters and body must be valid each on their own, which cannot be guaranteed if we only ever parse the full function. - Returning an ECMAScriptFunctionObject instead of a FunctionExpression that needs to be evaluated separately. This vastly simplifies the {Async,AsyncGenerator,Generator,}Function constructor implementations. Drop '_node' from the function name accordingly. - The prototype is now determined via GetPrototypeFromConstructor and passed to OrdinaryFunctionCreate. 2022-01-15 13:26:06 -03:00			`#include <LibJS/Runtime/FunctionKind.h>`
LibJS: Add Function() and Function.prototype 2020-04-04 10:34:31 -03:00			`#include <LibJS/Runtime/NativeFunction.h>`

			`namespace JS {`

LibJS: Revert Enable EXPLICIT_SYMBOL_EXPORT This reverts commit c14173f651f5a50fdb86beb4b79487454a00f3f6. We should only annotate the minimum number of symbols that external consumers actually use, so I am starting from scratch to do that 2025-07-19 14:41:08 -03:00			`class FunctionConstructor final : public NativeFunction {`
LibJS+LibWeb: Add JS::Object::inherits(class_name) To allow implementing the DOM class hierarchy in JS bindings, this patch adds an inherits() function that can be used to ask an Object if it inherits from a specific C++ class (by name). The necessary overrides are baked into each Object subclass by the new JS_OBJECT macro, which works similarly to C_OBJECT in LibCore. Thanks to @Dexesttp for suggesting this approach. :^) 2020-06-21 10:14:02 -03:00			`JS_OBJECT(FunctionConstructor, NativeFunction);`
LibGC+Everywhere: Factor out a LibGC from LibJS Resulting in a massive rename across almost everywhere! Alongside the namespace change, we now have the following names: * JS::NonnullGCPtr -> GC::Ref * JS::GCPtr -> GC::Ptr * JS::HeapFunction -> GC::Function * JS::CellImpl -> GC::Cell * JS::Handle -> GC::Root 2024-11-14 12:01:23 -03:00			`GC_DECLARE_ALLOCATOR(FunctionConstructor);`
LibJS+LibWeb: Add JS::Object::inherits(class_name) To allow implementing the DOM class hierarchy in JS bindings, this patch adds an inherits() function that can be used to ask an Object if it inherits from a specific C++ class (by name). The necessary overrides are baked into each Object subclass by the new JS_OBJECT macro, which works similarly to C_OBJECT in LibCore. Thanks to @Dexesttp for suggesting this approach. :^) 2020-06-21 10:14:02 -03:00
LibJS: Add Function() and Function.prototype 2020-04-04 10:34:31 -03:00			`public:`
LibJS: Implement the Dynamic Code Brand Checks stage 3 proposal This is an active proposal at stage 3 of the TC39 proposal process. See: https://tc39.es/proposal-dynamic-code-brand-checks/ See: https://github.com/tc39/proposal-dynamic-code-brand-checks This proposal essentially adds support for the TrustedScript type from the Trusted Types specification to eval and Function. This in turn pipes support for the type into the CSP hook to check if the CSP allows dynamic code compilation. However, it currently doesn't support ShadowRealms, so the implementation here is a close approximation, using PerformEval as the basis. See: https://github.com/tc39/proposal-dynamic-code-brand-checks/issues/19 This is required to support the new function signature for the CSP hook, and will allow us to slot in Trusted Types support in the future. 2024-12-03 07:56:21 -03:00			`static ThrowCompletionOr<GC::Ref<ECMAScriptFunctionObject>> create_dynamic_function(VM&, FunctionObject& constructor, FunctionObject* new_target, FunctionKind kind, ReadonlySpan<Value> parameter_args, Value body_arg);`
LibJS: Implement GeneratorFunctionConstructor::construct 2021-06-16 14:52:48 -03:00
LibJS: Make Cell::initialize() return void Stop worrying about tiny OOMs. Work towards #20405 2023-08-07 03:41:28 -03:00			`virtual void initialize(Realm&) override;`
Libraries: Use default constructors/destructors in LibJS https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#cother-other-default-operation-rules "The compiler is more likely to get the default semantics right and you cannot implement these functions better than the compiler." 2022-03-14 13:25:06 -03:00			`virtual ~FunctionConstructor() override = default;`
LibJS: Add Function() and Function.prototype 2020-04-04 10:34:31 -03:00
LibJS: Convert NativeFunction::{call,construct}() to ThrowCompletionOr Both at the same time because many of them call construct() in call() and I'm not keen on adding a bunch of temporary plumbing to turn exceptions into throw completions. Also changes the return value of construct() to Object* instead of Value as it always needs to return an object; allowing an arbitrary Value is a massive foot gun. 2021-10-20 17:16:30 -03:00			`virtual ThrowCompletionOr<Value> call() override;`
LibGC+Everywhere: Factor out a LibGC from LibJS Resulting in a massive rename across almost everywhere! Alongside the namespace change, we now have the following names: * JS::NonnullGCPtr -> GC::Ref * JS::GCPtr -> GC::Ptr * JS::HeapFunction -> GC::Function * JS::CellImpl -> GC::Cell * JS::Handle -> GC::Root 2024-11-14 12:01:23 -03:00			`virtual ThrowCompletionOr<GC::Ref<Object>> construct(FunctionObject& new_target) override;`
LibJS: Add Function() and Function.prototype 2020-04-04 10:34:31 -03:00
			`private:`
LibJS: Hide all the constructors! Now that the GC allocator is able to invoke Cell subclass constructors directly via friendship, we no longer need to keep them public. :^) 2022-08-28 18:51:28 -03:00			`explicit FunctionConstructor(Realm&);`

LibJS: Add Function() and Function.prototype 2020-04-04 10:34:31 -03:00			`virtual bool has_constructor() const override { return true; }`
			`};`

			`}`