/* * Copyright (c) 2021-2024 Huawei Device Co., Ltd. * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef ECMASCRIPT_JS_HCLASS_INL_H #define ECMASCRIPT_JS_HCLASS_INL_H #include "ecmascript/js_hclass.h" #include "ecmascript/byte_array.h" #include "ecmascript/ic/proto_change_details.h" #include "ecmascript/js_bigint.h" #include "ecmascript/layout_info.h" #include "ecmascript/layout_info-inl.h" #include "ecmascript/mem/assert_scope.h" #include "ecmascript/transitions_dictionary.h" namespace panda::ecmascript { bool JSHClass::ProtoIsFastJSArray(const JSThread *thread, const JSHandle proto, const JSHandle hclass) { // Since we currently only support ElementsKind for JSArray initial hclass, // if an object's hclass has a non-generic ElementsKind, it must be one of the JSArray initial hclass. // if an object's hclass has a Generic ElementsKind, it might be the JSArray initial generic elementskind hclass, // which therefore needs further hclass comparison. if (proto->IsJSArray()) { JSTaggedValue genericArrayHClass = thread->GlobalConstants()->GetElementHoleTaggedClass(); if (!Elements::IsGeneric(hclass->GetElementsKind()) || hclass.GetTaggedValue() == genericArrayHClass) { return true; } } return false; } void JSHClass::AddTransitions(const JSThread *thread, const JSHandle &parent, const JSHandle &child, const JSHandle &key, PropertyAttributes attributes) { UpdateRootHClass(thread, parent, child); JSTaggedValue transitions = parent->GetTransitions(); if (transitions.IsUndefined()) { JSTaggedValue weakChild = JSTaggedValue(child.GetTaggedValue().CreateAndGetWeakRef()); parent->SetTransitions(thread, weakChild); return; } JSMutableHandle dict(thread, JSTaggedValue::Undefined()); if (transitions.IsWeak()) { auto cachedHClass = JSHClass::Cast(transitions.GetTaggedWeakRef()); if (cachedHClass->HasProps()) { uint32_t last = cachedHClass->LastPropIndex(); LayoutInfo* layoutInfo = LayoutInfo::Cast(cachedHClass->GetLayout().GetTaggedObject()); auto metaData = JSHandle(thread, JSTaggedValue(layoutInfo->GetAttr(last).GetPropertyMetaData())); auto lastKey = JSHandle(thread, layoutInfo->GetKey(last)); auto lastHClass = JSHandle(thread, cachedHClass); dict.Update(TransitionsDictionary::Create(thread)); transitions = TransitionsDictionary::PutIfAbsent(thread, dict, lastKey, lastHClass, metaData).GetTaggedValue(); } } auto metaData = JSHandle(thread, JSTaggedValue(attributes.GetPropertyMetaData())); dict.Update(transitions); transitions = TransitionsDictionary::PutIfAbsent(thread, dict, key, JSHandle(child), metaData).GetTaggedValue(); parent->SetTransitions(thread, transitions); } void JSHClass::AddExtensionTransitions(const JSThread *thread, const JSHandle &parent, const JSHandle &child, const JSHandle &key) { auto attr = JSHandle(thread, PropertyAttributes(0).GetTaggedValue()); AddProtoTransitions(thread, parent, child, key, attr); } void JSHClass::AddProtoTransitions(const JSThread *thread, const JSHandle &parent, const JSHandle &child, const JSHandle &key, const JSHandle &proto) { ALLOW_LOCAL_TO_SHARE_WEAK_REF_HANDLE; UpdateRootHClass(thread, parent, child); JSTaggedValue transitions = parent->GetTransitions(); JSMutableHandle dict(thread, JSTaggedValue::Undefined()); if (transitions.IsUndefined()) { transitions = TransitionsDictionary::Create(thread).GetTaggedValue(); } else if (transitions.IsWeak()) { auto cachedHClass = JSHClass::Cast(transitions.GetTaggedWeakRef()); if (cachedHClass->HasProps()) { uint32_t last = cachedHClass->LastPropIndex(); LayoutInfo* layoutInfo = LayoutInfo::Cast(cachedHClass->GetLayout().GetTaggedObject()); auto metaData = JSHandle(thread, JSTaggedValue(layoutInfo->GetAttr(last).GetPropertyMetaData())); auto lastKey = JSHandle(thread, layoutInfo->GetKey(last)); auto lastHClass = JSHandle(thread, cachedHClass); dict.Update(TransitionsDictionary::Create(thread)); transitions = TransitionsDictionary::PutIfAbsent(thread, dict, lastKey, lastHClass, metaData).GetTaggedValue(); } } dict.Update(transitions); transitions = TransitionsDictionary::PutIfAbsent(thread, dict, key, JSHandle(child), proto).GetTaggedValue(); parent->SetTransitions(thread, transitions); } inline JSHClass *JSHClass::FindTransitions(const JSTaggedValue &key, const JSTaggedValue &metaData, const Representation &rep) { DISALLOW_GARBAGE_COLLECTION; JSTaggedValue transitions = GetTransitions(); if (transitions.IsUndefined()) { return nullptr; } if (transitions.IsWeak()) { auto cachedHClass = JSHClass::Cast(transitions.GetTaggedWeakRef()); if (cachedHClass->PropsIsEmpty()) { return nullptr; } int last = static_cast(cachedHClass->LastPropIndex()); LayoutInfo *layoutInfo = LayoutInfo::Cast(cachedHClass->GetLayout().GetTaggedObject()); auto lastMetaData = layoutInfo->GetAttr(last).GetPropertyMetaData(); auto lastKey = layoutInfo->GetKey(last); if (lastMetaData == metaData.GetInt() && key == lastKey) { return CheckHClassForRep(cachedHClass, rep); } return nullptr; } ASSERT(transitions.IsTaggedArray()); TransitionsDictionary *dict = TransitionsDictionary::Cast(transitions.GetTaggedObject()); auto entry = dict->FindEntry(key, metaData); if (entry == -1) { return nullptr; } JSTaggedValue ret = dict->GetValue(entry); if (ret.IsUndefined()) { return nullptr; } return CheckHClassForRep(JSHClass::Cast(ret.GetTaggedWeakRef()), rep); } inline JSHClass *JSHClass::FindProtoTransitions(const JSTaggedValue &key, const JSTaggedValue &proto) { DISALLOW_GARBAGE_COLLECTION; JSTaggedValue transitions = GetTransitions(); if (transitions.IsWeak() || !transitions.IsTaggedArray()) { ASSERT(transitions.IsUndefined() || transitions.IsWeak()); return nullptr; } ASSERT(transitions.IsTaggedArray()); TransitionsDictionary *dict = TransitionsDictionary::Cast(transitions.GetTaggedObject()); auto entry = dict->FindEntry(key, proto); if (entry == -1) { return nullptr; } JSTaggedValue ret = dict->GetValue(entry); if (ret.IsUndefined()) { return nullptr; } return JSHClass::Cast(ret.GetTaggedWeakRef()); } inline void JSHClass::RestoreElementsKindToGeneric(JSHClass *newJsHClass) { newJsHClass->SetElementsKind(ElementsKind::GENERIC); } inline JSHClass *JSHClass::CheckHClassForRep(JSHClass *hclass, const Representation &rep) { if (!hclass->IsAOT()) { return hclass; } if (rep == Representation::NONE) { return hclass; } int last = static_cast(hclass->LastPropIndex()); LayoutInfo *layoutInfo = LayoutInfo::Cast(hclass->GetLayout().GetTaggedObject()); auto lastRep = layoutInfo->GetAttr(last).GetRepresentation(); auto result = hclass; if (lastRep == Representation::INT) { if (rep != Representation::INT) { result = nullptr; } } else if (lastRep == Representation::DOUBLE) { if (rep != Representation::INT && rep != Representation::DOUBLE) { result = nullptr; } } return result; } inline void JSHClass::UpdatePropertyMetaData(const JSThread *thread, [[maybe_unused]] const JSTaggedValue &key, const PropertyAttributes &metaData) { DISALLOW_GARBAGE_COLLECTION; ASSERT(!GetLayout().IsNull()); LayoutInfo *layoutInfo = LayoutInfo::Cast(GetLayout().GetTaggedObject()); ASSERT(layoutInfo->GetLength() != 0); uint32_t entry = metaData.GetOffset(); layoutInfo->SetNormalAttr(thread, entry, metaData); } inline bool JSHClass::HasReferenceField() { auto type = GetObjectType(); switch (type) { case JSType::LINE_STRING: case JSType::CONSTANT_STRING: case JSType::JS_NATIVE_POINTER: return false; default: return true; } } inline size_t JSHClass::SizeFromJSHClass(TaggedObject *header) { // CAUTION! Never use T::Cast(header) in this function // it would cause issue during GC because hclass may forward to a new addres // and the casting method would still use the old address. auto type = GetObjectType(); size_t size = 0; switch (type) { case JSType::TAGGED_ARRAY: case JSType::TAGGED_DICTIONARY: case JSType::LEXICAL_ENV: case JSType::SENDABLE_ENV: case JSType::CONSTANT_POOL: case JSType::AOT_LITERAL_INFO: case JSType::VTABLE: case JSType::COW_TAGGED_ARRAY: case JSType::MUTANT_TAGGED_ARRAY: case JSType::COW_MUTANT_TAGGED_ARRAY: case JSType::PROFILE_TYPE_INFO: size = TaggedArray::ComputeSize(JSTaggedValue::TaggedTypeSize(), reinterpret_cast(header)->GetLength()); break; case JSType::BYTE_ARRAY: size = ByteArray::ComputeSize(reinterpret_cast(header)->GetByteLength(), reinterpret_cast(header)->GetArrayLength()); size = AlignUp(size, static_cast(MemAlignment::MEM_ALIGN_OBJECT)); break; case JSType::LINE_STRING: size = LineEcmaString::ObjectSize(reinterpret_cast(header)); size = AlignUp(size, static_cast(MemAlignment::MEM_ALIGN_OBJECT)); break; case JSType::CONSTANT_STRING: size = ConstantString::SIZE; size = AlignUp(size, static_cast(MemAlignment::MEM_ALIGN_OBJECT)); break; case JSType::TREE_STRING: size = TreeEcmaString::SIZE; size = AlignUp(size, static_cast(MemAlignment::MEM_ALIGN_OBJECT)); break; case JSType::SLICED_STRING: size = SlicedString::SIZE; size = AlignUp(size, static_cast(MemAlignment::MEM_ALIGN_OBJECT)); break; case JSType::MACHINE_CODE_OBJECT: size = reinterpret_cast(header)->GetMachineCodeObjectSize(); size = AlignUp(size, static_cast(MemAlignment::MEM_ALIGN_OBJECT)); break; case JSType::BIGINT: size = BigInt::ComputeSize(reinterpret_cast(header)->GetLength()); size = AlignUp(size, static_cast(MemAlignment::MEM_ALIGN_OBJECT)); break; default: ASSERT(GetObjectSize() != 0); size = GetObjectSize(); break; } ASSERT(AlignUp(size, static_cast(MemAlignment::MEM_ALIGN_OBJECT)) == size); return size; } inline void JSHClass::Copy(const JSThread *thread, const JSHClass *jshclass) { DISALLOW_GARBAGE_COLLECTION; // copy jshclass SetPrototype(thread, jshclass->GetPrototype()); SetBitField(jshclass->GetBitField()); SetIsAllTaggedProp(jshclass->IsAllTaggedProp()); SetNumberOfProps(jshclass->NumberOfProps()); } inline JSHClass *JSHClass::FindRootHClass(JSHClass *hclass) { auto root = hclass; while (!ProfileType(root->GetProfileType()).IsRootType()) { auto parent = root->GetParent(); if (!parent.IsJSHClass()) { break; } root = JSHClass::Cast(parent.GetTaggedObject()); } return root; } inline JSTaggedValue JSHClass::FindProtoHClass(JSHClass *hclass) { auto proto = hclass->GetProto(); if (proto.IsJSObject()) { auto prototypeObj = JSObject::Cast(proto); return JSTaggedValue(prototypeObj->GetClass()); } return JSTaggedValue::Undefined(); } inline JSTaggedValue JSHClass::FindProtoRootHClass(JSHClass *hclass) { auto proto = hclass->GetProto(); if (proto.IsJSObject()) { auto prototypeObj = JSObject::Cast(proto); auto prototypeHClass = prototypeObj->GetClass(); return JSTaggedValue(JSHClass::FindRootHClass(prototypeHClass)); } return JSTaggedValue::Undefined(); } inline void JSHClass::UpdateRootHClass(const JSThread *thread, const JSHandle &parent, const JSHandle &child) { if (thread->GetEcmaVM()->IsEnablePGOProfiler()) { child->SetParent(thread, parent); } } inline int JSHClass::FindPropertyEntry(const JSThread *thread, JSHClass *hclass, JSTaggedValue key) { DISALLOW_GARBAGE_COLLECTION; LayoutInfo *layout = LayoutInfo::Cast(hclass->GetLayout().GetTaggedObject()); uint32_t propsNumber = hclass->NumberOfProps(); int entry = layout->FindElementWithCache(thread, hclass, key, propsNumber); return entry; } inline void JSHClass::CompleteObjSizeTracking() { if (!IsObjSizeTrackingInProgress()) { return; } uint32_t finalInObjPropsNum = JSHClass::VisitTransitionAndFindMaxNumOfProps(this); if (finalInObjPropsNum < GetInlinedProperties()) { // UpdateObjSize with finalInObjPropsNum JSHClass::VisitTransitionAndUpdateObjSize(this, finalInObjPropsNum); } SetConstructionCounter(0); // fini ObjSizeTracking } inline void JSHClass::ObjSizeTrackingStep() { if (!IsObjSizeTrackingInProgress()) { return; } uint32_t constructionCounter = GetConstructionCounter(); ASSERT(constructionCounter != 0); SetConstructionCounter(--constructionCounter); if (constructionCounter == 0) { uint32_t finalInObjPropsNum = JSHClass::VisitTransitionAndFindMaxNumOfProps(this); if (finalInObjPropsNum < GetInlinedProperties()) { // UpdateObjSize with finalInObjPropsNum JSHClass::VisitTransitionAndUpdateObjSize(this, finalInObjPropsNum); } } } template void JSHClass::MarkProtoChanged([[maybe_unused]] const JSThread *thread, const JSHandle &jshclass) { DISALLOW_GARBAGE_COLLECTION; ASSERT(jshclass->IsPrototype()); JSTaggedValue markerValue = jshclass->GetProtoChangeMarker(); if (markerValue.IsProtoChangeMarker()) { ProtoChangeMarker *protoChangeMarker = ProtoChangeMarker::Cast(markerValue.GetTaggedObject()); if constexpr (isOnlyIncludeNotFound) { protoChangeMarker->SetNotFoundHasChanged(true); } else { protoChangeMarker->SetHasChanged(true); } } } template void JSHClass::NoticeThroughChain(const JSThread *thread, const JSHandle &jshclass, JSTaggedValue addedKey) { DISALLOW_GARBAGE_COLLECTION; MarkProtoChanged(thread, jshclass); JSTaggedValue protoDetailsValue = jshclass->GetProtoChangeDetails(); if (!protoDetailsValue.IsProtoChangeDetails()) { return; } JSTaggedValue listenersValue = ProtoChangeDetails::Cast(protoDetailsValue.GetTaggedObject())->GetChangeListener(); if (!listenersValue.IsTaggedArray()) { return; } ChangeListener *listeners = ChangeListener::Cast(listenersValue.GetTaggedObject()); for (uint32_t i = 0; i < listeners->GetEnd(); i++) { JSTaggedValue temp = listeners->Get(i); if (temp.IsJSHClass()) { NoticeThroughChain(thread, JSHandle(thread, listeners->Get(i).GetTaggedObject()), addedKey); } } } template void JSHClass::AddPropertyToNewHClass(const JSThread *thread, JSHandle &jshclass, JSHandle &newJsHClass, const JSHandle &key, const PropertyAttributes &attr) { ASSERT(!jshclass->IsDictionaryMode()); ASSERT(!newJsHClass->IsDictionaryMode()); ObjectFactory *factory = thread->GetEcmaVM()->GetFactory(); // Add Property and metaData uint32_t offset = attr.GetOffset(); newJsHClass->IncNumberOfProps(); { JSMutableHandle layoutInfoHandle(thread, newJsHClass->GetLayout()); if (layoutInfoHandle->NumberOfElements() != static_cast(offset)) { layoutInfoHandle.Update(factory->CopyAndReSort(layoutInfoHandle, offset, offset + 1)); } else if (layoutInfoHandle->GetPropertiesCapacity() <= static_cast(offset)) { // need to Grow layoutInfoHandle.Update( factory->ExtendLayoutInfo(layoutInfoHandle, offset)); } newJsHClass->SetLayout(thread, layoutInfoHandle); layoutInfoHandle->AddKey(thread, offset, key.GetTaggedValue(), attr); } // Add newClass to old hclass's transitions. AddTransitions(thread, jshclass, newJsHClass, key, attr); if UNLIKELY(key.GetTaggedValue() == thread->GlobalConstants()->GetConstructorString() && (jshclass->IsJSArray() || jshclass->IsTypedArray())) { newJsHClass->SetHasConstructor(true); } } template JSHandle JSHClass::SetPropertyOfObjHClass(const JSThread *thread, JSHandle &jshclass, const JSHandle &key, const PropertyAttributes &attr, const Representation &rep, bool withInlinedProperties, uint32_t numInlinedProps) { JSHClass *newClass = jshclass->FindTransitions( key.GetTaggedValue(), JSTaggedValue(attr.GetPropertyMetaData()), rep); if (newClass != nullptr) { newClass->SetPrototype(thread, jshclass->GetPrototype()); return JSHandle(thread, newClass); } JSHandle newJsHClass = JSHClass::Clone(thread, jshclass, withInlinedProperties, numInlinedProps); AddPropertyToNewHClass(thread, jshclass, newJsHClass, key, attr); return newJsHClass; } } // namespace panda::ecmascript #endif // ECMASCRIPT_JS_HCLASS_INL_H