ladybird/Userland/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);

public:
    static ThrowCompletionOr<ECMAScriptFunctionObject*> create_dynamic_function(VM&, FunctionObject& constructor, FunctionObject* new_target, FunctionKind kind, MarkedVector<Value> const& args);

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

    virtual ThrowCompletionOr<Value> call() override;
    virtual ThrowCompletionOr<NonnullGCPtr<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 14:34:31 +01:00			`/*`
LibJS: Replace GlobalObject with VM in remaining AOs [Part 19/19] 2022-08-21 20:38:35 +01:00			`* Copyright (c) 2020-2022, Linus Groh <linusg@serenityos.org>`
LibJS: Add Function() and Function.prototype 2020-04-04 14:34:31 +01: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 01:24:48 -07:00			`* SPDX-License-Identifier: BSD-2-Clause`
LibJS: Add Function() and Function.prototype 2020-04-04 14:34:31 +01: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 17:26:06 +01:00			`#include <LibJS/Runtime/FunctionKind.h>`
LibJS: Add Function() and Function.prototype 2020-04-04 14:34:31 +01:00			`#include <LibJS/Runtime/NativeFunction.h>`

			`namespace JS {`

			`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 15:14:02 +02:00			`JS_OBJECT(FunctionConstructor, NativeFunction);`

LibJS: Add Function() and Function.prototype 2020-04-04 14:34:31 +01:00			`public:`
LibJS: Replace GlobalObject with VM in remaining AOs [Part 19/19] 2022-08-21 20:38:35 +01:00			`static ThrowCompletionOr<ECMAScriptFunctionObject> create_dynamic_function(VM&, FunctionObject& constructor, FunctionObject new_target, FunctionKind kind, MarkedVector<Value> const& args);`
LibJS: Implement GeneratorFunctionConstructor::construct 2021-06-16 10:52:48 -07:00
LibJS: Make Cell::initialize() return void Stop worrying about tiny OOMs. Work towards #20405 2023-08-07 08:41:28 +02: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 10:25:06 -06:00			`virtual ~FunctionConstructor() override = default;`
LibJS: Add Function() and Function.prototype 2020-04-04 14:34:31 +01: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 21:16:30 +01:00			`virtual ThrowCompletionOr<Value> call() override;`
LibJS: Convert Object::construct() to NonnullGCPtr 2022-12-14 19:18:10 +00:00			`virtual ThrowCompletionOr<NonnullGCPtr<Object>> construct(FunctionObject& new_target) override;`
LibJS: Add Function() and Function.prototype 2020-04-04 14:34:31 +01: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 23:51:28 +02:00			`explicit FunctionConstructor(Realm&);`

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

			`}`