ArrayPrototype.cs 57 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637
  1. using Jint.Collections;
  2. using Jint.Native.Iterator;
  3. using Jint.Native.Map;
  4. using Jint.Native.Number;
  5. using Jint.Native.Object;
  6. using Jint.Native.Symbol;
  7. using Jint.Pooling;
  8. using Jint.Runtime;
  9. using Jint.Runtime.Descriptors;
  10. using Jint.Runtime.Descriptors.Specialized;
  11. using Jint.Runtime.Interop;
  12. namespace Jint.Native.Array
  13. {
  14. /// <summary>
  15. /// https://tc39.es/ecma262/#sec-properties-of-the-array-prototype-object
  16. /// </summary>
  17. public sealed class ArrayPrototype : ArrayInstance
  18. {
  19. private readonly Realm _realm;
  20. private readonly ArrayConstructor _constructor;
  21. internal ClrFunctionInstance? _originalIteratorFunction;
  22. internal ArrayPrototype(
  23. Engine engine,
  24. Realm realm,
  25. ArrayConstructor arrayConstructor,
  26. ObjectPrototype objectPrototype) : base(engine)
  27. {
  28. _prototype = objectPrototype;
  29. _length = new PropertyDescriptor(JsNumber.PositiveZero, PropertyFlag.Writable);
  30. _realm = realm;
  31. _constructor = arrayConstructor;
  32. }
  33. protected override void Initialize()
  34. {
  35. const PropertyFlag propertyFlags = PropertyFlag.Writable | PropertyFlag.Configurable;
  36. var properties = new PropertyDictionary(36, checkExistingKeys: false)
  37. {
  38. ["constructor"] = new PropertyDescriptor(_constructor, PropertyFlag.NonEnumerable),
  39. ["toString"] = new PropertyDescriptor(new ClrFunctionInstance(Engine, "toString", ToString, 0, PropertyFlag.Configurable), propertyFlags),
  40. ["toLocaleString"] = new PropertyDescriptor(new ClrFunctionInstance(Engine, "toLocaleString", ToLocaleString, 0, PropertyFlag.Configurable), propertyFlags),
  41. ["concat"] = new PropertyDescriptor(new ClrFunctionInstance(Engine, "concat", Concat, 1, PropertyFlag.Configurable), propertyFlags),
  42. ["copyWithin"] = new PropertyDescriptor(new ClrFunctionInstance(Engine, "copyWithin", CopyWithin, 2, PropertyFlag.Configurable), propertyFlags),
  43. ["entries"] = new PropertyDescriptor(new ClrFunctionInstance(Engine, "entries", Entries, 0, PropertyFlag.Configurable), propertyFlags),
  44. ["fill"] = new PropertyDescriptor(new ClrFunctionInstance(Engine, "fill", Fill, 1, PropertyFlag.Configurable), propertyFlags),
  45. ["join"] = new PropertyDescriptor(new ClrFunctionInstance(Engine, "join", Join, 1, PropertyFlag.Configurable), propertyFlags),
  46. ["pop"] = new PropertyDescriptor(new ClrFunctionInstance(Engine, "pop", Pop, 0, PropertyFlag.Configurable), propertyFlags),
  47. ["push"] = new PropertyDescriptor(new ClrFunctionInstance(Engine, "push", Push, 1, PropertyFlag.Configurable), propertyFlags),
  48. ["reverse"] = new PropertyDescriptor(new ClrFunctionInstance(Engine, "reverse", Reverse, 0, PropertyFlag.Configurable), propertyFlags),
  49. ["shift"] = new PropertyDescriptor(new ClrFunctionInstance(Engine, "shift", Shift, 0, PropertyFlag.Configurable), propertyFlags),
  50. ["slice"] = new PropertyDescriptor(new ClrFunctionInstance(Engine, "slice", Slice, 2, PropertyFlag.Configurable), propertyFlags),
  51. ["sort"] = new PropertyDescriptor(new ClrFunctionInstance(Engine, "sort", Sort, 1, PropertyFlag.Configurable), propertyFlags),
  52. ["splice"] = new PropertyDescriptor(new ClrFunctionInstance(Engine, "splice", Splice, 2, PropertyFlag.Configurable), propertyFlags),
  53. ["unshift"] = new PropertyDescriptor(new ClrFunctionInstance(Engine, "unshift", Unshift, 1, PropertyFlag.Configurable), propertyFlags),
  54. ["includes"] = new PropertyDescriptor(new ClrFunctionInstance(Engine, "includes", Includes, 1, PropertyFlag.Configurable), propertyFlags),
  55. ["indexOf"] = new PropertyDescriptor(new ClrFunctionInstance(Engine, "indexOf", IndexOf, 1, PropertyFlag.Configurable), propertyFlags),
  56. ["lastIndexOf"] = new PropertyDescriptor(new ClrFunctionInstance(Engine, "lastIndexOf", LastIndexOf, 1, PropertyFlag.Configurable), propertyFlags),
  57. ["every"] = new PropertyDescriptor(new ClrFunctionInstance(Engine, "every", Every, 1, PropertyFlag.Configurable), propertyFlags),
  58. ["some"] = new PropertyDescriptor(new ClrFunctionInstance(Engine, "some", Some, 1, PropertyFlag.Configurable), propertyFlags),
  59. ["forEach"] = new PropertyDescriptor(new ClrFunctionInstance(Engine, "forEach", ForEach, 1, PropertyFlag.Configurable), propertyFlags),
  60. ["map"] = new PropertyDescriptor(new ClrFunctionInstance(Engine, "map", Map, 1, PropertyFlag.Configurable), propertyFlags),
  61. ["filter"] = new PropertyDescriptor(new ClrFunctionInstance(Engine, "filter", Filter, 1, PropertyFlag.Configurable), propertyFlags),
  62. ["reduce"] = new PropertyDescriptor(new ClrFunctionInstance(Engine, "reduce", Reduce, 1, PropertyFlag.Configurable), propertyFlags),
  63. ["reduceRight"] = new PropertyDescriptor(new ClrFunctionInstance(Engine, "reduceRight", ReduceRight, 1, PropertyFlag.Configurable), propertyFlags),
  64. ["find"] = new PropertyDescriptor(new ClrFunctionInstance(Engine, "find", Find, 1, PropertyFlag.Configurable), propertyFlags),
  65. ["findIndex"] = new PropertyDescriptor(new ClrFunctionInstance(Engine, "findIndex", FindIndex, 1, PropertyFlag.Configurable), propertyFlags),
  66. ["findLast"] = new PropertyDescriptor(new ClrFunctionInstance(Engine, "findLast", FindLast, 1, PropertyFlag.Configurable), propertyFlags),
  67. ["findLastIndex"] = new PropertyDescriptor(new ClrFunctionInstance(Engine, "findLastIndex", FindLastIndex, 1, PropertyFlag.Configurable), propertyFlags),
  68. ["keys"] = new PropertyDescriptor(new ClrFunctionInstance(Engine, "keys", Keys, 0, PropertyFlag.Configurable), propertyFlags),
  69. ["values"] = new PropertyDescriptor(new ClrFunctionInstance(Engine, "values", Values, 0, PropertyFlag.Configurable), propertyFlags),
  70. ["flat"] = new PropertyDescriptor(new ClrFunctionInstance(Engine, "flat", Flat, 0, PropertyFlag.Configurable), propertyFlags),
  71. ["flatMap"] = new PropertyDescriptor(new ClrFunctionInstance(Engine, "flatMap", FlatMap, 1, PropertyFlag.Configurable), propertyFlags),
  72. ["at"] = new PropertyDescriptor(new ClrFunctionInstance(Engine, "at", At, 1, PropertyFlag.Configurable), propertyFlags),
  73. ["group"] = new PropertyDescriptor(new ClrFunctionInstance(Engine, "group", Group, 1, PropertyFlag.Configurable), propertyFlags),
  74. ["groupToMap"] = new PropertyDescriptor(new ClrFunctionInstance(Engine, "groupToMap", GroupToMap, 1, PropertyFlag.Configurable), propertyFlags),
  75. };
  76. SetProperties(properties);
  77. _originalIteratorFunction = new ClrFunctionInstance(Engine, "iterator", Values, 1);
  78. var symbols = new SymbolDictionary(2)
  79. {
  80. [GlobalSymbolRegistry.Iterator] = new PropertyDescriptor(_originalIteratorFunction, propertyFlags),
  81. [GlobalSymbolRegistry.Unscopables] = new LazyPropertyDescriptor(_engine, static state =>
  82. {
  83. var unscopables = new ObjectInstance((Engine) state!)
  84. {
  85. _prototype = null
  86. };
  87. unscopables.SetDataProperty("at", JsBoolean.True);
  88. unscopables.SetDataProperty("copyWithin", JsBoolean.True);
  89. unscopables.SetDataProperty("entries", JsBoolean.True);
  90. unscopables.SetDataProperty("fill", JsBoolean.True);
  91. unscopables.SetDataProperty("find", JsBoolean.True);
  92. unscopables.SetDataProperty("findIndex", JsBoolean.True);
  93. unscopables.SetDataProperty("findLast", JsBoolean.True);
  94. unscopables.SetDataProperty("findLastIndex", JsBoolean.True);
  95. unscopables.SetDataProperty("flat", JsBoolean.True);
  96. unscopables.SetDataProperty("flatMap", JsBoolean.True);
  97. unscopables.SetDataProperty("groupBy", JsBoolean.True);
  98. unscopables.SetDataProperty("groupByToMap", JsBoolean.True);
  99. unscopables.SetDataProperty("includes", JsBoolean.True);
  100. unscopables.SetDataProperty("keys", JsBoolean.True);
  101. unscopables.SetDataProperty("values", JsBoolean.True);
  102. unscopables.SetDataProperty("group", JsBoolean.True);
  103. unscopables.SetDataProperty("groupToMap", JsBoolean.True);
  104. return unscopables;
  105. }, PropertyFlag.Configurable)
  106. };
  107. SetSymbols(symbols);
  108. }
  109. private ObjectInstance Keys(JsValue thisObj, JsValue[] arguments)
  110. {
  111. if (thisObj is ObjectInstance oi && oi.IsArrayLike)
  112. {
  113. return _realm.Intrinsics.ArrayIteratorPrototype.Construct(oi, ArrayIteratorType.Key);
  114. }
  115. ExceptionHelper.ThrowTypeError(_realm, "cannot construct iterator");
  116. return null;
  117. }
  118. internal ObjectInstance Values(JsValue thisObj, JsValue[] arguments)
  119. {
  120. if (thisObj is ObjectInstance oi && oi.IsArrayLike)
  121. {
  122. return _realm.Intrinsics.ArrayIteratorPrototype.Construct(oi, ArrayIteratorType.Value);
  123. }
  124. ExceptionHelper.ThrowTypeError(_realm, "cannot construct iterator");
  125. return null;
  126. }
  127. private ObjectInstance Entries(JsValue thisObj, JsValue[] arguments)
  128. {
  129. if (thisObj is ObjectInstance oi && oi.IsArrayLike)
  130. {
  131. return _realm.Intrinsics.ArrayIteratorPrototype.Construct(oi, ArrayIteratorType.KeyAndValue);
  132. }
  133. ExceptionHelper.ThrowTypeError(_realm, "cannot construct iterator");
  134. return null;
  135. }
  136. /// <summary>
  137. /// https://tc39.es/ecma262/#sec-array.prototype.fill
  138. /// </summary>
  139. private JsValue Fill(JsValue thisObj, JsValue[] arguments)
  140. {
  141. var value = arguments.At(0);
  142. var start = arguments.At(1);
  143. var end = arguments.At(2);
  144. var o = TypeConverter.ToObject(_realm, thisObj);
  145. var operations = ArrayOperations.For(o);
  146. var length = operations.GetLongLength();
  147. var relativeStart = TypeConverter.ToIntegerOrInfinity(start);
  148. ulong k;
  149. if (double.IsNegativeInfinity(relativeStart))
  150. {
  151. k = 0;
  152. }
  153. else if (relativeStart < 0)
  154. {
  155. k = (ulong) System.Math.Max(length + relativeStart, 0);
  156. }
  157. else
  158. {
  159. k = (ulong) System.Math.Min(relativeStart, length);
  160. }
  161. var relativeEnd = end.IsUndefined() ? length : TypeConverter.ToIntegerOrInfinity(end);
  162. ulong final;
  163. if (double.IsNegativeInfinity(relativeEnd))
  164. {
  165. final = 0;
  166. }
  167. else if (relativeEnd < 0)
  168. {
  169. final = (ulong) System.Math.Max(length + relativeEnd, 0);
  170. }
  171. else
  172. {
  173. final = (ulong) System.Math.Min(relativeEnd, length);
  174. }
  175. for (var i = k; i < final; ++i)
  176. {
  177. operations.Set(i, value, throwOnError: false);
  178. }
  179. return o;
  180. }
  181. /// <summary>
  182. /// https://tc39.es/ecma262/#sec-array.prototype.copywithin
  183. /// </summary>
  184. private JsValue CopyWithin(JsValue thisObj, JsValue[] arguments)
  185. {
  186. var o = TypeConverter.ToObject(_realm, thisObj);
  187. JsValue target = arguments.At(0);
  188. JsValue start = arguments.At(1);
  189. JsValue end = arguments.At(2);
  190. var operations = ArrayOperations.For(o);
  191. var len = operations.GetLongLength();
  192. var relativeTarget = TypeConverter.ToIntegerOrInfinity(target);
  193. var to = relativeTarget < 0 ?
  194. System.Math.Max(len + relativeTarget, 0) :
  195. System.Math.Min(relativeTarget, len);
  196. var relativeStart = TypeConverter.ToIntegerOrInfinity(start);
  197. long from;
  198. if (double.IsNegativeInfinity(relativeStart))
  199. {
  200. from = 0;
  201. }
  202. else if (relativeStart < 0)
  203. {
  204. from = (long) System.Math.Max(len + relativeStart, 0);
  205. }
  206. else
  207. {
  208. from = (long) System.Math.Min(relativeStart, len);
  209. }
  210. var relativeEnd = end.IsUndefined() ? len : TypeConverter.ToIntegerOrInfinity(end);
  211. long final;
  212. if (double.IsNegativeInfinity(relativeEnd))
  213. {
  214. final = 0;
  215. }
  216. else if (relativeEnd < 0)
  217. {
  218. final = (long) System.Math.Max(len + relativeEnd, 0);
  219. }
  220. else
  221. {
  222. final = (long) System.Math.Min(relativeEnd, len);
  223. }
  224. var count = (long) System.Math.Min(final - from, len - to);
  225. long direction = 1;
  226. if (from < to && to < from + count)
  227. {
  228. direction = -1;
  229. from += count - 1;
  230. to += count - 1;
  231. }
  232. while (count > 0)
  233. {
  234. var fromPresent = operations.HasProperty((ulong) from);
  235. if (fromPresent)
  236. {
  237. var fromValue = operations.Get((ulong) from);
  238. operations.Set((ulong) to, fromValue, updateLength: true, throwOnError: true);
  239. }
  240. else
  241. {
  242. operations.DeletePropertyOrThrow((ulong) to);
  243. }
  244. from += direction;
  245. to += direction;
  246. count--;
  247. }
  248. return o;
  249. }
  250. /// <summary>
  251. /// https://tc39.es/ecma262/#sec-array.prototype.lastindexof
  252. /// </summary>
  253. private JsValue LastIndexOf(JsValue thisObj, JsValue[] arguments)
  254. {
  255. var o = ArrayOperations.For(_realm, thisObj);
  256. var len = o.GetLongLength();
  257. if (len == 0)
  258. {
  259. return JsNumber.IntegerNegativeOne;
  260. }
  261. var n = arguments.Length > 1
  262. ? TypeConverter.ToInteger(arguments[1])
  263. : len - 1;
  264. double k;
  265. if (n >= 0)
  266. {
  267. k = System.Math.Min(n, len - 1); // min
  268. }
  269. else
  270. {
  271. k = len - System.Math.Abs(n);
  272. }
  273. if (k < 0 || k > ArrayOperations.MaxArrayLikeLength)
  274. {
  275. return JsNumber.IntegerNegativeOne;
  276. }
  277. var searchElement = arguments.At(0);
  278. var i = (ulong) k;
  279. for (; ; i--)
  280. {
  281. var kPresent = o.HasProperty(i);
  282. if (kPresent)
  283. {
  284. var elementK = o.Get(i);
  285. if (elementK == searchElement)
  286. {
  287. return i;
  288. }
  289. }
  290. if (i == 0)
  291. {
  292. break;
  293. }
  294. }
  295. return JsNumber.IntegerNegativeOne;
  296. }
  297. /// <summary>
  298. /// https://tc39.es/ecma262/#sec-array.prototype.reduce
  299. /// </summary>
  300. private JsValue Reduce(JsValue thisObj, JsValue[] arguments)
  301. {
  302. var callbackfn = arguments.At(0);
  303. var initialValue = arguments.At(1);
  304. var o = ArrayOperations.For(_realm, thisObj);
  305. var len = o.GetLength();
  306. var callable = GetCallable(callbackfn);
  307. if (len == 0 && arguments.Length < 2)
  308. {
  309. ExceptionHelper.ThrowTypeError(_realm);
  310. }
  311. var k = 0;
  312. JsValue accumulator = Undefined;
  313. if (arguments.Length > 1)
  314. {
  315. accumulator = initialValue;
  316. }
  317. else
  318. {
  319. var kPresent = false;
  320. while (kPresent == false && k < len)
  321. {
  322. if (kPresent = o.TryGetValue((uint) k, out var temp))
  323. {
  324. accumulator = temp;
  325. }
  326. k++;
  327. }
  328. if (kPresent == false)
  329. {
  330. ExceptionHelper.ThrowTypeError(_realm);
  331. }
  332. }
  333. var args = new JsValue[4];
  334. args[3] = o.Target;
  335. while (k < len)
  336. {
  337. var i = (uint) k;
  338. if (o.TryGetValue(i, out var kvalue))
  339. {
  340. args[0] = accumulator;
  341. args[1] = kvalue;
  342. args[2] = i;
  343. accumulator = callable.Call(Undefined, args);
  344. }
  345. k++;
  346. }
  347. return accumulator;
  348. }
  349. /// <summary>
  350. /// https://tc39.es/ecma262/#sec-array.prototype.filter
  351. /// </summary>
  352. private JsValue Filter(JsValue thisObj, JsValue[] arguments)
  353. {
  354. var callbackfn = arguments.At(0);
  355. var thisArg = arguments.At(1);
  356. var o = ArrayOperations.For(_realm, thisObj);
  357. var len = o.GetLength();
  358. var callable = GetCallable(callbackfn);
  359. var a = _realm.Intrinsics.Array.ArraySpeciesCreate(TypeConverter.ToObject(_realm, thisObj), 0);
  360. var operations = ArrayOperations.For(a);
  361. uint to = 0;
  362. var args = _engine._jsValueArrayPool.RentArray(3);
  363. args[2] = o.Target;
  364. for (uint k = 0; k < len; k++)
  365. {
  366. if (o.TryGetValue(k, out var kvalue))
  367. {
  368. args[0] = kvalue;
  369. args[1] = k;
  370. var selected = callable.Call(thisArg, args);
  371. if (TypeConverter.ToBoolean(selected))
  372. {
  373. operations.CreateDataPropertyOrThrow(to, kvalue);
  374. to++;
  375. }
  376. }
  377. }
  378. operations.SetLength(to);
  379. _engine._jsValueArrayPool.ReturnArray(args);
  380. return a;
  381. }
  382. /// <summary>
  383. /// https://tc39.es/ecma262/#sec-array.prototype.map
  384. /// </summary>
  385. private JsValue Map(JsValue thisObj, JsValue[] arguments)
  386. {
  387. if (thisObj is ArrayInstance arrayInstance && !arrayInstance.HasOwnProperty(CommonProperties.Constructor))
  388. {
  389. return arrayInstance.Map(arguments);
  390. }
  391. var o = ArrayOperations.For(_realm, thisObj);
  392. var len = o.GetLongLength();
  393. if (len > ArrayOperations.MaxArrayLength)
  394. {
  395. ExceptionHelper.ThrowRangeError(_realm, "Invalid array length");;
  396. }
  397. var callbackfn = arguments.At(0);
  398. var thisArg = arguments.At(1);
  399. var callable = GetCallable(callbackfn);
  400. var a = ArrayOperations.For(_realm.Intrinsics.Array.ArraySpeciesCreate(TypeConverter.ToObject(_realm, thisObj), (uint) len));
  401. var args = _engine._jsValueArrayPool.RentArray(3);
  402. args[2] = o.Target;
  403. for (uint k = 0; k < len; k++)
  404. {
  405. if (o.TryGetValue(k, out var kvalue))
  406. {
  407. args[0] = kvalue;
  408. args[1] = k;
  409. var mappedValue = callable.Call(thisArg, args);
  410. a.CreateDataPropertyOrThrow(k, mappedValue);
  411. }
  412. }
  413. _engine._jsValueArrayPool.ReturnArray(args);
  414. return a.Target;
  415. }
  416. /// <summary>
  417. /// https://tc39.es/ecma262/#sec-array.prototype.flat
  418. /// </summary>
  419. private JsValue Flat(JsValue thisObj, JsValue[] arguments)
  420. {
  421. var O = TypeConverter.ToObject(_realm, thisObj);
  422. var operations = ArrayOperations.For(O);
  423. var sourceLen = operations.GetLength();
  424. double depthNum = 1;
  425. var depth = arguments.At(0);
  426. if (!depth.IsUndefined())
  427. {
  428. depthNum = TypeConverter.ToIntegerOrInfinity(depth);
  429. }
  430. if (depthNum < 0)
  431. {
  432. depthNum = 0;
  433. }
  434. var A = _realm.Intrinsics.Array.ArraySpeciesCreate(O, 0);
  435. FlattenIntoArray(A, O, sourceLen, 0, depthNum);
  436. return A;
  437. }
  438. /// <summary>
  439. /// https://tc39.es/ecma262/#sec-array.prototype.flatmap
  440. /// </summary>
  441. private JsValue FlatMap(JsValue thisObj, JsValue[] arguments)
  442. {
  443. var O = TypeConverter.ToObject(_realm, thisObj);
  444. var mapperFunction = arguments.At(0);
  445. var thisArg = arguments.At(1);
  446. var sourceLen = O.Length;
  447. if (!mapperFunction.IsCallable)
  448. {
  449. ExceptionHelper.ThrowTypeError(_realm, "flatMap mapper function is not callable");
  450. }
  451. var A = _realm.Intrinsics.Array.ArraySpeciesCreate(O, 0);
  452. FlattenIntoArray(A, O, sourceLen, 0, 1, (ICallable) mapperFunction, thisArg);
  453. return A;
  454. }
  455. /// <summary>
  456. /// https://tc39.es/ecma262/#sec-flattenintoarray
  457. /// </summary>
  458. private long FlattenIntoArray(
  459. ObjectInstance target,
  460. ObjectInstance source,
  461. uint sourceLen,
  462. long start,
  463. double depth,
  464. ICallable? mapperFunction = null,
  465. JsValue? thisArg = null)
  466. {
  467. var targetIndex = start;
  468. var sourceIndex = 0;
  469. var callArguments = System.Array.Empty<JsValue>();
  470. if (mapperFunction is not null)
  471. {
  472. callArguments = _engine._jsValueArrayPool.RentArray(3);
  473. callArguments[2] = source;
  474. }
  475. while (sourceIndex < sourceLen)
  476. {
  477. var P = TypeConverter.ToString(sourceIndex);
  478. var exists = source.HasProperty(P);
  479. if (exists)
  480. {
  481. var element = source.Get(P);
  482. if (mapperFunction is not null)
  483. {
  484. callArguments[0] = element;
  485. callArguments[1] = JsNumber.Create(sourceIndex);
  486. element = mapperFunction.Call(thisArg ?? Undefined, callArguments);
  487. }
  488. var shouldFlatten = false;
  489. if (depth > 0)
  490. {
  491. shouldFlatten = element.IsArray();
  492. }
  493. if (shouldFlatten)
  494. {
  495. var newDepth = double.IsPositiveInfinity(depth)
  496. ? depth
  497. : depth - 1;
  498. var objectInstance = (ObjectInstance) element;
  499. var elementLen = objectInstance.Length;
  500. targetIndex = FlattenIntoArray(target, objectInstance, elementLen, targetIndex, newDepth);
  501. }
  502. else
  503. {
  504. if (targetIndex >= NumberConstructor.MaxSafeInteger)
  505. {
  506. ExceptionHelper.ThrowTypeError(_realm);
  507. }
  508. target.CreateDataPropertyOrThrow(targetIndex, element);
  509. targetIndex += 1;
  510. }
  511. }
  512. sourceIndex++;
  513. }
  514. if (mapperFunction is not null)
  515. {
  516. _engine._jsValueArrayPool.ReturnArray(callArguments);
  517. }
  518. return targetIndex;
  519. }
  520. private JsValue ForEach(JsValue thisObj, JsValue[] arguments)
  521. {
  522. var callbackfn = arguments.At(0);
  523. var thisArg = arguments.At(1);
  524. var o = ArrayOperations.For(_realm, thisObj);
  525. var len = o.GetLength();
  526. var callable = GetCallable(callbackfn);
  527. var args = _engine._jsValueArrayPool.RentArray(3);
  528. args[2] = o.Target;
  529. for (uint k = 0; k < len; k++)
  530. {
  531. if (o.TryGetValue(k, out var kvalue))
  532. {
  533. args[0] = kvalue;
  534. args[1] = k;
  535. callable.Call(thisArg, args);
  536. }
  537. }
  538. _engine._jsValueArrayPool.ReturnArray(args);
  539. return Undefined;
  540. }
  541. /// <summary>
  542. /// https://tc39.es/ecma262/#sec-array.prototype.includes
  543. /// </summary>
  544. private JsValue Includes(JsValue thisObj, JsValue[] arguments)
  545. {
  546. var o = ArrayOperations.For(_realm, thisObj);
  547. var len = (long) o.GetLongLength();
  548. if (len == 0)
  549. {
  550. return JsBoolean.False;
  551. }
  552. var searchElement = arguments.At(0);
  553. var fromIndex = arguments.At(1);
  554. long k = 0;
  555. var n = TypeConverter.ToIntegerOrInfinity(fromIndex);
  556. if (double.IsPositiveInfinity(n))
  557. {
  558. return JsBoolean.False;
  559. }
  560. else if (double.IsNegativeInfinity(n))
  561. {
  562. n = 0;
  563. }
  564. else if (n >= 0)
  565. {
  566. k = (long) n;
  567. }
  568. else
  569. {
  570. k = len + (long) n;
  571. if (k < 0)
  572. {
  573. k = 0;
  574. }
  575. }
  576. while (k < len)
  577. {
  578. var value = o.Get((ulong) k);
  579. if (SameValueZeroComparer.Equals(value, searchElement))
  580. {
  581. return true;
  582. }
  583. k++;
  584. }
  585. return false;
  586. }
  587. private JsValue Some(JsValue thisObj, JsValue[] arguments)
  588. {
  589. var target = TypeConverter.ToObject(_realm, thisObj);
  590. return target.FindWithCallback(arguments, out _, out _, false);
  591. }
  592. private JsValue Every(JsValue thisObj, JsValue[] arguments)
  593. {
  594. var o = ArrayOperations.For(_realm, thisObj);
  595. ulong len = o.GetLongLength();
  596. if (len == 0)
  597. {
  598. return JsBoolean.True;
  599. }
  600. var callbackfn = arguments.At(0);
  601. var thisArg = arguments.At(1);
  602. var callable = GetCallable(callbackfn);
  603. var args = _engine._jsValueArrayPool.RentArray(3);
  604. args[2] = o.Target;
  605. for (uint k = 0; k < len; k++)
  606. {
  607. if (o.TryGetValue(k, out var kvalue))
  608. {
  609. args[0] = kvalue;
  610. args[1] = k;
  611. var testResult = callable.Call(thisArg, args);
  612. if (false == TypeConverter.ToBoolean(testResult))
  613. {
  614. return JsBoolean.False;
  615. }
  616. }
  617. }
  618. _engine._jsValueArrayPool.ReturnArray(args);
  619. return JsBoolean.True;
  620. }
  621. /// <summary>
  622. /// https://tc39.es/ecma262/#sec-array.prototype.indexof
  623. /// </summary>
  624. private JsValue IndexOf(JsValue thisObj, JsValue[] arguments)
  625. {
  626. var o = ArrayOperations.For(_realm, thisObj);
  627. var len = o.GetLongLength();
  628. if (len == 0)
  629. {
  630. return -1;
  631. }
  632. var startIndex = arguments.Length > 1
  633. ? TypeConverter.ToIntegerOrInfinity(arguments.At(1))
  634. : 0;
  635. if (startIndex > ArrayOperations.MaxArrayLikeLength)
  636. {
  637. return JsNumber.IntegerNegativeOne;
  638. }
  639. ulong k;
  640. if (startIndex < 0)
  641. {
  642. var abs = System.Math.Abs(startIndex);
  643. ulong temp = len - (uint) abs;
  644. if (abs > len || temp < 0)
  645. {
  646. temp = 0;
  647. }
  648. k = temp;
  649. }
  650. else
  651. {
  652. k = (ulong) startIndex;
  653. }
  654. if (k >= len)
  655. {
  656. return -1;
  657. }
  658. ulong smallestIndex = o.GetSmallestIndex(len);
  659. if (smallestIndex > k)
  660. {
  661. k = smallestIndex;
  662. }
  663. var searchElement = arguments.At(0);
  664. for (; k < len; k++)
  665. {
  666. var kPresent = o.HasProperty(k);
  667. if (kPresent)
  668. {
  669. var elementK = o.Get(k);
  670. if (elementK == searchElement)
  671. {
  672. return k;
  673. }
  674. }
  675. }
  676. return -1;
  677. }
  678. private JsValue Find(JsValue thisObj, JsValue[] arguments)
  679. {
  680. var target = TypeConverter.ToObject(_realm, thisObj);
  681. target.FindWithCallback(arguments, out _, out var value, visitUnassigned: true);
  682. return value;
  683. }
  684. private JsValue FindIndex(JsValue thisObj, JsValue[] arguments)
  685. {
  686. var target = TypeConverter.ToObject(_realm, thisObj);
  687. if (target.FindWithCallback(arguments, out var index, out _, visitUnassigned: true))
  688. {
  689. return index;
  690. }
  691. return -1;
  692. }
  693. private JsValue FindLast(JsValue thisObj, JsValue[] arguments)
  694. {
  695. var target = TypeConverter.ToObject(_realm, thisObj);
  696. target.FindWithCallback(arguments, out _, out var value, visitUnassigned: true, fromEnd: true);
  697. return value;
  698. }
  699. private JsValue FindLastIndex(JsValue thisObj, JsValue[] arguments)
  700. {
  701. var target = TypeConverter.ToObject(_realm, thisObj);
  702. if (target.FindWithCallback(arguments, out var index, out _, visitUnassigned: true, fromEnd: true))
  703. {
  704. return index;
  705. }
  706. return -1;
  707. }
  708. /// <summary>
  709. /// https://tc39.es/proposal-relative-indexing-method/#sec-array-prototype-additions
  710. /// </summary>
  711. private JsValue At(JsValue thisObj, JsValue[] arguments)
  712. {
  713. var target = TypeConverter.ToObject(_realm, thisObj);
  714. var len = target.Length;
  715. var relativeIndex = TypeConverter.ToInteger(arguments.At(0));
  716. ulong actualIndex;
  717. if (relativeIndex < 0)
  718. {
  719. actualIndex = (ulong) (len + relativeIndex);
  720. }
  721. else
  722. {
  723. actualIndex = (ulong) relativeIndex;
  724. }
  725. if (actualIndex < 0 || actualIndex >= len)
  726. {
  727. return Undefined;
  728. }
  729. return target.Get(actualIndex);
  730. }
  731. /// <summary>
  732. /// https://tc39.es/ecma262/#sec-array.prototype.splice
  733. /// </summary>
  734. private JsValue Splice(JsValue thisObj, JsValue[] arguments)
  735. {
  736. var start = arguments.At(0);
  737. var deleteCount = arguments.At(1);
  738. var obj = TypeConverter.ToObject(_realm, thisObj);
  739. var o = ArrayOperations.For(_realm, obj);
  740. var len = o.GetLongLength();
  741. var relativeStart = TypeConverter.ToInteger(start);
  742. ulong actualStart;
  743. if (relativeStart < 0)
  744. {
  745. actualStart = (ulong) System.Math.Max(len + relativeStart, 0);
  746. }
  747. else
  748. {
  749. actualStart = (ulong) System.Math.Min(relativeStart, len);
  750. }
  751. var items = System.Array.Empty<JsValue>();
  752. ulong insertCount;
  753. ulong actualDeleteCount;
  754. if (arguments.Length == 0)
  755. {
  756. insertCount = 0;
  757. actualDeleteCount = 0;
  758. }
  759. else if (arguments.Length == 1)
  760. {
  761. insertCount = 0;
  762. actualDeleteCount = len - actualStart;
  763. }
  764. else
  765. {
  766. insertCount = (ulong) (arguments.Length - 2);
  767. var dc = TypeConverter.ToInteger(deleteCount);
  768. actualDeleteCount = (ulong) System.Math.Min(System.Math.Max(dc,0), len - actualStart);
  769. items = System.Array.Empty<JsValue>();
  770. if (arguments.Length > 2)
  771. {
  772. items = new JsValue[arguments.Length - 2];
  773. System.Array.Copy(arguments, 2, items, 0, items.Length);
  774. }
  775. }
  776. if (len + insertCount - actualDeleteCount > ArrayOperations.MaxArrayLikeLength)
  777. {
  778. ExceptionHelper.ThrowTypeError(_realm, "Invalid array length");
  779. }
  780. var instance = _realm.Intrinsics.Array.ArraySpeciesCreate(obj, actualDeleteCount);
  781. var a = ArrayOperations.For(instance);
  782. for (uint k = 0; k < actualDeleteCount; k++)
  783. {
  784. var index = actualStart + k;
  785. if (o.HasProperty(index))
  786. {
  787. var fromValue = o.Get(index);
  788. a.CreateDataPropertyOrThrow(k, fromValue);
  789. }
  790. }
  791. a.SetLength((uint) actualDeleteCount);
  792. var length = len - actualDeleteCount + (uint) items.Length;
  793. o.EnsureCapacity(length);
  794. if ((ulong) items.Length < actualDeleteCount)
  795. {
  796. for (ulong k = actualStart; k < len - actualDeleteCount; k++)
  797. {
  798. var from = k + actualDeleteCount;
  799. var to = k + (ulong) items.Length;
  800. if (o.HasProperty(from))
  801. {
  802. var fromValue = o.Get(from);
  803. o.Set(to, fromValue, throwOnError: false);
  804. }
  805. else
  806. {
  807. o.DeletePropertyOrThrow(to);
  808. }
  809. }
  810. for (var k = len; k > len - actualDeleteCount + (ulong) items.Length; k--)
  811. {
  812. o.DeletePropertyOrThrow(k - 1);
  813. }
  814. }
  815. else if ((ulong) items.Length > actualDeleteCount)
  816. {
  817. for (var k = len - actualDeleteCount; k > actualStart; k--)
  818. {
  819. var from = k + actualDeleteCount - 1;
  820. var to = k + (ulong) items.Length - 1;
  821. if (o.HasProperty(from))
  822. {
  823. var fromValue = o.Get(from);
  824. o.Set(to, fromValue, throwOnError: true);
  825. }
  826. else
  827. {
  828. o.DeletePropertyOrThrow(to);
  829. }
  830. }
  831. }
  832. for (uint k = 0; k < items.Length; k++)
  833. {
  834. var e = items[k];
  835. o.Set(k + actualStart, e, throwOnError: true);
  836. }
  837. o.SetLength(length);
  838. return a.Target;
  839. }
  840. /// <summary>
  841. /// /https://tc39.es/ecma262/#sec-array.prototype.unshift
  842. /// </summary>
  843. private JsValue Unshift(JsValue thisObj, JsValue[] arguments)
  844. {
  845. var o = ArrayOperations.For(_realm, thisObj);
  846. var len = o.GetLongLength();
  847. var argCount = (uint) arguments.Length;
  848. if (len + argCount > ArrayOperations.MaxArrayLikeLength)
  849. {
  850. ExceptionHelper.ThrowTypeError(_realm, "Invalid array length");
  851. }
  852. o.EnsureCapacity(len + argCount);
  853. var minIndex = o.GetSmallestIndex(len);
  854. for (var k = len; k > minIndex; k--)
  855. {
  856. var from = k - 1;
  857. var to = k + argCount - 1;
  858. if (o.TryGetValue(from, out var fromValue))
  859. {
  860. o.Set(to, fromValue, updateLength: false);
  861. }
  862. else
  863. {
  864. o.DeletePropertyOrThrow(to);
  865. }
  866. }
  867. for (uint j = 0; j < argCount; j++)
  868. {
  869. o.Set(j, arguments[j], updateLength: false);
  870. }
  871. o.SetLength(len + argCount);
  872. return len + argCount;
  873. }
  874. /// <summary>
  875. /// https://tc39.es/ecma262/#sec-array.prototype.sort
  876. /// </summary>
  877. private JsValue Sort(JsValue thisObj, JsValue[] arguments)
  878. {
  879. var objectInstance = TypeConverter.ToObject(_realm, thisObj);
  880. var obj = ArrayOperations.For(objectInstance);
  881. var compareArg = arguments.At(0);
  882. ICallable? compareFn = null;
  883. if (!compareArg.IsUndefined())
  884. {
  885. if (compareArg is not ICallable callable)
  886. {
  887. ExceptionHelper.ThrowTypeError(_realm, "The comparison function must be either a function or undefined");
  888. return null;
  889. }
  890. compareFn = callable;
  891. }
  892. var len = obj.GetLength();
  893. if (len <= 1)
  894. {
  895. return obj.Target;
  896. }
  897. var items = new List<JsValue>((int) System.Math.Min(10_000, obj.GetLength()));
  898. for (ulong k = 0; k < len; ++k)
  899. {
  900. if (obj.TryGetValue(k, out var kValue))
  901. {
  902. items.Add(kValue);
  903. }
  904. }
  905. var itemCount = items.Count;
  906. // don't eat inner exceptions
  907. try
  908. {
  909. var array = items.OrderBy(x => x, ArrayComparer.WithFunction(_engine, compareFn!)).ToArray();
  910. uint j;
  911. for (j = 0; j < itemCount; ++j)
  912. {
  913. var updateLength = j == itemCount - 1;
  914. obj.Set(j, array[j], updateLength: updateLength, throwOnError: true);
  915. }
  916. for (; j < len; ++j)
  917. {
  918. obj.DeletePropertyOrThrow(j);
  919. }
  920. }
  921. catch (InvalidOperationException e)
  922. {
  923. throw e.InnerException ?? e;
  924. }
  925. return obj.Target;
  926. }
  927. /// <summary>
  928. /// https://tc39.es/ecma262/#sec-array.prototype.slice
  929. /// </summary>
  930. private JsValue Slice(JsValue thisObj, JsValue[] arguments)
  931. {
  932. var start = arguments.At(0);
  933. var end = arguments.At(1);
  934. var o = ArrayOperations.For(_realm, thisObj);
  935. var len = o.GetLongLength();
  936. var relativeStart = TypeConverter.ToInteger(start);
  937. ulong k;
  938. if (relativeStart < 0)
  939. {
  940. k = (ulong) System.Math.Max(len + relativeStart, 0);
  941. }
  942. else
  943. {
  944. k = (ulong) System.Math.Min(TypeConverter.ToInteger(start), len);
  945. }
  946. ulong final;
  947. if (end.IsUndefined())
  948. {
  949. final = (ulong) TypeConverter.ToNumber(len);
  950. }
  951. else
  952. {
  953. double relativeEnd = TypeConverter.ToInteger(end);
  954. if (relativeEnd < 0)
  955. {
  956. final = (ulong) System.Math.Max(len + relativeEnd, 0);
  957. }
  958. else
  959. {
  960. final = (ulong) System.Math.Min(relativeEnd, len);
  961. }
  962. }
  963. if (k < final && final - k > ArrayOperations.MaxArrayLength)
  964. {
  965. ExceptionHelper.ThrowRangeError(_realm, "Invalid array length");;
  966. }
  967. var length = (uint) System.Math.Max(0, (long) final - (long) k);
  968. var a = _realm.Intrinsics.Array.ArraySpeciesCreate(TypeConverter.ToObject(_realm, thisObj), length);
  969. if (thisObj is ArrayInstance ai && a is ArrayInstance a2)
  970. {
  971. a2.CopyValues(ai, (uint) k, 0, length);
  972. }
  973. else
  974. {
  975. // slower path
  976. var operations = ArrayOperations.For(a);
  977. for (uint n = 0; k < final; k++, n++)
  978. {
  979. if (o.TryGetValue(k, out var kValue))
  980. {
  981. operations.CreateDataPropertyOrThrow(n, kValue);
  982. }
  983. }
  984. }
  985. a.DefineOwnProperty(CommonProperties.Length, new PropertyDescriptor(length, PropertyFlag.ConfigurableEnumerableWritable));
  986. return a;
  987. }
  988. private JsValue Shift(JsValue thisObj, JsValue[] arg2)
  989. {
  990. var o = ArrayOperations.For(_realm, thisObj);
  991. var len = o.GetLength();
  992. if (len == 0)
  993. {
  994. o.SetLength(0);
  995. return Undefined;
  996. }
  997. var first = o.Get(0);
  998. for (uint k = 1; k < len; k++)
  999. {
  1000. var to = k - 1;
  1001. if (o.TryGetValue(k, out var fromVal))
  1002. {
  1003. o.Set(to, fromVal, throwOnError: false);
  1004. }
  1005. else
  1006. {
  1007. o.DeletePropertyOrThrow(to);
  1008. }
  1009. }
  1010. o.DeletePropertyOrThrow(len - 1);
  1011. o.SetLength(len - 1);
  1012. return first;
  1013. }
  1014. /// <summary>
  1015. /// https://tc39.es/ecma262/#sec-array.prototype.reverse
  1016. /// </summary>
  1017. private JsValue Reverse(JsValue thisObj, JsValue[] arguments)
  1018. {
  1019. var o = ArrayOperations.For(_realm, thisObj);
  1020. var len = o.GetLongLength();
  1021. var middle = (ulong) System.Math.Floor(len / 2.0);
  1022. uint lower = 0;
  1023. while (lower != middle)
  1024. {
  1025. var upper = len - lower - 1;
  1026. var lowerExists = o.HasProperty(lower);
  1027. var lowerValue = lowerExists ? o.Get(lower) : null;
  1028. var upperExists = o.HasProperty(upper);
  1029. var upperValue = upperExists ? o.Get(upper) : null;
  1030. if (lowerExists && upperExists)
  1031. {
  1032. o.Set(lower, upperValue!, throwOnError: true);
  1033. o.Set(upper, lowerValue!, throwOnError: true);
  1034. }
  1035. if (!lowerExists && upperExists)
  1036. {
  1037. o.Set(lower, upperValue!, throwOnError: true);
  1038. o.DeletePropertyOrThrow(upper);
  1039. }
  1040. if (lowerExists && !upperExists)
  1041. {
  1042. o.DeletePropertyOrThrow(lower);
  1043. o.Set(upper, lowerValue!, throwOnError: true);
  1044. }
  1045. lower++;
  1046. }
  1047. return o.Target;
  1048. }
  1049. internal JsValue Join(JsValue thisObj, JsValue[] arguments)
  1050. {
  1051. var separator = arguments.At(0);
  1052. var o = ArrayOperations.For(_realm, thisObj);
  1053. var len = o.GetLength();
  1054. var sep = TypeConverter.ToString(separator.IsUndefined() ? JsString.CommaString : separator);
  1055. // as per the spec, this has to be called after ToString(separator)
  1056. if (len == 0)
  1057. {
  1058. return JsString.Empty;
  1059. }
  1060. static string StringFromJsValue(JsValue value)
  1061. {
  1062. return value.IsNullOrUndefined()
  1063. ? ""
  1064. : TypeConverter.ToString(value);
  1065. }
  1066. var s = StringFromJsValue(o.Get(0));
  1067. if (len == 1)
  1068. {
  1069. return s;
  1070. }
  1071. using var sb = StringBuilderPool.Rent();
  1072. sb.Builder.Append(s);
  1073. for (uint k = 1; k < len; k++)
  1074. {
  1075. sb.Builder.Append(sep);
  1076. sb.Builder.Append(StringFromJsValue(o.Get(k)));
  1077. }
  1078. return sb.ToString();
  1079. }
  1080. private JsValue ToLocaleString(JsValue thisObj, JsValue[] arguments)
  1081. {
  1082. var array = ArrayOperations.For(_realm, thisObj);
  1083. var len = array.GetLength();
  1084. const string separator = ",";
  1085. if (len == 0)
  1086. {
  1087. return JsString.Empty;
  1088. }
  1089. JsValue r;
  1090. if (!array.TryGetValue(0, out var firstElement) || firstElement.IsNull() || firstElement.IsUndefined())
  1091. {
  1092. r = JsString.Empty;
  1093. }
  1094. else
  1095. {
  1096. var elementObj = TypeConverter.ToObject(_realm, firstElement);
  1097. var func = elementObj.Get("toLocaleString", elementObj) as ICallable;
  1098. if (func is null)
  1099. {
  1100. ExceptionHelper.ThrowTypeError(_realm);
  1101. }
  1102. r = func.Call(elementObj, Arguments.Empty);
  1103. }
  1104. for (uint k = 1; k < len; k++)
  1105. {
  1106. string s = r + separator;
  1107. if (!array.TryGetValue(k, out var nextElement) || nextElement.IsNull())
  1108. {
  1109. r = JsString.Empty;
  1110. }
  1111. else
  1112. {
  1113. var elementObj = TypeConverter.ToObject(_realm, nextElement);
  1114. var func = elementObj.Get("toLocaleString", elementObj) as ICallable;
  1115. if (func is null)
  1116. {
  1117. ExceptionHelper.ThrowTypeError(_realm);
  1118. }
  1119. r = func.Call(elementObj, Arguments.Empty);
  1120. }
  1121. r = s + r;
  1122. }
  1123. return r;
  1124. }
  1125. /// <summary>
  1126. /// https://tc39.es/ecma262/#sec-array.prototype.concat
  1127. /// </summary>
  1128. private JsValue Concat(JsValue thisObj, JsValue[] arguments)
  1129. {
  1130. var o = TypeConverter.ToObject(_realm, thisObj);
  1131. var items = new List<JsValue>(arguments.Length + 1) {o};
  1132. items.AddRange(arguments);
  1133. uint n = 0;
  1134. var a = _realm.Intrinsics.Array.ArraySpeciesCreate(TypeConverter.ToObject(_realm, thisObj), 0);
  1135. var aOperations = ArrayOperations.For(a);
  1136. for (var i = 0; i < items.Count; i++)
  1137. {
  1138. var e = items[i];
  1139. if (e is ObjectInstance oi && oi.IsConcatSpreadable)
  1140. {
  1141. if (e is ArrayInstance eArray && a is ArrayInstance a2)
  1142. {
  1143. a2.CopyValues(eArray, 0, n, eArray.GetLength());
  1144. n += eArray.GetLength();
  1145. }
  1146. else
  1147. {
  1148. var operations = ArrayOperations.For(oi);
  1149. var len = operations.GetLongLength();
  1150. if (n + len > ArrayOperations.MaxArrayLikeLength)
  1151. {
  1152. ExceptionHelper.ThrowTypeError(_realm, "Invalid array length");
  1153. }
  1154. for (uint k = 0; k < len; k++)
  1155. {
  1156. operations.TryGetValue(k, out var subElement);
  1157. aOperations.CreateDataPropertyOrThrow(n, subElement);
  1158. n++;
  1159. }
  1160. }
  1161. }
  1162. else
  1163. {
  1164. aOperations.CreateDataPropertyOrThrow(n, e);
  1165. n++;
  1166. }
  1167. }
  1168. // this is not in the specs, but is necessary in case the last element of the last
  1169. // array doesn't exist, and thus the length would not be incremented
  1170. a.DefineOwnProperty(CommonProperties.Length, new PropertyDescriptor(n, PropertyFlag.OnlyWritable));
  1171. return a;
  1172. }
  1173. internal JsValue ToString(JsValue thisObj, JsValue[] arguments)
  1174. {
  1175. var array = TypeConverter.ToObject(_realm, thisObj);
  1176. Func<JsValue, JsValue[], JsValue> func;
  1177. if (array.Get("join") is ICallable joinFunc)
  1178. {
  1179. func = joinFunc.Call;
  1180. }
  1181. else
  1182. {
  1183. func = _realm.Intrinsics.Object.PrototypeObject.ToObjectString;
  1184. }
  1185. return func(array, Arguments.Empty);
  1186. }
  1187. /// <summary>
  1188. /// https://tc39.es/ecma262/#sec-array.prototype.reduceright
  1189. /// </summary>
  1190. private JsValue ReduceRight(JsValue thisObj, JsValue[] arguments)
  1191. {
  1192. var callbackfn = arguments.At(0);
  1193. var initialValue = arguments.At(1);
  1194. var o = ArrayOperations.For(TypeConverter.ToObject(_realm, thisObj));
  1195. var len = o.GetLongLength();
  1196. var callable = GetCallable(callbackfn);
  1197. if (len == 0 && arguments.Length < 2)
  1198. {
  1199. ExceptionHelper.ThrowTypeError(_realm);
  1200. }
  1201. long k = (long) (len - 1);
  1202. JsValue accumulator = Undefined;
  1203. if (arguments.Length > 1)
  1204. {
  1205. accumulator = initialValue;
  1206. }
  1207. else
  1208. {
  1209. var kPresent = false;
  1210. while (kPresent == false && k >= 0)
  1211. {
  1212. if ((kPresent = o.TryGetValue((ulong) k, out var temp)))
  1213. {
  1214. accumulator = temp;
  1215. }
  1216. k--;
  1217. }
  1218. if (kPresent == false)
  1219. {
  1220. ExceptionHelper.ThrowTypeError(_realm);
  1221. }
  1222. }
  1223. var jsValues = new JsValue[4];
  1224. jsValues[3] = o.Target;
  1225. for (; k >= 0; k--)
  1226. {
  1227. if (o.TryGetValue((ulong) k, out var kvalue))
  1228. {
  1229. jsValues[0] = accumulator;
  1230. jsValues[1] = kvalue;
  1231. jsValues[2] = k;
  1232. accumulator = callable.Call(Undefined, jsValues);
  1233. }
  1234. }
  1235. return accumulator;
  1236. }
  1237. /// <summary>
  1238. /// https://tc39.es/ecma262/#sec-array.prototype.push
  1239. /// </summary>
  1240. public JsValue Push(JsValue thisObject, JsValue[] arguments)
  1241. {
  1242. if (thisObject is ArrayInstance arrayInstance && arrayInstance.CanUseFastAccess)
  1243. {
  1244. return arrayInstance.Push(arguments);
  1245. }
  1246. var o = ArrayOperations.For(TypeConverter.ToObject(_realm, thisObject));
  1247. var n = o.GetLongLength();
  1248. if (n + (ulong) arguments.Length > ArrayOperations.MaxArrayLikeLength)
  1249. {
  1250. ExceptionHelper.ThrowTypeError(_realm, "Invalid array length");
  1251. }
  1252. foreach (var a in arguments)
  1253. {
  1254. o.Set(n, a, true);
  1255. n++;
  1256. }
  1257. o.SetLength(n);
  1258. return n;
  1259. }
  1260. public JsValue Pop(JsValue thisObject, JsValue[] arguments)
  1261. {
  1262. var o = ArrayOperations.For(_realm, thisObject);
  1263. ulong len = o.GetLongLength();
  1264. if (len == 0)
  1265. {
  1266. o.SetLength(0);
  1267. return Undefined;
  1268. }
  1269. len = len - 1;
  1270. JsValue element = o.Get(len);
  1271. o.DeletePropertyOrThrow(len);
  1272. o.SetLength(len);
  1273. return element;
  1274. }
  1275. /// <summary>
  1276. /// https://tc39.es/proposal-array-grouping/#sec-array.prototype.group
  1277. /// </summary>
  1278. private JsValue Group(JsValue thisObject, JsValue[] arguments)
  1279. {
  1280. var grouping = BuildArrayGrouping(thisObject, arguments, mapMode: false);
  1281. var obj = OrdinaryObjectCreate(null);
  1282. foreach (var pair in grouping)
  1283. {
  1284. obj.FastSetProperty(pair.Key, new PropertyDescriptor(pair.Value, PropertyFlag.ConfigurableEnumerableWritable));
  1285. }
  1286. return obj;
  1287. }
  1288. /// <summary>
  1289. /// https://tc39.es/proposal-array-grouping/#sec-array.prototype.grouptomap
  1290. /// </summary>
  1291. private JsValue GroupToMap(JsValue thisObject, JsValue[] arguments)
  1292. {
  1293. var grouping = BuildArrayGrouping(thisObject, arguments, mapMode: true);
  1294. var map = (MapInstance) Construct(_realm.Intrinsics.Map);
  1295. foreach (var pair in grouping)
  1296. {
  1297. map.MapSet(pair.Key, pair.Value);
  1298. }
  1299. return map;
  1300. }
  1301. private Dictionary<JsValue, ArrayInstance> BuildArrayGrouping(JsValue thisObject, JsValue[] arguments, bool mapMode)
  1302. {
  1303. var o = ArrayOperations.For(_realm, thisObject);
  1304. var len = o.GetLongLength();
  1305. var callbackfn = arguments.At(0);
  1306. var callable = GetCallable(callbackfn);
  1307. var thisArg = arguments.At(1);
  1308. var result = new Dictionary<JsValue, ArrayInstance>();
  1309. var args = _engine._jsValueArrayPool.RentArray(3);
  1310. args[2] = o.Target;
  1311. for (uint k = 0; k < len; k++)
  1312. {
  1313. var kValue = o.Get(k);
  1314. args[0] = kValue;
  1315. args[1] = k;
  1316. var value = callable.Call(thisArg, args);
  1317. JsValue key;
  1318. if (mapMode)
  1319. {
  1320. key = (value as JsNumber)?.IsNegativeZero() == true ? JsNumber.PositiveZero : value;
  1321. }
  1322. else
  1323. {
  1324. key = TypeConverter.ToPropertyKey(value);
  1325. }
  1326. if (!result.TryGetValue(key, out var list))
  1327. {
  1328. result[key] = list = new ArrayInstance(_engine)
  1329. {
  1330. _length = new PropertyDescriptor(JsNumber.PositiveZero, PropertyFlag.OnlyWritable)
  1331. };
  1332. }
  1333. list.SetIndexValue(list.GetLength(), kValue, updateLength: true);
  1334. }
  1335. _engine._jsValueArrayPool.ReturnArray(args);
  1336. return result;
  1337. }
  1338. internal sealed class ArrayComparer : IComparer<JsValue>
  1339. {
  1340. /// <summary>
  1341. /// Default instance without any compare function.
  1342. /// </summary>
  1343. public static readonly ArrayComparer Default = new(null, null);
  1344. public static ArrayComparer WithFunction(Engine engine, ICallable compare)
  1345. {
  1346. if (compare == null)
  1347. {
  1348. return Default;
  1349. }
  1350. return new ArrayComparer(engine, compare);
  1351. }
  1352. private readonly Engine? _engine;
  1353. private readonly ICallable? _compare;
  1354. private readonly JsValue[] _comparableArray = new JsValue[2];
  1355. private ArrayComparer(Engine? engine, ICallable? compare)
  1356. {
  1357. _engine = engine;
  1358. _compare = compare;
  1359. }
  1360. public int Compare(JsValue x, JsValue y)
  1361. {
  1362. var xIsNull = ReferenceEquals(x, null);
  1363. var yIsNull = ReferenceEquals(y, null);
  1364. if (xIsNull)
  1365. {
  1366. if (yIsNull)
  1367. {
  1368. return 0;
  1369. }
  1370. return 1;
  1371. }
  1372. else
  1373. {
  1374. if (yIsNull)
  1375. {
  1376. return -1;
  1377. }
  1378. }
  1379. var xUndefined = x!.IsUndefined();
  1380. var yUndefined = y!.IsUndefined();
  1381. if (xUndefined && yUndefined)
  1382. {
  1383. return 0;
  1384. }
  1385. if (xUndefined)
  1386. {
  1387. return 1;
  1388. }
  1389. if (yUndefined)
  1390. {
  1391. return -1;
  1392. }
  1393. if (_compare != null)
  1394. {
  1395. _engine!.RunBeforeExecuteStatementChecks(null);
  1396. _comparableArray[0] = x!;
  1397. _comparableArray[1] = y!;
  1398. var s = TypeConverter.ToNumber(_compare.Call(Undefined, _comparableArray));
  1399. if (s < 0)
  1400. {
  1401. return -1;
  1402. }
  1403. if (s > 0)
  1404. {
  1405. return 1;
  1406. }
  1407. return 0;
  1408. }
  1409. var xString = TypeConverter.ToString(x!);
  1410. var yString = TypeConverter.ToString(y!);
  1411. return string.CompareOrdinal(xString, yString);
  1412. }
  1413. }
  1414. }
  1415. }