/* * 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_JSARRAY_H #define ECMASCRIPT_JSARRAY_H #include "ecmascript/js_object.h" #include "ecmascript/js_tagged_value-inl.h" #include "ecmascript/js_tagged_value.h" #include "ecmascript/js_thread.h" #include "ecmascript/tagged_array.h" namespace panda::ecmascript { enum class ArrayMode : uint8_t { UNDEFINED = 0, DICTIONARY, LITERAL }; // ecma6 9.4.2 Array Exotic Object class JSArray : public JSObject { public: static constexpr int LENGTH_INLINE_PROPERTY_INDEX = 0; CAST_CHECK(JSArray, IsJSArray); static PUBLIC_API JSHandle ArrayCreate(JSThread *thread, JSTaggedNumber length, ArrayMode mode = ArrayMode::UNDEFINED); static JSHandle ArrayCreate(JSThread *thread, JSTaggedNumber length, const JSHandle &newTarget, ArrayMode mode = ArrayMode::UNDEFINED); static JSTaggedValue ArraySpeciesCreate(JSThread *thread, const JSHandle &originalArray, JSTaggedNumber length); static bool ArraySetLength(JSThread *thread, const JSHandle &array, const PropertyDescriptor &desc); static bool DefineOwnProperty(JSThread *thread, const JSHandle &array, const JSHandle &key, const PropertyDescriptor &desc); static bool DefineOwnProperty(JSThread *thread, const JSHandle &array, uint32_t index, const PropertyDescriptor &desc); static bool IsLengthString(JSThread *thread, const JSHandle &key); // ecma6 7.3 Operations on Objects static JSHandle CreateArrayFromList(JSThread *thread, const JSHandle &elements); static JSHandle CreateArrayFromList(JSThread *thread, const JSHandle &newtarget, const JSHandle &elements); // use first inlined property slot for array length inline uint32_t GetArrayLength() const { return GetLength(); } inline void SetArrayLength([[maybe_unused]]const JSThread *thread, uint32_t length) { SetLength(length); } inline uint32_t GetHintLength() const { auto trackInfo = GetTrackInfo(); if (trackInfo.IsInt()) { int hint = trackInfo.GetInt(); return hint > 0 ? hint : 0; } return 0; } static constexpr size_t LENGTH_OFFSET = JSObject::SIZE; ACCESSORS_PRIMITIVE_FIELD(Length, uint32_t, LENGTH_OFFSET, TRACE_INDEX_OFFSET) ACCESSORS_PRIMITIVE_FIELD(TraceIndex, uint32_t, TRACE_INDEX_OFFSET, TRACK_INFO_OFFSET) ACCESSORS(TrackInfo, TRACK_INFO_OFFSET, SIZE) DECL_VISIT_OBJECT_FOR_JS_OBJECT(JSObject, TRACK_INFO_OFFSET, SIZE) static const uint32_t MAX_ARRAY_INDEX = MAX_ELEMENT_INDEX; DECL_DUMP() static int32_t GetArrayLengthOffset() { return LENGTH_OFFSET; } static bool PropertyKeyToArrayIndex(JSThread *thread, const JSHandle &key, uint32_t *output); static JSTaggedValue LengthGetter(JSThread *thread, const JSHandle &self); static bool LengthSetter(JSThread *thread, const JSHandle &self, const JSHandle &value, bool mayThrow = false); static JSHandle FastGetPropertyByValue(JSThread *thread, const JSHandle &obj, uint32_t index); static JSHandle FastGetPropertyByValue(JSThread *thread, const JSHandle &obj, const JSHandle &key); static bool FastSetPropertyByValue(JSThread *thread, const JSHandle &obj, uint32_t index, const JSHandle &value); static bool FastSetPropertyByValue(JSThread *thread, const JSHandle &obj, const JSHandle &key, const JSHandle &value); static bool TryFastCreateDataProperty(JSThread *thread, const JSHandle &obj, uint32_t index, const JSHandle &value, SCheckMode sCheckMode = SCheckMode::CHECK); static JSTaggedValue Sort(JSThread *thread, const JSHandle &obj, const JSHandle &fn); static bool IncludeInSortedValue(JSThread *thread, const JSHandle &obj, const JSHandle &value); static JSHandle ToTaggedArray(JSThread *thread, const JSHandle &obj); static void PUBLIC_API CheckAndCopyArray(const JSThread *thread, JSHandle obj); static void SetCapacity(JSThread *thread, const JSHandle &array, uint32_t oldLen, uint32_t newLen, bool isNew = false); static void SortElements(JSThread *thread, const JSHandle &elements, const JSHandle &fn); static void SortElementsByObject(JSThread *thread, const JSHandle &thisObjHandle, const JSHandle &fn); static void SortElementsByInsertionSort(JSThread *thread, const JSHandle &elements, uint32_t len, const JSHandle &fn); static void SortElementsByMergeSort(JSThread *thread, const JSHandle &elements, const JSHandle &fn, int64_t startIdx, int64_t endIdx); static void MergeSortedElements(JSThread *thread, const JSHandle &elements, const JSHandle &fn, int64_t startIdx, int64_t middleIdx, int64_t endIdx); template static JSTaggedValue ArrayCreateWithInit(JSThread *thread, uint32_t length, const Callback &cb) { ObjectFactory *factory = thread->GetEcmaVM()->GetFactory(); JSHandle newElements(factory->NewTaggedArray(length)); RETURN_EXCEPTION_IF_ABRUPT_COMPLETION(thread); JSHandle array(JSArray::CreateArrayFromList(thread, newElements)); cb(newElements, length); return array.GetTaggedValue(); } }; class TrackInfo : public TaggedObject { public: static TrackInfo *Cast(TaggedObject *object) { ASSERT(JSTaggedValue(object).IsTrackInfoObject()); return static_cast(object); } static constexpr size_t CACHED_HCLASS_OFFSET = TaggedObjectSize(); ACCESSORS(CachedHClass, CACHED_HCLASS_OFFSET, CACHED_FUNC_OFFSET); ACCESSORS(CachedFunc, CACHED_FUNC_OFFSET, BIT_FIELD_OFFSET); ACCESSORS_BIT_FIELD(BitField, BIT_FIELD_OFFSET, ARRAY_LENGTH_OFFSET); ACCESSORS_PRIMITIVE_FIELD(ArrayLength, uint32_t, ARRAY_LENGTH_OFFSET, LAST_OFFSET) DEFINE_ALIGN_SIZE(LAST_OFFSET); // define BitField static constexpr size_t ELEMENTS_KIND_BITS = 8; static constexpr size_t SPACE_FALG_BITS = 8; FIRST_BIT_FIELD(BitField, ElementsKind, ElementsKind, ELEMENTS_KIND_BITS); NEXT_BIT_FIELD(BitField, SpaceFlag, RegionSpaceFlag, SPACE_FALG_BITS, ElementsKind); DECL_DUMP() DECL_VISIT_OBJECT(CACHED_HCLASS_OFFSET, BIT_FIELD_OFFSET); }; } // namespace panda::ecmascript #endif // ECMASCRIPT_JSARRAY_H