/* * Copyright (c) 2020-2024, Andreas Kling * * SPDX-License-Identifier: BSD-2-Clause */ #pragma once #include #include #include #include #include #include #include #include #include #include namespace JS { struct PropertyMetadata { u32 offset { 0 }; PropertyAttributes attributes { 0 }; }; struct TransitionKey { StringOrSymbol property_key; PropertyAttributes attributes { 0 }; bool operator==(TransitionKey const& other) const { return property_key == other.property_key && attributes == other.attributes; } }; class PrototypeChainValidity final : public Cell , public Weakable { GC_CELL(PrototypeChainValidity, Cell); GC_DECLARE_ALLOCATOR(PrototypeChainValidity); public: [[nodiscard]] bool is_valid() const { return m_valid; } void set_valid(bool valid) { m_valid = valid; } private: bool m_valid { true }; size_t padding { 0 }; }; class Shape final : public Cell , public Weakable { GC_CELL(Shape, Cell); GC_DECLARE_ALLOCATOR(Shape); public: virtual ~Shape() override; enum class TransitionType : u8 { Invalid, Put, Configure, Prototype, Delete, CacheableDictionary, UncacheableDictionary, }; [[nodiscard]] GC::Ref create_put_transition(StringOrSymbol const&, PropertyAttributes attributes); [[nodiscard]] GC::Ref create_configure_transition(StringOrSymbol const&, PropertyAttributes attributes); [[nodiscard]] GC::Ref create_prototype_transition(Object* new_prototype); [[nodiscard]] GC::Ref create_delete_transition(StringOrSymbol const&); [[nodiscard]] GC::Ref create_cacheable_dictionary_transition(); [[nodiscard]] GC::Ref create_uncacheable_dictionary_transition(); [[nodiscard]] GC::Ref clone_for_prototype(); [[nodiscard]] static GC::Ref create_for_prototype(GC::Ref, GC::Ptr prototype); void add_property_without_transition(StringOrSymbol const&, PropertyAttributes); void add_property_without_transition(PropertyKey const&, PropertyAttributes); void remove_property_without_transition(StringOrSymbol const&, u32 offset); void set_property_attributes_without_transition(StringOrSymbol const&, PropertyAttributes); [[nodiscard]] bool is_cacheable() const { return m_cacheable; } [[nodiscard]] bool is_dictionary() const { return m_dictionary; } [[nodiscard]] bool is_cacheable_dictionary() const { return m_dictionary && m_cacheable; } [[nodiscard]] bool is_uncacheable_dictionary() const { return m_dictionary && !m_cacheable; } [[nodiscard]] bool is_prototype_shape() const { return m_is_prototype_shape; } void set_prototype_shape(); GC::Ptr prototype_chain_validity() const { return m_prototype_chain_validity; } Realm& realm() const { return m_realm; } Object* prototype() { return m_prototype; } Object const* prototype() const { return m_prototype; } Optional lookup(StringOrSymbol const&) const; OrderedHashMap const& property_table() const; u32 property_count() const { return m_property_count; } struct Property { StringOrSymbol key; PropertyMetadata value; }; void set_prototype_without_transition(Object* new_prototype); private: explicit Shape(Realm&); Shape(Shape& previous_shape, StringOrSymbol const& property_key, PropertyAttributes attributes, TransitionType); Shape(Shape& previous_shape, StringOrSymbol const& property_key, TransitionType); Shape(Shape& previous_shape, Object* new_prototype); void invalidate_prototype_if_needed_for_new_prototype(GC::Ref new_prototype_shape); void invalidate_all_prototype_chains_leading_to_this(); virtual void visit_edges(Visitor&) override; [[nodiscard]] GC::Ptr get_or_prune_cached_forward_transition(TransitionKey const&); [[nodiscard]] GC::Ptr get_or_prune_cached_prototype_transition(Object* prototype); [[nodiscard]] GC::Ptr get_or_prune_cached_delete_transition(StringOrSymbol const&); void ensure_property_table() const; GC::Ref m_realm; mutable OwnPtr> m_property_table; OwnPtr>> m_forward_transitions; OwnPtr, WeakPtr>> m_prototype_transitions; OwnPtr>> m_delete_transitions; GC::Ptr m_previous; StringOrSymbol m_property_key; GC::Ptr m_prototype; GC::Ptr m_prototype_chain_validity; u32 m_property_count { 0 }; PropertyAttributes m_attributes { 0 }; TransitionType m_transition_type { TransitionType::Invalid }; bool m_dictionary : 1 { false }; bool m_cacheable : 1 { true }; bool m_is_prototype_shape : 1 { false }; }; } template<> struct AK::Traits : public DefaultTraits { static unsigned hash(const JS::TransitionKey& key) { return pair_int_hash(key.attributes.bits(), Traits::hash(key.property_key)); } };