ladybird/Userland/Libraries/LibJS/Runtime/Array.h

/*
 * Copyright (c) 2020, Andreas Kling <kling@serenityos.org>
 *
 * SPDX-License-Identifier: BSD-2-Clause
 */

#pragma once

#include <LibJS/Runtime/Object.h>

namespace JS {

class Array : public Object {
    JS_OBJECT(Array, Object);

public:
    static Array* create(GlobalObject&, size_t length = 0);
    static Array* create_from(GlobalObject&, const Vector<Value>&);

    explicit Array(Object& prototype);
    virtual void initialize(GlobalObject&) override;
    virtual ~Array() override;

    static Array* typed_this(VM&, GlobalObject&);

private:
    virtual bool is_array() const override { return true; }

    JS_DECLARE_NATIVE_GETTER(length_getter);
    JS_DECLARE_NATIVE_SETTER(length_setter);
};

}
LibJS: Parse ArrayExpression and start implementing Array objects Note that property lookup is not functional yet. 2020-03-20 20:29:57 +01:00			`/*`
			`* Copyright (c) 2020, Andreas Kling <kling@serenityos.org>`
			`*`
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: Parse ArrayExpression and start implementing Array objects Note that property lookup is not functional yet. 2020-03-20 20:29:57 +01:00			`*/`

			`#pragma once`

			`#include <LibJS/Runtime/Object.h>`

			`namespace JS {`

LibJS: Make ArrayPrototype an Array object https://tc39.es/ecma262/#sec-properties-of-the-array-prototype-object The Array prototype object: [...] is an Array exotic object and has the internal methods specified for such objects. NOTE: The Array prototype object is specified to be an Array exotic object to ensure compatibility with ECMAScript code that was created prior to the ECMAScript 2015 specification. 2021-02-24 09:48:29 +01:00			`class Array : public Object {`
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(Array, Object);`

LibJS: Parse ArrayExpression and start implementing Array objects Note that property lookup is not functional yet. 2020-03-20 20:29:57 +01:00			`public:`
LibJS: Add length parameter to Array::create() This is now a bit closer to the spec's 10.4.2.2 ArrayCreate - it will throw a RangeError if the requested length exceeds 2^32 - 1, so anyone passing in a custom value (defaults to zero for same behaviour as before) will need an exception check at the call site. 2021-06-06 23:25:33 +01:00			`static Array* create(GlobalObject&, size_t length = 0);`
LibJS: Use MarkedValueList for internal own properties getter functions Letting these create and return a JS::Array directly is pretty awkward since we then need to go through the indexed properties for iteration. Just use a MarkedValueList (i.e. Vector<Value>) for this and add a new Array::create_from() function to turn the Vector into a returnable Array as we did before. This brings it a lot closer to the spec as well, which uses the CreateArrayFromList abstract operation to do exactly this. There's an optimization opportunity for the future here, since we know the Vector's size we could prepare the newly created Array accordingly, e.g. by switching to generic storage upfront if needed. 2021-04-06 21:39:17 +02:00			`static Array* create_from(GlobalObject&, const Vector<Value>&);`
LibJS: Make Array constructor take its prototype Let's start moving towards native JS objects taking their prototype as a constructor argument. This will eventually allow us to move prototypes off of Interpreter and into GlobalObject. 2020-04-17 18:24:01 +02:00
			`explicit Array(Object& prototype);`
LibJS: Make ArrayPrototype an Array object https://tc39.es/ecma262/#sec-properties-of-the-array-prototype-object The Array prototype object: [...] is an Array exotic object and has the internal methods specified for such objects. NOTE: The Array prototype object is specified to be an Array exotic object to ensure compatibility with ECMAScript code that was created prior to the ECMAScript 2015 specification. 2021-02-24 09:48:29 +01:00			`virtual void initialize(GlobalObject&) override;`
LibJS: Parse ArrayExpression and start implementing Array objects Note that property lookup is not functional yet. 2020-03-20 20:29:57 +01:00			`virtual ~Array() override;`

LibJS: Make native function/property callbacks take VM, not Interpreter More work on decoupling the general runtime from Interpreter. The goal is becoming clearer. Interpreter should be one possible way to execute code inside a VM. In the future we might have other ways :^) 2020-09-27 18:36:49 +02:00			`static Array* typed_this(VM&, GlobalObject&);`
LibJS: More Interpreter::global_object() removal Also let's settle on calling the operation of fetching the "this" value from the Interpreter and converting it to a specific Object pointer typed_this() since consistency is nice. 2020-06-20 16:25:12 +02:00
LibJS: Parse ArrayExpression and start implementing Array objects Note that property lookup is not functional yet. 2020-03-20 20:29:57 +01:00			`private:`
			`virtual bool is_array() const override { return true; }`

LibJS: Pass GlobalObject& to native functions and property accessors More work towards supporting multiple global objects. Native C++ code now get a GlobalObject& and don't have to ask the Interpreter for it. I've added macros for declaring and defining native callbacks since this was pretty tedious and this makes it easier next time we want to change any of these signatures. 2020-06-20 13:55:34 +02:00			`JS_DECLARE_NATIVE_GETTER(length_getter);`
			`JS_DECLARE_NATIVE_SETTER(length_setter);`
LibJS: Parse ArrayExpression and start implementing Array objects Note that property lookup is not functional yet. 2020-03-20 20:29:57 +01:00			`};`

			`}`