ArrayPrototype.cs 57 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650
  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 { CanUseFastAccess: true } arrayInstance
  388. && !arrayInstance.HasOwnProperty(CommonProperties.Constructor))
  389. {
  390. return arrayInstance.Map(arguments);
  391. }
  392. var o = ArrayOperations.For(_realm, thisObj);
  393. var len = o.GetLongLength();
  394. if (len > ArrayOperations.MaxArrayLength)
  395. {
  396. ExceptionHelper.ThrowRangeError(_realm, "Invalid array length");;
  397. }
  398. var callbackfn = arguments.At(0);
  399. var thisArg = arguments.At(1);
  400. var callable = GetCallable(callbackfn);
  401. var a = ArrayOperations.For(_realm.Intrinsics.Array.ArraySpeciesCreate(TypeConverter.ToObject(_realm, thisObj), (uint) len));
  402. var args = _engine._jsValueArrayPool.RentArray(3);
  403. args[2] = o.Target;
  404. for (uint k = 0; k < len; k++)
  405. {
  406. if (o.TryGetValue(k, out var kvalue))
  407. {
  408. args[0] = kvalue;
  409. args[1] = k;
  410. var mappedValue = callable.Call(thisArg, args);
  411. a.CreateDataPropertyOrThrow(k, mappedValue);
  412. }
  413. }
  414. _engine._jsValueArrayPool.ReturnArray(args);
  415. return a.Target;
  416. }
  417. /// <summary>
  418. /// https://tc39.es/ecma262/#sec-array.prototype.flat
  419. /// </summary>
  420. private JsValue Flat(JsValue thisObj, JsValue[] arguments)
  421. {
  422. var O = TypeConverter.ToObject(_realm, thisObj);
  423. var operations = ArrayOperations.For(O);
  424. var sourceLen = operations.GetLength();
  425. double depthNum = 1;
  426. var depth = arguments.At(0);
  427. if (!depth.IsUndefined())
  428. {
  429. depthNum = TypeConverter.ToIntegerOrInfinity(depth);
  430. }
  431. if (depthNum < 0)
  432. {
  433. depthNum = 0;
  434. }
  435. var A = _realm.Intrinsics.Array.ArraySpeciesCreate(O, 0);
  436. FlattenIntoArray(A, O, sourceLen, 0, depthNum);
  437. return A;
  438. }
  439. /// <summary>
  440. /// https://tc39.es/ecma262/#sec-array.prototype.flatmap
  441. /// </summary>
  442. private JsValue FlatMap(JsValue thisObj, JsValue[] arguments)
  443. {
  444. var O = TypeConverter.ToObject(_realm, thisObj);
  445. var mapperFunction = arguments.At(0);
  446. var thisArg = arguments.At(1);
  447. var sourceLen = O.Length;
  448. if (!mapperFunction.IsCallable)
  449. {
  450. ExceptionHelper.ThrowTypeError(_realm, "flatMap mapper function is not callable");
  451. }
  452. var A = _realm.Intrinsics.Array.ArraySpeciesCreate(O, 0);
  453. FlattenIntoArray(A, O, sourceLen, 0, 1, (ICallable) mapperFunction, thisArg);
  454. return A;
  455. }
  456. /// <summary>
  457. /// https://tc39.es/ecma262/#sec-flattenintoarray
  458. /// </summary>
  459. private long FlattenIntoArray(
  460. ObjectInstance target,
  461. ObjectInstance source,
  462. uint sourceLen,
  463. long start,
  464. double depth,
  465. ICallable? mapperFunction = null,
  466. JsValue? thisArg = null)
  467. {
  468. var targetIndex = start;
  469. var sourceIndex = 0;
  470. var callArguments = System.Array.Empty<JsValue>();
  471. if (mapperFunction is not null)
  472. {
  473. callArguments = _engine._jsValueArrayPool.RentArray(3);
  474. callArguments[2] = source;
  475. }
  476. while (sourceIndex < sourceLen)
  477. {
  478. var P = TypeConverter.ToString(sourceIndex);
  479. var exists = source.HasProperty(P);
  480. if (exists)
  481. {
  482. var element = source.Get(P);
  483. if (mapperFunction is not null)
  484. {
  485. callArguments[0] = element;
  486. callArguments[1] = JsNumber.Create(sourceIndex);
  487. element = mapperFunction.Call(thisArg ?? Undefined, callArguments);
  488. }
  489. var shouldFlatten = false;
  490. if (depth > 0)
  491. {
  492. shouldFlatten = element.IsArray();
  493. }
  494. if (shouldFlatten)
  495. {
  496. var newDepth = double.IsPositiveInfinity(depth)
  497. ? depth
  498. : depth - 1;
  499. var objectInstance = (ObjectInstance) element;
  500. var elementLen = objectInstance.Length;
  501. targetIndex = FlattenIntoArray(target, objectInstance, elementLen, targetIndex, newDepth);
  502. }
  503. else
  504. {
  505. if (targetIndex >= NumberConstructor.MaxSafeInteger)
  506. {
  507. ExceptionHelper.ThrowTypeError(_realm);
  508. }
  509. target.CreateDataPropertyOrThrow(targetIndex, element);
  510. targetIndex += 1;
  511. }
  512. }
  513. sourceIndex++;
  514. }
  515. if (mapperFunction is not null)
  516. {
  517. _engine._jsValueArrayPool.ReturnArray(callArguments);
  518. }
  519. return targetIndex;
  520. }
  521. private JsValue ForEach(JsValue thisObj, JsValue[] arguments)
  522. {
  523. var callbackfn = arguments.At(0);
  524. var thisArg = arguments.At(1);
  525. var o = ArrayOperations.For(_realm, thisObj);
  526. var len = o.GetLength();
  527. var callable = GetCallable(callbackfn);
  528. var args = _engine._jsValueArrayPool.RentArray(3);
  529. args[2] = o.Target;
  530. for (uint k = 0; k < len; k++)
  531. {
  532. if (o.TryGetValue(k, out var kvalue))
  533. {
  534. args[0] = kvalue;
  535. args[1] = k;
  536. callable.Call(thisArg, args);
  537. }
  538. }
  539. _engine._jsValueArrayPool.ReturnArray(args);
  540. return Undefined;
  541. }
  542. /// <summary>
  543. /// https://tc39.es/ecma262/#sec-array.prototype.includes
  544. /// </summary>
  545. private JsValue Includes(JsValue thisObj, JsValue[] arguments)
  546. {
  547. var o = ArrayOperations.For(_realm, thisObj);
  548. var len = (long) o.GetLongLength();
  549. if (len == 0)
  550. {
  551. return JsBoolean.False;
  552. }
  553. var searchElement = arguments.At(0);
  554. var fromIndex = arguments.At(1);
  555. long k = 0;
  556. var n = TypeConverter.ToIntegerOrInfinity(fromIndex);
  557. if (double.IsPositiveInfinity(n))
  558. {
  559. return JsBoolean.False;
  560. }
  561. else if (double.IsNegativeInfinity(n))
  562. {
  563. n = 0;
  564. }
  565. else if (n >= 0)
  566. {
  567. k = (long) n;
  568. }
  569. else
  570. {
  571. k = len + (long) n;
  572. if (k < 0)
  573. {
  574. k = 0;
  575. }
  576. }
  577. while (k < len)
  578. {
  579. var value = o.Get((ulong) k);
  580. if (SameValueZeroComparer.Equals(value, searchElement))
  581. {
  582. return true;
  583. }
  584. k++;
  585. }
  586. return false;
  587. }
  588. private JsValue Some(JsValue thisObj, JsValue[] arguments)
  589. {
  590. var target = TypeConverter.ToObject(_realm, thisObj);
  591. return target.FindWithCallback(arguments, out _, out _, false);
  592. }
  593. /// <summary>
  594. /// https://tc39.es/ecma262/#sec-array.prototype.every
  595. /// </summary>
  596. private JsValue Every(JsValue thisObj, JsValue[] arguments)
  597. {
  598. var o = ArrayOperations.For(_realm, thisObj);
  599. ulong len = o.GetLongLength();
  600. if (len == 0)
  601. {
  602. return JsBoolean.True;
  603. }
  604. var callbackfn = arguments.At(0);
  605. var thisArg = arguments.At(1);
  606. var callable = GetCallable(callbackfn);
  607. var args = _engine._jsValueArrayPool.RentArray(3);
  608. args[2] = o.Target;
  609. for (uint k = 0; k < len; k++)
  610. {
  611. if (o.TryGetValue(k, out var kvalue))
  612. {
  613. args[0] = kvalue;
  614. args[1] = k;
  615. var testResult = callable.Call(thisArg, args);
  616. if (false == TypeConverter.ToBoolean(testResult))
  617. {
  618. return JsBoolean.False;
  619. }
  620. }
  621. }
  622. _engine._jsValueArrayPool.ReturnArray(args);
  623. return JsBoolean.True;
  624. }
  625. /// <summary>
  626. /// https://tc39.es/ecma262/#sec-array.prototype.indexof
  627. /// </summary>
  628. private JsValue IndexOf(JsValue thisObj, JsValue[] arguments)
  629. {
  630. var o = ArrayOperations.For(_realm, thisObj);
  631. var len = o.GetLongLength();
  632. if (len == 0)
  633. {
  634. return -1;
  635. }
  636. var startIndex = arguments.Length > 1
  637. ? TypeConverter.ToIntegerOrInfinity(arguments.At(1))
  638. : 0;
  639. if (startIndex > ArrayOperations.MaxArrayLikeLength)
  640. {
  641. return JsNumber.IntegerNegativeOne;
  642. }
  643. ulong k;
  644. if (startIndex < 0)
  645. {
  646. var abs = System.Math.Abs(startIndex);
  647. ulong temp = len - (uint) abs;
  648. if (abs > len || temp < 0)
  649. {
  650. temp = 0;
  651. }
  652. k = temp;
  653. }
  654. else
  655. {
  656. k = (ulong) startIndex;
  657. }
  658. if (k >= len)
  659. {
  660. return -1;
  661. }
  662. ulong smallestIndex = o.GetSmallestIndex(len);
  663. if (smallestIndex > k)
  664. {
  665. k = smallestIndex;
  666. }
  667. var searchElement = arguments.At(0);
  668. for (; k < len; k++)
  669. {
  670. var kPresent = o.HasProperty(k);
  671. if (kPresent)
  672. {
  673. var elementK = o.Get(k);
  674. if (elementK == searchElement)
  675. {
  676. return k;
  677. }
  678. }
  679. }
  680. return -1;
  681. }
  682. /// <summary>
  683. /// https://tc39.es/ecma262/#sec-array.prototype.find
  684. /// </summary>
  685. private JsValue Find(JsValue thisObj, JsValue[] arguments)
  686. {
  687. var target = TypeConverter.ToObject(_realm, thisObj);
  688. target.FindWithCallback(arguments, out _, out var value, visitUnassigned: true);
  689. return value;
  690. }
  691. /// <summary>
  692. /// https://tc39.es/ecma262/#sec-array.prototype.findindex
  693. /// </summary>
  694. private JsValue FindIndex(JsValue thisObj, JsValue[] arguments)
  695. {
  696. var target = TypeConverter.ToObject(_realm, thisObj);
  697. if (target.FindWithCallback(arguments, out var index, out _, visitUnassigned: true))
  698. {
  699. return index;
  700. }
  701. return -1;
  702. }
  703. private JsValue FindLast(JsValue thisObj, JsValue[] arguments)
  704. {
  705. var target = TypeConverter.ToObject(_realm, thisObj);
  706. target.FindWithCallback(arguments, out _, out var value, visitUnassigned: true, fromEnd: true);
  707. return value;
  708. }
  709. private JsValue FindLastIndex(JsValue thisObj, JsValue[] arguments)
  710. {
  711. var target = TypeConverter.ToObject(_realm, thisObj);
  712. if (target.FindWithCallback(arguments, out var index, out _, visitUnassigned: true, fromEnd: true))
  713. {
  714. return index;
  715. }
  716. return -1;
  717. }
  718. /// <summary>
  719. /// https://tc39.es/proposal-relative-indexing-method/#sec-array-prototype-additions
  720. /// </summary>
  721. private JsValue At(JsValue thisObj, JsValue[] arguments)
  722. {
  723. var target = TypeConverter.ToObject(_realm, thisObj);
  724. var len = target.Length;
  725. var relativeIndex = TypeConverter.ToInteger(arguments.At(0));
  726. ulong actualIndex;
  727. if (relativeIndex < 0)
  728. {
  729. actualIndex = (ulong) (len + relativeIndex);
  730. }
  731. else
  732. {
  733. actualIndex = (ulong) relativeIndex;
  734. }
  735. if (actualIndex < 0 || actualIndex >= len)
  736. {
  737. return Undefined;
  738. }
  739. return target.Get(actualIndex);
  740. }
  741. /// <summary>
  742. /// https://tc39.es/ecma262/#sec-array.prototype.splice
  743. /// </summary>
  744. private JsValue Splice(JsValue thisObj, JsValue[] arguments)
  745. {
  746. var start = arguments.At(0);
  747. var deleteCount = arguments.At(1);
  748. var obj = TypeConverter.ToObject(_realm, thisObj);
  749. var o = ArrayOperations.For(_realm, obj);
  750. var len = o.GetLongLength();
  751. var relativeStart = TypeConverter.ToInteger(start);
  752. ulong actualStart;
  753. if (relativeStart < 0)
  754. {
  755. actualStart = (ulong) System.Math.Max(len + relativeStart, 0);
  756. }
  757. else
  758. {
  759. actualStart = (ulong) System.Math.Min(relativeStart, len);
  760. }
  761. var items = System.Array.Empty<JsValue>();
  762. ulong insertCount;
  763. ulong actualDeleteCount;
  764. if (arguments.Length == 0)
  765. {
  766. insertCount = 0;
  767. actualDeleteCount = 0;
  768. }
  769. else if (arguments.Length == 1)
  770. {
  771. insertCount = 0;
  772. actualDeleteCount = len - actualStart;
  773. }
  774. else
  775. {
  776. insertCount = (ulong) (arguments.Length - 2);
  777. var dc = TypeConverter.ToInteger(deleteCount);
  778. actualDeleteCount = (ulong) System.Math.Min(System.Math.Max(dc,0), len - actualStart);
  779. items = System.Array.Empty<JsValue>();
  780. if (arguments.Length > 2)
  781. {
  782. items = new JsValue[arguments.Length - 2];
  783. System.Array.Copy(arguments, 2, items, 0, items.Length);
  784. }
  785. }
  786. if (len + insertCount - actualDeleteCount > ArrayOperations.MaxArrayLikeLength)
  787. {
  788. ExceptionHelper.ThrowTypeError(_realm, "Invalid array length");
  789. }
  790. var instance = _realm.Intrinsics.Array.ArraySpeciesCreate(obj, actualDeleteCount);
  791. var a = ArrayOperations.For(instance);
  792. for (uint k = 0; k < actualDeleteCount; k++)
  793. {
  794. var index = actualStart + k;
  795. if (o.HasProperty(index))
  796. {
  797. var fromValue = o.Get(index);
  798. a.CreateDataPropertyOrThrow(k, fromValue);
  799. }
  800. }
  801. a.SetLength((uint) actualDeleteCount);
  802. var length = len - actualDeleteCount + (uint) items.Length;
  803. o.EnsureCapacity(length);
  804. if ((ulong) items.Length < actualDeleteCount)
  805. {
  806. for (ulong k = actualStart; k < len - actualDeleteCount; k++)
  807. {
  808. var from = k + actualDeleteCount;
  809. var to = k + (ulong) items.Length;
  810. if (o.HasProperty(from))
  811. {
  812. var fromValue = o.Get(from);
  813. o.Set(to, fromValue, throwOnError: false);
  814. }
  815. else
  816. {
  817. o.DeletePropertyOrThrow(to);
  818. }
  819. }
  820. for (var k = len; k > len - actualDeleteCount + (ulong) items.Length; k--)
  821. {
  822. o.DeletePropertyOrThrow(k - 1);
  823. }
  824. }
  825. else if ((ulong) items.Length > actualDeleteCount)
  826. {
  827. for (var k = len - actualDeleteCount; k > actualStart; k--)
  828. {
  829. var from = k + actualDeleteCount - 1;
  830. var to = k + (ulong) items.Length - 1;
  831. if (o.HasProperty(from))
  832. {
  833. var fromValue = o.Get(from);
  834. o.Set(to, fromValue, throwOnError: true);
  835. }
  836. else
  837. {
  838. o.DeletePropertyOrThrow(to);
  839. }
  840. }
  841. }
  842. for (uint k = 0; k < items.Length; k++)
  843. {
  844. var e = items[k];
  845. o.Set(k + actualStart, e, throwOnError: true);
  846. }
  847. o.SetLength(length);
  848. return a.Target;
  849. }
  850. /// <summary>
  851. /// /https://tc39.es/ecma262/#sec-array.prototype.unshift
  852. /// </summary>
  853. private JsValue Unshift(JsValue thisObj, JsValue[] arguments)
  854. {
  855. var o = ArrayOperations.For(_realm, thisObj);
  856. var len = o.GetLongLength();
  857. var argCount = (uint) arguments.Length;
  858. if (len + argCount > ArrayOperations.MaxArrayLikeLength)
  859. {
  860. ExceptionHelper.ThrowTypeError(_realm, "Invalid array length");
  861. }
  862. o.EnsureCapacity(len + argCount);
  863. var minIndex = o.GetSmallestIndex(len);
  864. for (var k = len; k > minIndex; k--)
  865. {
  866. var from = k - 1;
  867. var to = k + argCount - 1;
  868. if (o.TryGetValue(from, out var fromValue))
  869. {
  870. o.Set(to, fromValue, updateLength: false);
  871. }
  872. else
  873. {
  874. o.DeletePropertyOrThrow(to);
  875. }
  876. }
  877. for (uint j = 0; j < argCount; j++)
  878. {
  879. o.Set(j, arguments[j], updateLength: false);
  880. }
  881. o.SetLength(len + argCount);
  882. return len + argCount;
  883. }
  884. /// <summary>
  885. /// https://tc39.es/ecma262/#sec-array.prototype.sort
  886. /// </summary>
  887. private JsValue Sort(JsValue thisObj, JsValue[] arguments)
  888. {
  889. var objectInstance = TypeConverter.ToObject(_realm, thisObj);
  890. var obj = ArrayOperations.For(objectInstance);
  891. var compareArg = arguments.At(0);
  892. ICallable? compareFn = null;
  893. if (!compareArg.IsUndefined())
  894. {
  895. if (compareArg is not ICallable callable)
  896. {
  897. ExceptionHelper.ThrowTypeError(_realm, "The comparison function must be either a function or undefined");
  898. return null;
  899. }
  900. compareFn = callable;
  901. }
  902. var len = obj.GetLength();
  903. if (len <= 1)
  904. {
  905. return obj.Target;
  906. }
  907. var items = new List<JsValue>((int) System.Math.Min(10_000, obj.GetLength()));
  908. for (ulong k = 0; k < len; ++k)
  909. {
  910. if (obj.TryGetValue(k, out var kValue))
  911. {
  912. items.Add(kValue);
  913. }
  914. }
  915. var itemCount = items.Count;
  916. // don't eat inner exceptions
  917. try
  918. {
  919. var array = items.OrderBy(x => x, ArrayComparer.WithFunction(_engine, compareFn!)).ToArray();
  920. uint j;
  921. for (j = 0; j < itemCount; ++j)
  922. {
  923. var updateLength = j == itemCount - 1;
  924. obj.Set(j, array[j], updateLength: updateLength, throwOnError: true);
  925. }
  926. for (; j < len; ++j)
  927. {
  928. obj.DeletePropertyOrThrow(j);
  929. }
  930. }
  931. catch (InvalidOperationException e)
  932. {
  933. throw e.InnerException ?? e;
  934. }
  935. return obj.Target;
  936. }
  937. /// <summary>
  938. /// https://tc39.es/ecma262/#sec-array.prototype.slice
  939. /// </summary>
  940. private JsValue Slice(JsValue thisObj, JsValue[] arguments)
  941. {
  942. var start = arguments.At(0);
  943. var end = arguments.At(1);
  944. var o = ArrayOperations.For(_realm, thisObj);
  945. var len = o.GetLongLength();
  946. var relativeStart = TypeConverter.ToInteger(start);
  947. ulong k;
  948. if (relativeStart < 0)
  949. {
  950. k = (ulong) System.Math.Max(len + relativeStart, 0);
  951. }
  952. else
  953. {
  954. k = (ulong) System.Math.Min(TypeConverter.ToInteger(start), len);
  955. }
  956. ulong final;
  957. if (end.IsUndefined())
  958. {
  959. final = (ulong) TypeConverter.ToNumber(len);
  960. }
  961. else
  962. {
  963. double relativeEnd = TypeConverter.ToInteger(end);
  964. if (relativeEnd < 0)
  965. {
  966. final = (ulong) System.Math.Max(len + relativeEnd, 0);
  967. }
  968. else
  969. {
  970. final = (ulong) System.Math.Min(relativeEnd, len);
  971. }
  972. }
  973. if (k < final && final - k > ArrayOperations.MaxArrayLength)
  974. {
  975. ExceptionHelper.ThrowRangeError(_realm, "Invalid array length");;
  976. }
  977. var length = (uint) System.Math.Max(0, (long) final - (long) k);
  978. var a = _realm.Intrinsics.Array.ArraySpeciesCreate(TypeConverter.ToObject(_realm, thisObj), length);
  979. if (thisObj is ArrayInstance ai && a is ArrayInstance a2)
  980. {
  981. a2.CopyValues(ai, (uint) k, 0, length);
  982. }
  983. else
  984. {
  985. // slower path
  986. var operations = ArrayOperations.For(a);
  987. for (uint n = 0; k < final; k++, n++)
  988. {
  989. if (o.TryGetValue(k, out var kValue))
  990. {
  991. operations.CreateDataPropertyOrThrow(n, kValue);
  992. }
  993. }
  994. }
  995. a.DefineOwnProperty(CommonProperties.Length, new PropertyDescriptor(length, PropertyFlag.ConfigurableEnumerableWritable));
  996. return a;
  997. }
  998. private JsValue Shift(JsValue thisObj, JsValue[] arg2)
  999. {
  1000. var o = ArrayOperations.For(_realm, thisObj);
  1001. var len = o.GetLength();
  1002. if (len == 0)
  1003. {
  1004. o.SetLength(0);
  1005. return Undefined;
  1006. }
  1007. var first = o.Get(0);
  1008. for (uint k = 1; k < len; k++)
  1009. {
  1010. var to = k - 1;
  1011. if (o.TryGetValue(k, out var fromVal))
  1012. {
  1013. o.Set(to, fromVal, throwOnError: false);
  1014. }
  1015. else
  1016. {
  1017. o.DeletePropertyOrThrow(to);
  1018. }
  1019. }
  1020. o.DeletePropertyOrThrow(len - 1);
  1021. o.SetLength(len - 1);
  1022. return first;
  1023. }
  1024. /// <summary>
  1025. /// https://tc39.es/ecma262/#sec-array.prototype.reverse
  1026. /// </summary>
  1027. private JsValue Reverse(JsValue thisObj, JsValue[] arguments)
  1028. {
  1029. var o = ArrayOperations.For(_realm, thisObj);
  1030. var len = o.GetLongLength();
  1031. var middle = (ulong) System.Math.Floor(len / 2.0);
  1032. uint lower = 0;
  1033. while (lower != middle)
  1034. {
  1035. var upper = len - lower - 1;
  1036. var lowerExists = o.HasProperty(lower);
  1037. var lowerValue = lowerExists ? o.Get(lower) : null;
  1038. var upperExists = o.HasProperty(upper);
  1039. var upperValue = upperExists ? o.Get(upper) : null;
  1040. if (lowerExists && upperExists)
  1041. {
  1042. o.Set(lower, upperValue!, throwOnError: true);
  1043. o.Set(upper, lowerValue!, throwOnError: true);
  1044. }
  1045. if (!lowerExists && upperExists)
  1046. {
  1047. o.Set(lower, upperValue!, throwOnError: true);
  1048. o.DeletePropertyOrThrow(upper);
  1049. }
  1050. if (lowerExists && !upperExists)
  1051. {
  1052. o.DeletePropertyOrThrow(lower);
  1053. o.Set(upper, lowerValue!, throwOnError: true);
  1054. }
  1055. lower++;
  1056. }
  1057. return o.Target;
  1058. }
  1059. /// <summary>
  1060. /// https://tc39.es/ecma262/#sec-array.prototype.join
  1061. /// </summary>
  1062. private JsValue Join(JsValue thisObj, JsValue[] arguments)
  1063. {
  1064. var separator = arguments.At(0);
  1065. var o = ArrayOperations.For(_realm, thisObj);
  1066. var len = o.GetLength();
  1067. var sep = TypeConverter.ToString(separator.IsUndefined() ? JsString.CommaString : separator);
  1068. // as per the spec, this has to be called after ToString(separator)
  1069. if (len == 0)
  1070. {
  1071. return JsString.Empty;
  1072. }
  1073. static string StringFromJsValue(JsValue value)
  1074. {
  1075. return value.IsNullOrUndefined()
  1076. ? ""
  1077. : TypeConverter.ToString(value);
  1078. }
  1079. var s = StringFromJsValue(o.Get(0));
  1080. if (len == 1)
  1081. {
  1082. return s;
  1083. }
  1084. using var sb = StringBuilderPool.Rent();
  1085. sb.Builder.Append(s);
  1086. for (uint k = 1; k < len; k++)
  1087. {
  1088. sb.Builder.Append(sep);
  1089. sb.Builder.Append(StringFromJsValue(o.Get(k)));
  1090. }
  1091. return sb.ToString();
  1092. }
  1093. private JsValue ToLocaleString(JsValue thisObj, JsValue[] arguments)
  1094. {
  1095. var array = ArrayOperations.For(_realm, thisObj);
  1096. var len = array.GetLength();
  1097. const string separator = ",";
  1098. if (len == 0)
  1099. {
  1100. return JsString.Empty;
  1101. }
  1102. JsValue r;
  1103. if (!array.TryGetValue(0, out var firstElement) || firstElement.IsNull() || firstElement.IsUndefined())
  1104. {
  1105. r = JsString.Empty;
  1106. }
  1107. else
  1108. {
  1109. var elementObj = TypeConverter.ToObject(_realm, firstElement);
  1110. var func = elementObj.Get("toLocaleString", elementObj) as ICallable;
  1111. if (func is null)
  1112. {
  1113. ExceptionHelper.ThrowTypeError(_realm);
  1114. }
  1115. r = func.Call(elementObj, Arguments.Empty);
  1116. }
  1117. for (uint k = 1; k < len; k++)
  1118. {
  1119. string s = r + separator;
  1120. if (!array.TryGetValue(k, out var nextElement) || nextElement.IsNull())
  1121. {
  1122. r = JsString.Empty;
  1123. }
  1124. else
  1125. {
  1126. var elementObj = TypeConverter.ToObject(_realm, nextElement);
  1127. var func = elementObj.Get("toLocaleString", elementObj) as ICallable;
  1128. if (func is null)
  1129. {
  1130. ExceptionHelper.ThrowTypeError(_realm);
  1131. }
  1132. r = func.Call(elementObj, Arguments.Empty);
  1133. }
  1134. r = s + r;
  1135. }
  1136. return r;
  1137. }
  1138. /// <summary>
  1139. /// https://tc39.es/ecma262/#sec-array.prototype.concat
  1140. /// </summary>
  1141. private JsValue Concat(JsValue thisObj, JsValue[] arguments)
  1142. {
  1143. var o = TypeConverter.ToObject(_realm, thisObj);
  1144. var items = new List<JsValue>(arguments.Length + 1) {o};
  1145. items.AddRange(arguments);
  1146. uint n = 0;
  1147. var a = _realm.Intrinsics.Array.ArraySpeciesCreate(TypeConverter.ToObject(_realm, thisObj), 0);
  1148. var aOperations = ArrayOperations.For(a);
  1149. for (var i = 0; i < items.Count; i++)
  1150. {
  1151. var e = items[i];
  1152. if (e is ObjectInstance { IsConcatSpreadable: true } oi)
  1153. {
  1154. if (e is ArrayInstance eArray && a is ArrayInstance a2)
  1155. {
  1156. a2.CopyValues(eArray, 0, n, eArray.GetLength());
  1157. n += eArray.GetLength();
  1158. }
  1159. else
  1160. {
  1161. var operations = ArrayOperations.For(oi);
  1162. var len = operations.GetLongLength();
  1163. if (n + len > ArrayOperations.MaxArrayLikeLength)
  1164. {
  1165. ExceptionHelper.ThrowTypeError(_realm, "Invalid array length");
  1166. }
  1167. for (uint k = 0; k < len; k++)
  1168. {
  1169. operations.TryGetValue(k, out var subElement);
  1170. aOperations.CreateDataPropertyOrThrow(n, subElement);
  1171. n++;
  1172. }
  1173. }
  1174. }
  1175. else
  1176. {
  1177. aOperations.CreateDataPropertyOrThrow(n, e);
  1178. n++;
  1179. }
  1180. }
  1181. // this is not in the specs, but is necessary in case the last element of the last
  1182. // array doesn't exist, and thus the length would not be incremented
  1183. a.DefineOwnProperty(CommonProperties.Length, new PropertyDescriptor(n, PropertyFlag.OnlyWritable));
  1184. return a;
  1185. }
  1186. internal JsValue ToString(JsValue thisObj, JsValue[] arguments)
  1187. {
  1188. var array = TypeConverter.ToObject(_realm, thisObj);
  1189. Func<JsValue, JsValue[], JsValue> func;
  1190. if (array.Get("join") is ICallable joinFunc)
  1191. {
  1192. func = joinFunc.Call;
  1193. }
  1194. else
  1195. {
  1196. func = _realm.Intrinsics.Object.PrototypeObject.ToObjectString;
  1197. }
  1198. return func(array, Arguments.Empty);
  1199. }
  1200. /// <summary>
  1201. /// https://tc39.es/ecma262/#sec-array.prototype.reduceright
  1202. /// </summary>
  1203. private JsValue ReduceRight(JsValue thisObj, JsValue[] arguments)
  1204. {
  1205. var callbackfn = arguments.At(0);
  1206. var initialValue = arguments.At(1);
  1207. var o = ArrayOperations.For(TypeConverter.ToObject(_realm, thisObj));
  1208. var len = o.GetLongLength();
  1209. var callable = GetCallable(callbackfn);
  1210. if (len == 0 && arguments.Length < 2)
  1211. {
  1212. ExceptionHelper.ThrowTypeError(_realm);
  1213. }
  1214. long k = (long) (len - 1);
  1215. JsValue accumulator = Undefined;
  1216. if (arguments.Length > 1)
  1217. {
  1218. accumulator = initialValue;
  1219. }
  1220. else
  1221. {
  1222. var kPresent = false;
  1223. while (kPresent == false && k >= 0)
  1224. {
  1225. if ((kPresent = o.TryGetValue((ulong) k, out var temp)))
  1226. {
  1227. accumulator = temp;
  1228. }
  1229. k--;
  1230. }
  1231. if (kPresent == false)
  1232. {
  1233. ExceptionHelper.ThrowTypeError(_realm);
  1234. }
  1235. }
  1236. var jsValues = new JsValue[4];
  1237. jsValues[3] = o.Target;
  1238. for (; k >= 0; k--)
  1239. {
  1240. if (o.TryGetValue((ulong) k, out var kvalue))
  1241. {
  1242. jsValues[0] = accumulator;
  1243. jsValues[1] = kvalue;
  1244. jsValues[2] = k;
  1245. accumulator = callable.Call(Undefined, jsValues);
  1246. }
  1247. }
  1248. return accumulator;
  1249. }
  1250. /// <summary>
  1251. /// https://tc39.es/ecma262/#sec-array.prototype.push
  1252. /// </summary>
  1253. public JsValue Push(JsValue thisObject, JsValue[] arguments)
  1254. {
  1255. if (thisObject is ArrayInstance { CanUseFastAccess: true } arrayInstance)
  1256. {
  1257. return arrayInstance.Push(arguments);
  1258. }
  1259. var o = ArrayOperations.For(TypeConverter.ToObject(_realm, thisObject));
  1260. var n = o.GetLongLength();
  1261. if (n + (ulong) arguments.Length > ArrayOperations.MaxArrayLikeLength)
  1262. {
  1263. ExceptionHelper.ThrowTypeError(_realm, "Invalid array length");
  1264. }
  1265. foreach (var a in arguments)
  1266. {
  1267. o.Set(n, a, true);
  1268. n++;
  1269. }
  1270. o.SetLength(n);
  1271. return n;
  1272. }
  1273. public JsValue Pop(JsValue thisObject, JsValue[] arguments)
  1274. {
  1275. var o = ArrayOperations.For(_realm, thisObject);
  1276. ulong len = o.GetLongLength();
  1277. if (len == 0)
  1278. {
  1279. o.SetLength(0);
  1280. return Undefined;
  1281. }
  1282. len = len - 1;
  1283. JsValue element = o.Get(len);
  1284. o.DeletePropertyOrThrow(len);
  1285. o.SetLength(len);
  1286. return element;
  1287. }
  1288. /// <summary>
  1289. /// https://tc39.es/proposal-array-grouping/#sec-array.prototype.group
  1290. /// </summary>
  1291. private JsValue Group(JsValue thisObject, JsValue[] arguments)
  1292. {
  1293. var grouping = BuildArrayGrouping(thisObject, arguments, mapMode: false);
  1294. var obj = OrdinaryObjectCreate(_engine, null);
  1295. foreach (var pair in grouping)
  1296. {
  1297. obj.FastSetProperty(pair.Key, new PropertyDescriptor(pair.Value, PropertyFlag.ConfigurableEnumerableWritable));
  1298. }
  1299. return obj;
  1300. }
  1301. /// <summary>
  1302. /// https://tc39.es/proposal-array-grouping/#sec-array.prototype.grouptomap
  1303. /// </summary>
  1304. private JsValue GroupToMap(JsValue thisObject, JsValue[] arguments)
  1305. {
  1306. var grouping = BuildArrayGrouping(thisObject, arguments, mapMode: true);
  1307. var map = (MapInstance) Construct(_realm.Intrinsics.Map);
  1308. foreach (var pair in grouping)
  1309. {
  1310. map.MapSet(pair.Key, pair.Value);
  1311. }
  1312. return map;
  1313. }
  1314. private Dictionary<JsValue, ArrayInstance> BuildArrayGrouping(JsValue thisObject, JsValue[] arguments, bool mapMode)
  1315. {
  1316. var o = ArrayOperations.For(_realm, thisObject);
  1317. var len = o.GetLongLength();
  1318. var callbackfn = arguments.At(0);
  1319. var callable = GetCallable(callbackfn);
  1320. var thisArg = arguments.At(1);
  1321. var result = new Dictionary<JsValue, ArrayInstance>();
  1322. var args = _engine._jsValueArrayPool.RentArray(3);
  1323. args[2] = o.Target;
  1324. for (uint k = 0; k < len; k++)
  1325. {
  1326. var kValue = o.Get(k);
  1327. args[0] = kValue;
  1328. args[1] = k;
  1329. var value = callable.Call(thisArg, args);
  1330. JsValue key;
  1331. if (mapMode)
  1332. {
  1333. key = (value as JsNumber)?.IsNegativeZero() == true ? JsNumber.PositiveZero : value;
  1334. }
  1335. else
  1336. {
  1337. key = TypeConverter.ToPropertyKey(value);
  1338. }
  1339. if (!result.TryGetValue(key, out var list))
  1340. {
  1341. result[key] = list = new ArrayInstance(_engine)
  1342. {
  1343. _length = new PropertyDescriptor(JsNumber.PositiveZero, PropertyFlag.OnlyWritable)
  1344. };
  1345. }
  1346. list.SetIndexValue(list.GetLength(), kValue, updateLength: true);
  1347. }
  1348. _engine._jsValueArrayPool.ReturnArray(args);
  1349. return result;
  1350. }
  1351. internal sealed class ArrayComparer : IComparer<JsValue>
  1352. {
  1353. /// <summary>
  1354. /// Default instance without any compare function.
  1355. /// </summary>
  1356. public static readonly ArrayComparer Default = new(null, null);
  1357. public static ArrayComparer WithFunction(Engine engine, ICallable compare)
  1358. {
  1359. if (compare == null)
  1360. {
  1361. return Default;
  1362. }
  1363. return new ArrayComparer(engine, compare);
  1364. }
  1365. private readonly Engine? _engine;
  1366. private readonly ICallable? _compare;
  1367. private readonly JsValue[] _comparableArray = new JsValue[2];
  1368. private ArrayComparer(Engine? engine, ICallable? compare)
  1369. {
  1370. _engine = engine;
  1371. _compare = compare;
  1372. }
  1373. public int Compare(JsValue x, JsValue y)
  1374. {
  1375. var xIsNull = ReferenceEquals(x, null);
  1376. var yIsNull = ReferenceEquals(y, null);
  1377. if (xIsNull)
  1378. {
  1379. if (yIsNull)
  1380. {
  1381. return 0;
  1382. }
  1383. return 1;
  1384. }
  1385. else
  1386. {
  1387. if (yIsNull)
  1388. {
  1389. return -1;
  1390. }
  1391. }
  1392. var xUndefined = x!.IsUndefined();
  1393. var yUndefined = y!.IsUndefined();
  1394. if (xUndefined && yUndefined)
  1395. {
  1396. return 0;
  1397. }
  1398. if (xUndefined)
  1399. {
  1400. return 1;
  1401. }
  1402. if (yUndefined)
  1403. {
  1404. return -1;
  1405. }
  1406. if (_compare != null)
  1407. {
  1408. _engine!.RunBeforeExecuteStatementChecks(null);
  1409. _comparableArray[0] = x!;
  1410. _comparableArray[1] = y!;
  1411. var s = TypeConverter.ToNumber(_compare.Call(Undefined, _comparableArray));
  1412. if (s < 0)
  1413. {
  1414. return -1;
  1415. }
  1416. if (s > 0)
  1417. {
  1418. return 1;
  1419. }
  1420. return 0;
  1421. }
  1422. var xString = TypeConverter.ToString(x!);
  1423. var yString = TypeConverter.ToString(y!);
  1424. return string.CompareOrdinal(xString, yString);
  1425. }
  1426. }
  1427. }
  1428. }