/* * Copyright (c) 2020, Andreas Kling * Copyright (c) 2020-2021, Linus Groh * * SPDX-License-Identifier: BSD-2-Clause */ #pragma once #include #include #include #include #include #include #include #include #include #include #include namespace JS { #define JS_OBJECT(class_, base_class) \ public: \ using Base = base_class; \ virtual const char* class_name() const override { return #class_; } class Object : public Cell { public: static Object* create(GlobalObject&, Object* prototype); explicit Object(Object& prototype); explicit Object(Shape&); virtual void initialize(GlobalObject&) override; virtual ~Object(); enum class PropertyKind { Key, Value, KeyAndValue, }; enum class IntegrityLevel { Sealed, Frozen, }; enum class ShouldThrowExceptions { No, Yes, }; // Please DO NOT make up your own non-standard methods unless you // have a very good reason to do so. If any object abstract // operation from the spec is missing, add it instead. // Functionality for implementation details like shapes and // property storage are obviously exempt from this rule :^) // // Methods named [[Foo]]() in the spec are named internal_foo() // here, as they are "The [[Foo]] internal method of a ... object". // They must be virtual and may be overridden. All other methods // follow the the regular PascalCase name converted to camel_case // naming convention and must not be virtual. // 7.1 Type Conversion, https://tc39.es/ecma262/#sec-type-conversion Value ordinary_to_primitive(Value::PreferredType preferred_type) const; // 7.2 Testing and Comparison Operations, https://tc39.es/ecma262/#sec-testing-and-comparison-operations bool is_extensible() const; // 7.3 Operations on Objects, https://tc39.es/ecma262/#sec-operations-on-objects Value get(PropertyName const&) const; bool set(PropertyName const&, Value, ShouldThrowExceptions); bool create_data_property(PropertyName const&, Value); bool create_method_property(PropertyName const&, Value); bool create_data_property_or_throw(PropertyName const&, Value); bool create_non_enumerable_data_property_or_throw(PropertyName const&, Value); bool define_property_or_throw(PropertyName const&, PropertyDescriptor const&); bool delete_property_or_throw(PropertyName const&); bool has_property(PropertyName const&) const; bool has_own_property(PropertyName const&) const; bool set_integrity_level(IntegrityLevel); bool test_integrity_level(IntegrityLevel) const; MarkedValueList enumerable_own_property_names(PropertyKind kind) const; // 10.1 Ordinary Object Internal Methods and Internal Slots, https://tc39.es/ecma262/#sec-ordinary-object-internal-methods-and-internal-slots virtual Object* internal_get_prototype_of() const; virtual bool internal_set_prototype_of(Object* prototype); virtual bool internal_is_extensible() const; virtual bool internal_prevent_extensions(); virtual Optional internal_get_own_property(PropertyName const&) const; virtual bool internal_define_own_property(PropertyName const&, PropertyDescriptor const&); virtual bool internal_has_property(PropertyName const&) const; virtual Value internal_get(PropertyName const&, Value receiver) const; virtual bool internal_set(PropertyName const&, Value value, Value receiver); virtual bool internal_delete(PropertyName const&); virtual MarkedValueList internal_own_property_keys() const; // 10.4.7 Immutable Prototype Exotic Objects, https://tc39.es/ecma262/#sec-immutable-prototype-exotic-objects bool set_immutable_prototype(Object* prototype); // 20.1 Object Objects, https://tc39.es/ecma262/#sec-object-objects Object* define_properties(Value properties); // Implementation-specific storage abstractions Optional storage_get(PropertyName const&) const; bool storage_has(PropertyName const&) const; void storage_set(PropertyName const&, ValueAndAttributes const&); void storage_delete(PropertyName const&); // Non-standard methods Value get_without_side_effects(const PropertyName&) const; void define_direct_property(PropertyName const& property_name, Value value, PropertyAttributes attributes) { storage_set(property_name, { value, attributes }); }; void define_direct_accessor(PropertyName const&, FunctionObject* getter, FunctionObject* setter, PropertyAttributes attributes); void define_native_function(PropertyName const&, Function, i32 length, PropertyAttributes attributes); void define_native_accessor(PropertyName const&, Function getter, Function setter, PropertyAttributes attributes); virtual bool is_function() const { return false; } virtual bool is_typed_array() const { return false; } virtual bool is_string_object() const { return false; } virtual bool is_global_object() const { return false; } virtual bool is_proxy_object() const { return false; } virtual bool is_native_function() const { return false; } virtual bool is_ordinary_function_object() const { return false; } // B.3.7 The [[IsHTMLDDA]] Internal Slot, https://tc39.es/ecma262/#sec-IsHTMLDDA-internal-slot virtual bool is_htmldda() const { return false; } bool has_parameter_map() const { return m_has_parameter_map; } void set_has_parameter_map() { m_has_parameter_map = true; } virtual const char* class_name() const override { return "Object"; } virtual void visit_edges(Cell::Visitor&) override; virtual Value value_of() const { return Value(const_cast(this)); } Value get_direct(size_t index) const { return m_storage[index]; } const IndexedProperties& indexed_properties() const { return m_indexed_properties; } IndexedProperties& indexed_properties() { return m_indexed_properties; } void set_indexed_property_elements(Vector&& values) { m_indexed_properties = IndexedProperties(move(values)); } Shape& shape() { return *m_shape; } Shape const& shape() const { return *m_shape; } GlobalObject& global_object() const { return *shape().global_object(); } void ensure_shape_is_unique(); void enable_transitions() { m_transitions_enabled = true; } void disable_transitions() { m_transitions_enabled = false; } template bool fast_is() const = delete; protected: enum class GlobalObjectTag { Tag }; enum class ConstructWithoutPrototypeTag { Tag }; explicit Object(GlobalObjectTag); Object(ConstructWithoutPrototypeTag, GlobalObject&); // [[Extensible]] bool m_is_extensible { true }; // [[ParameterMap]] bool m_has_parameter_map { false }; private: void set_shape(Shape&); Object* prototype() { return shape().prototype(); } Object const* prototype() const { return shape().prototype(); } bool m_transitions_enabled { true }; Shape* m_shape { nullptr }; Vector m_storage; IndexedProperties m_indexed_properties; }; }