mirror of
https://github.com/LadybirdBrowser/ladybird.git
synced 2025-09-07 01:56:38 +00:00
Everywhere: Hoist the Libraries folder to the top-level
This commit is contained in:
parent
950e819ee7
commit
93712b24bf
Notes:
github-actions[bot]
2024-11-10 11:51:52 +00:00
Author: https://github.com/trflynn89
Commit: 93712b24bf
Pull-request: https://github.com/LadybirdBrowser/ladybird/pull/2256
Reviewed-by: https://github.com/sideshowbarker
4547 changed files with 104 additions and 113 deletions
271
Libraries/LibJS/Runtime/Object.h
Normal file
271
Libraries/LibJS/Runtime/Object.h
Normal file
|
@ -0,0 +1,271 @@
|
|||
/*
|
||||
* Copyright (c) 2020-2024, Andreas Kling <andreas@ladybird.org>
|
||||
* Copyright (c) 2020-2023, Linus Groh <linusg@serenityos.org>
|
||||
*
|
||||
* SPDX-License-Identifier: BSD-2-Clause
|
||||
*/
|
||||
|
||||
#pragma once
|
||||
|
||||
#include <AK/Badge.h>
|
||||
#include <AK/HashMap.h>
|
||||
#include <AK/StringView.h>
|
||||
#include <LibJS/Forward.h>
|
||||
#include <LibJS/Heap/Cell.h>
|
||||
#include <LibJS/Heap/CellAllocator.h>
|
||||
#include <LibJS/Heap/MarkedVector.h>
|
||||
#include <LibJS/Runtime/Completion.h>
|
||||
#include <LibJS/Runtime/IndexedProperties.h>
|
||||
#include <LibJS/Runtime/PrimitiveString.h>
|
||||
#include <LibJS/Runtime/PrivateEnvironment.h>
|
||||
#include <LibJS/Runtime/PropertyDescriptor.h>
|
||||
#include <LibJS/Runtime/PropertyKey.h>
|
||||
#include <LibJS/Runtime/Shape.h>
|
||||
#include <LibJS/Runtime/Value.h>
|
||||
|
||||
namespace JS {
|
||||
|
||||
#define JS_OBJECT(class_, base_class) JS_CELL(class_, base_class)
|
||||
|
||||
struct PrivateElement {
|
||||
enum class Kind {
|
||||
Field,
|
||||
Method,
|
||||
Accessor
|
||||
};
|
||||
|
||||
PrivateName key;
|
||||
Kind kind { Kind::Field };
|
||||
Value value;
|
||||
};
|
||||
|
||||
// Non-standard: This is information optionally returned by object property access functions.
|
||||
// It can be used to implement inline caches for property lookup.
|
||||
struct CacheablePropertyMetadata {
|
||||
enum class Type {
|
||||
NotCacheable,
|
||||
OwnProperty,
|
||||
InPrototypeChain,
|
||||
};
|
||||
Type type { Type::NotCacheable };
|
||||
Optional<u32> property_offset;
|
||||
GCPtr<Object const> prototype;
|
||||
};
|
||||
|
||||
class Object : public Cell {
|
||||
JS_CELL(Object, Cell);
|
||||
JS_DECLARE_ALLOCATOR(Object);
|
||||
|
||||
public:
|
||||
static NonnullGCPtr<Object> create_prototype(Realm&, Object* prototype);
|
||||
static NonnullGCPtr<Object> create(Realm&, Object* prototype);
|
||||
static NonnullGCPtr<Object> create_with_premade_shape(Shape&);
|
||||
|
||||
virtual void initialize(Realm&) override;
|
||||
virtual ~Object();
|
||||
|
||||
enum class PropertyKind {
|
||||
Key,
|
||||
Value,
|
||||
KeyAndValue,
|
||||
};
|
||||
|
||||
enum class IntegrityLevel {
|
||||
Sealed,
|
||||
Frozen,
|
||||
};
|
||||
|
||||
enum class ShouldThrowExceptions {
|
||||
No,
|
||||
Yes,
|
||||
};
|
||||
|
||||
enum class MayInterfereWithIndexedPropertyAccess {
|
||||
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 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
|
||||
|
||||
ThrowCompletionOr<Value> ordinary_to_primitive(Value::PreferredType preferred_type) const;
|
||||
|
||||
// 7.2 Testing and Comparison Operations, https://tc39.es/ecma262/#sec-testing-and-comparison-operations
|
||||
|
||||
ThrowCompletionOr<bool> is_extensible() const;
|
||||
|
||||
// 7.3 Operations on Objects, https://tc39.es/ecma262/#sec-operations-on-objects
|
||||
|
||||
ThrowCompletionOr<Value> get(PropertyKey const&) const;
|
||||
ThrowCompletionOr<void> set(PropertyKey const&, Value, ShouldThrowExceptions);
|
||||
ThrowCompletionOr<bool> create_data_property(PropertyKey const&, Value);
|
||||
void create_method_property(PropertyKey const&, Value);
|
||||
ThrowCompletionOr<bool> create_data_property_or_throw(PropertyKey const&, Value);
|
||||
void create_non_enumerable_data_property_or_throw(PropertyKey const&, Value);
|
||||
ThrowCompletionOr<void> define_property_or_throw(PropertyKey const&, PropertyDescriptor const&);
|
||||
ThrowCompletionOr<void> delete_property_or_throw(PropertyKey const&);
|
||||
ThrowCompletionOr<bool> has_property(PropertyKey const&) const;
|
||||
ThrowCompletionOr<bool> has_own_property(PropertyKey const&) const;
|
||||
ThrowCompletionOr<bool> set_integrity_level(IntegrityLevel);
|
||||
ThrowCompletionOr<bool> test_integrity_level(IntegrityLevel) const;
|
||||
ThrowCompletionOr<MarkedVector<Value>> enumerable_own_property_names(PropertyKind kind) const;
|
||||
ThrowCompletionOr<void> copy_data_properties(VM&, Value source, HashTable<PropertyKey> const& excluded_keys, HashTable<JS::Value> const& excluded_values = {});
|
||||
ThrowCompletionOr<NonnullGCPtr<Object>> snapshot_own_properties(VM&, GCPtr<Object> prototype, HashTable<PropertyKey> const& excluded_keys = {}, HashTable<Value> const& excluded_values = {});
|
||||
|
||||
PrivateElement* private_element_find(PrivateName const& name);
|
||||
ThrowCompletionOr<void> private_field_add(PrivateName const& name, Value value);
|
||||
ThrowCompletionOr<void> private_method_or_accessor_add(PrivateElement element);
|
||||
ThrowCompletionOr<Value> private_get(PrivateName const& name);
|
||||
ThrowCompletionOr<void> private_set(PrivateName const& name, Value value);
|
||||
ThrowCompletionOr<void> define_field(ClassFieldDefinition const&);
|
||||
ThrowCompletionOr<void> initialize_instance_elements(ECMAScriptFunctionObject& constructor);
|
||||
|
||||
// 10.1 Ordinary Object Internal Methods and Internal Slots, https://tc39.es/ecma262/#sec-ordinary-object-internal-methods-and-internal-slots
|
||||
|
||||
virtual ThrowCompletionOr<Object*> internal_get_prototype_of() const;
|
||||
virtual ThrowCompletionOr<bool> internal_set_prototype_of(Object* prototype);
|
||||
virtual ThrowCompletionOr<bool> internal_is_extensible() const;
|
||||
virtual ThrowCompletionOr<bool> internal_prevent_extensions();
|
||||
virtual ThrowCompletionOr<Optional<PropertyDescriptor>> internal_get_own_property(PropertyKey const&) const;
|
||||
virtual ThrowCompletionOr<bool> internal_define_own_property(PropertyKey const&, PropertyDescriptor const&, Optional<PropertyDescriptor>* precomputed_get_own_property = nullptr);
|
||||
virtual ThrowCompletionOr<bool> internal_has_property(PropertyKey const&) const;
|
||||
enum class PropertyLookupPhase {
|
||||
OwnProperty,
|
||||
PrototypeChain,
|
||||
};
|
||||
virtual ThrowCompletionOr<Value> internal_get(PropertyKey const&, Value receiver, CacheablePropertyMetadata* = nullptr, PropertyLookupPhase = PropertyLookupPhase::OwnProperty) const;
|
||||
virtual ThrowCompletionOr<bool> internal_set(PropertyKey const&, Value value, Value receiver, CacheablePropertyMetadata* = nullptr);
|
||||
virtual ThrowCompletionOr<bool> internal_delete(PropertyKey const&);
|
||||
virtual ThrowCompletionOr<MarkedVector<Value>> internal_own_property_keys() const;
|
||||
|
||||
// NOTE: Any subclass of Object that overrides property access slots ([[Get]], [[Set]] etc)
|
||||
// to customize access to indexed properties (properties where the name is a positive integer)
|
||||
// must return true for this, to opt out of optimizations that rely on assumptions that
|
||||
// might not hold when property access behaves differently.
|
||||
bool may_interfere_with_indexed_property_access() const { return m_may_interfere_with_indexed_property_access; }
|
||||
|
||||
ThrowCompletionOr<bool> ordinary_set_with_own_descriptor(PropertyKey const&, Value, Value, Optional<PropertyDescriptor>, CacheablePropertyMetadata* = nullptr);
|
||||
|
||||
// 10.4.7 Immutable Prototype Exotic Objects, https://tc39.es/ecma262/#sec-immutable-prototype-exotic-objects
|
||||
|
||||
ThrowCompletionOr<bool> set_immutable_prototype(Object* prototype);
|
||||
|
||||
// 20.1 Object Objects, https://tc39.es/ecma262/#sec-object-objects
|
||||
|
||||
ThrowCompletionOr<Object*> define_properties(Value properties);
|
||||
|
||||
// 14.7.5 The for-in, for-of, and for-await-of Statements
|
||||
|
||||
Optional<Completion> enumerate_object_properties(Function<Optional<Completion>(Value)>) const;
|
||||
|
||||
// Implementation-specific storage abstractions
|
||||
|
||||
Optional<ValueAndAttributes> storage_get(PropertyKey const&) const;
|
||||
bool storage_has(PropertyKey const&) const;
|
||||
void storage_set(PropertyKey const&, ValueAndAttributes const&);
|
||||
void storage_delete(PropertyKey const&);
|
||||
|
||||
// Non-standard methods
|
||||
|
||||
Value get_without_side_effects(PropertyKey const&) const;
|
||||
|
||||
void define_direct_property(PropertyKey const& property_key, Value value, PropertyAttributes attributes) { storage_set(property_key, { value, attributes }); }
|
||||
void define_direct_accessor(PropertyKey const&, FunctionObject* getter, FunctionObject* setter, PropertyAttributes attributes);
|
||||
|
||||
using IntrinsicAccessor = Value (*)(Realm&);
|
||||
void define_intrinsic_accessor(PropertyKey const&, PropertyAttributes attributes, IntrinsicAccessor accessor);
|
||||
|
||||
void define_native_function(Realm&, PropertyKey const&, ESCAPING Function<ThrowCompletionOr<Value>(VM&)>, i32 length, PropertyAttributes attributes, Optional<Bytecode::Builtin> builtin = {});
|
||||
void define_native_accessor(Realm&, PropertyKey const&, ESCAPING Function<ThrowCompletionOr<Value>(VM&)> getter, ESCAPING Function<ThrowCompletionOr<Value>(VM&)> setter, PropertyAttributes attributes);
|
||||
|
||||
virtual bool is_dom_node() const { return false; }
|
||||
virtual bool is_function() 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_ecmascript_function_object() const { return false; }
|
||||
virtual bool is_iterator_record() const { return false; }
|
||||
virtual bool is_array_iterator() 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 void visit_edges(Cell::Visitor&) override;
|
||||
|
||||
Value get_direct(size_t index) const { return m_storage[index]; }
|
||||
void put_direct(size_t index, Value value) { m_storage[index] = value; }
|
||||
|
||||
IndexedProperties const& indexed_properties() const { return m_indexed_properties; }
|
||||
IndexedProperties& indexed_properties() { return m_indexed_properties; }
|
||||
void set_indexed_property_elements(Vector<Value>&& values) { m_indexed_properties = IndexedProperties(move(values)); }
|
||||
|
||||
Shape& shape() { return *m_shape; }
|
||||
Shape const& shape() const { return *m_shape; }
|
||||
|
||||
void convert_to_prototype_if_needed();
|
||||
|
||||
template<typename T>
|
||||
bool fast_is() const = delete;
|
||||
|
||||
void set_prototype(Object*);
|
||||
|
||||
[[nodiscard]] bool has_magical_length_property() const { return m_has_magical_length_property; }
|
||||
|
||||
[[nodiscard]] bool is_typed_array() const { return m_is_typed_array; }
|
||||
void set_is_typed_array() { m_is_typed_array = true; }
|
||||
|
||||
Object const* prototype() const { return shape().prototype(); }
|
||||
|
||||
protected:
|
||||
enum class GlobalObjectTag { Tag };
|
||||
enum class ConstructWithoutPrototypeTag { Tag };
|
||||
enum class ConstructWithPrototypeTag { Tag };
|
||||
|
||||
Object(GlobalObjectTag, Realm&, MayInterfereWithIndexedPropertyAccess = MayInterfereWithIndexedPropertyAccess::No);
|
||||
Object(ConstructWithoutPrototypeTag, Realm&, MayInterfereWithIndexedPropertyAccess = MayInterfereWithIndexedPropertyAccess::No);
|
||||
Object(Realm&, Object* prototype, MayInterfereWithIndexedPropertyAccess = MayInterfereWithIndexedPropertyAccess::No);
|
||||
Object(ConstructWithPrototypeTag, Object& prototype, MayInterfereWithIndexedPropertyAccess = MayInterfereWithIndexedPropertyAccess::No);
|
||||
explicit Object(Shape&, MayInterfereWithIndexedPropertyAccess = MayInterfereWithIndexedPropertyAccess::No);
|
||||
|
||||
// [[Extensible]]
|
||||
bool m_is_extensible { true };
|
||||
|
||||
// [[ParameterMap]]
|
||||
bool m_has_parameter_map { false };
|
||||
|
||||
bool m_has_magical_length_property { false };
|
||||
|
||||
bool m_is_typed_array { false };
|
||||
|
||||
private:
|
||||
void set_shape(Shape& shape) { m_shape = &shape; }
|
||||
|
||||
Object* prototype() { return shape().prototype(); }
|
||||
|
||||
bool m_may_interfere_with_indexed_property_access { false };
|
||||
|
||||
// True if this object has lazily allocated intrinsic properties.
|
||||
bool m_has_intrinsic_accessors { false };
|
||||
|
||||
GCPtr<Shape> m_shape;
|
||||
Vector<Value> m_storage;
|
||||
IndexedProperties m_indexed_properties;
|
||||
OwnPtr<Vector<PrivateElement>> m_private_elements; // [[PrivateElements]]
|
||||
};
|
||||
|
||||
}
|
Loading…
Add table
Add a link
Reference in a new issue