PromiseConstructor.cpp 26 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519
  1. /*
  2. * Copyright (c) 2021, Linus Groh <linusg@serenityos.org>
  3. *
  4. * SPDX-License-Identifier: BSD-2-Clause
  5. */
  6. #include <AK/Function.h>
  7. #include <LibJS/Interpreter.h>
  8. #include <LibJS/Runtime/AbstractOperations.h>
  9. #include <LibJS/Runtime/AggregateError.h>
  10. #include <LibJS/Runtime/Array.h>
  11. #include <LibJS/Runtime/Error.h>
  12. #include <LibJS/Runtime/FunctionObject.h>
  13. #include <LibJS/Runtime/GlobalObject.h>
  14. #include <LibJS/Runtime/IteratorOperations.h>
  15. #include <LibJS/Runtime/Promise.h>
  16. #include <LibJS/Runtime/PromiseConstructor.h>
  17. #include <LibJS/Runtime/PromiseReaction.h>
  18. #include <LibJS/Runtime/PromiseResolvingElementFunctions.h>
  19. #include <LibJS/Runtime/TemporaryClearException.h>
  20. namespace JS {
  21. // 27.2.4.1.1 GetPromiseResolve ( promiseConstructor ), https://tc39.es/ecma262/#sec-getpromiseresolve
  22. static ThrowCompletionOr<Value> get_promise_resolve(GlobalObject& global_object, Value constructor)
  23. {
  24. VERIFY(constructor.is_constructor());
  25. auto& vm = global_object.vm();
  26. // 1. Let promiseResolve be ? Get(promiseConstructor, "resolve").
  27. auto promise_resolve = TRY(constructor.get(global_object, vm.names.resolve));
  28. // 2. If IsCallable(promiseResolve) is false, throw a TypeError exception.
  29. if (!promise_resolve.is_function())
  30. return vm.throw_completion<TypeError>(global_object, ErrorType::NotAFunction, promise_resolve.to_string_without_side_effects());
  31. // 3. Return promiseResolve.
  32. return promise_resolve;
  33. }
  34. static bool iterator_record_is_complete(GlobalObject& global_object, Object& iterator_record)
  35. {
  36. auto& vm = global_object.vm();
  37. // FIXME: Create a native iterator structure with the [[Done]] internal slot. For now, temporarily clear
  38. // the exception so we can access the "done" property on the iterator object.
  39. TemporaryClearException clear_exception(vm);
  40. return MUST(iterator_complete(global_object, iterator_record));
  41. }
  42. static void set_iterator_record_complete(GlobalObject& global_object, Object& iterator_record)
  43. {
  44. auto& vm = global_object.vm();
  45. // FIXME: Create a native iterator structure with the [[Done]] internal slot. For now, temporarily clear
  46. // the exception so we can access the "done" property on the iterator object.
  47. TemporaryClearException clear_exception(vm);
  48. MUST(iterator_record.set(vm.names.done, Value(true), Object::ShouldThrowExceptions::No));
  49. }
  50. using EndOfElementsCallback = Function<ThrowCompletionOr<Value>(PromiseValueList&)>;
  51. using InvokeElementFunctionCallback = Function<ThrowCompletionOr<Value>(PromiseValueList&, RemainingElements&, Value, size_t)>;
  52. static ThrowCompletionOr<Value> perform_promise_common(GlobalObject& global_object, Object& iterator_record, Value constructor, PromiseCapability result_capability, Value promise_resolve, EndOfElementsCallback end_of_list, InvokeElementFunctionCallback invoke_element_function)
  53. {
  54. auto& vm = global_object.vm();
  55. VERIFY(constructor.is_constructor());
  56. VERIFY(promise_resolve.is_function());
  57. // 1. Let values be a new empty List.
  58. auto* values = vm.heap().allocate_without_global_object<PromiseValueList>();
  59. // 2. Let remainingElementsCount be the Record { [[Value]]: 1 }.
  60. auto* remaining_elements_count = vm.heap().allocate_without_global_object<RemainingElements>(1);
  61. // 3. Let index be 0.
  62. size_t index = 0;
  63. // 4. Repeat,
  64. while (true) {
  65. // a. Let next be IteratorStep(iteratorRecord).
  66. auto next_or_error = iterator_step(global_object, iterator_record);
  67. // b. If next is an abrupt completion, set iteratorRecord.[[Done]] to true.
  68. // c. ReturnIfAbrupt(next).
  69. if (next_or_error.is_throw_completion()) {
  70. set_iterator_record_complete(global_object, iterator_record);
  71. return next_or_error.release_error();
  72. }
  73. auto* next = next_or_error.release_value();
  74. // d. If next is false, then
  75. if (!next) {
  76. // i. Set iteratorRecord.[[Done]] to true.
  77. set_iterator_record_complete(global_object, iterator_record);
  78. // ii. Set remainingElementsCount.[[Value]] to remainingElementsCount.[[Value]] - 1.
  79. // iii. If remainingElementsCount.[[Value]] is 0, then
  80. if (--remaining_elements_count->value == 0) {
  81. // 1-2/3. are handled in `end_of_list`
  82. return TRY(end_of_list(*values));
  83. }
  84. // iv. Return resultCapability.[[Promise]].
  85. return result_capability.promise;
  86. }
  87. // e. Let nextValue be IteratorValue(next).
  88. auto next_value_or_error = iterator_value(global_object, *next);
  89. // f. If nextValue is an abrupt completion, set iteratorRecord.[[Done]] to true.
  90. // g. ReturnIfAbrupt(nextValue).
  91. if (next_value_or_error.is_throw_completion()) {
  92. set_iterator_record_complete(global_object, iterator_record);
  93. return next_value_or_error.release_error();
  94. }
  95. auto next_value = next_value_or_error.release_value();
  96. // h. Append undefined to values.
  97. values->values().append(js_undefined());
  98. // i. Let nextPromise be ? Call(promiseResolve, constructor, « nextValue »).
  99. auto next_promise = TRY(vm.call(promise_resolve.as_function(), constructor, next_value));
  100. // j-q. are handled in `invoke_element_function`
  101. // r. Set remainingElementsCount.[[Value]] to remainingElementsCount.[[Value]] + 1.
  102. ++remaining_elements_count->value;
  103. // s. Perform ? Invoke(nextPromise, "then", « ... »).
  104. TRY(invoke_element_function(*values, *remaining_elements_count, next_promise, index));
  105. // t. Set index to index + 1.
  106. ++index;
  107. }
  108. }
  109. // 27.2.4.1.2 PerformPromiseAll ( iteratorRecord, constructor, resultCapability, promiseResolve ), https://tc39.es/ecma262/#sec-performpromiseall
  110. static ThrowCompletionOr<Value> perform_promise_all(GlobalObject& global_object, Object& iterator_record, Value constructor, PromiseCapability result_capability, Value promise_resolve)
  111. {
  112. auto& vm = global_object.vm();
  113. return perform_promise_common(
  114. global_object, iterator_record, constructor, result_capability, promise_resolve,
  115. [&](PromiseValueList& values) -> ThrowCompletionOr<Value> {
  116. // 1. Let valuesArray be ! CreateArrayFromList(values).
  117. auto values_array = Array::create_from(global_object, values.values());
  118. // 2. Perform ? Call(resultCapability.[[Resolve]], undefined, « valuesArray »).
  119. TRY(vm.call(*result_capability.resolve, js_undefined(), values_array));
  120. // iv. Return resultCapability.[[Promise]].
  121. return Value(result_capability.promise);
  122. },
  123. [&](PromiseValueList& values, RemainingElements& remaining_elements_count, Value next_promise, size_t index) {
  124. // j. Let steps be the algorithm steps defined in Promise.all Resolve Element Functions.
  125. // k. Let length be the number of non-optional parameters of the function definition in Promise.all Resolve Element Functions.
  126. // l. Let onFulfilled be ! CreateBuiltinFunction(steps, length, "", « [[AlreadyCalled]], [[Index]], [[Values]], [[Capability]], [[RemainingElements]] »).
  127. // m. Set onFulfilled.[[AlreadyCalled]] to false.
  128. // n. Set onFulfilled.[[Index]] to index.
  129. // o. Set onFulfilled.[[Values]] to values.
  130. // p. Set onFulfilled.[[Capability]] to resultCapability.
  131. // q. Set onFulfilled.[[RemainingElements]] to remainingElementsCount.
  132. auto* on_fulfilled = PromiseAllResolveElementFunction::create(global_object, index, values, result_capability, remaining_elements_count);
  133. on_fulfilled->define_direct_property(vm.names.name, js_string(vm, String::empty()), Attribute::Configurable);
  134. // s. Perform ? Invoke(nextPromise, "then", « onFulfilled, resultCapability.[[Reject]] »).
  135. return next_promise.invoke(global_object, vm.names.then, on_fulfilled, result_capability.reject);
  136. });
  137. }
  138. // 27.2.4.2.1 PerformPromiseAllSettled ( iteratorRecord, constructor, resultCapability, promiseResolve ), https://tc39.es/ecma262/#sec-performpromiseallsettled
  139. static ThrowCompletionOr<Value> perform_promise_all_settled(GlobalObject& global_object, Object& iterator_record, Value constructor, PromiseCapability result_capability, Value promise_resolve)
  140. {
  141. auto& vm = global_object.vm();
  142. return perform_promise_common(
  143. global_object, iterator_record, constructor, result_capability, promise_resolve,
  144. [&](PromiseValueList& values) -> ThrowCompletionOr<Value> {
  145. auto values_array = Array::create_from(global_object, values.values());
  146. TRY(vm.call(*result_capability.resolve, js_undefined(), values_array));
  147. return Value(result_capability.promise);
  148. },
  149. [&](PromiseValueList& values, RemainingElements& remaining_elements_count, Value next_promise, size_t index) {
  150. // j. Let stepsFulfilled be the algorithm steps defined in Promise.allSettled Resolve Element Functions.
  151. // k. Let lengthFulfilled be the number of non-optional parameters of the function definition in Promise.allSettled Resolve Element Functions.
  152. // l. Let onFulfilled be ! CreateBuiltinFunction(stepsFulfilled, lengthFulfilled, "", « [[AlreadyCalled]], [[Index]], [[Values]], [[Capability]], [[RemainingElements]] »).
  153. // m. Let alreadyCalled be the Record { [[Value]]: false }.
  154. // n. Set onFulfilled.[[AlreadyCalled]] to alreadyCalled.
  155. // o. Set onFulfilled.[[Index]] to index.
  156. // p. Set onFulfilled.[[Values]] to values.
  157. // q. Set onFulfilled.[[Capability]] to resultCapability.
  158. // r. Set onFulfilled.[[RemainingElements]] to remainingElementsCount.
  159. auto* on_fulfilled = PromiseAllSettledResolveElementFunction::create(global_object, index, values, result_capability, remaining_elements_count);
  160. on_fulfilled->define_direct_property(vm.names.name, js_string(vm, String::empty()), Attribute::Configurable);
  161. // s. Let stepsRejected be the algorithm steps defined in Promise.allSettled Reject Element Functions.
  162. // t. Let lengthRejected be the number of non-optional parameters of the function definition in Promise.allSettled Reject Element Functions.
  163. // u. Let onRejected be ! CreateBuiltinFunction(stepsRejected, lengthRejected, "", « [[AlreadyCalled]], [[Index]], [[Values]], [[Capability]], [[RemainingElements]] »).
  164. // v. Set onRejected.[[AlreadyCalled]] to alreadyCalled.
  165. // w. Set onRejected.[[Index]] to index.
  166. // x. Set onRejected.[[Values]] to values.
  167. // y. Set onRejected.[[Capability]] to resultCapability.
  168. // z. Set onRejected.[[RemainingElements]] to remainingElementsCount.
  169. auto* on_rejected = PromiseAllSettledRejectElementFunction::create(global_object, index, values, result_capability, remaining_elements_count);
  170. on_rejected->define_direct_property(vm.names.name, js_string(vm, String::empty()), Attribute::Configurable);
  171. // ab. Perform ? Invoke(nextPromise, "then", « onFulfilled, onRejected »).
  172. return next_promise.invoke(global_object, vm.names.then, on_fulfilled, on_rejected);
  173. });
  174. }
  175. // 27.2.4.3.1 PerformPromiseAny ( iteratorRecord, constructor, resultCapability, promiseResolve ), https://tc39.es/ecma262/#sec-performpromiseany
  176. static ThrowCompletionOr<Value> perform_promise_any(GlobalObject& global_object, Object& iterator_record, Value constructor, PromiseCapability result_capability, Value promise_resolve)
  177. {
  178. auto& vm = global_object.vm();
  179. return perform_promise_common(
  180. global_object, iterator_record, constructor, result_capability, promise_resolve,
  181. [&](PromiseValueList& errors) -> ThrowCompletionOr<Value> {
  182. // 1. Let error be a newly created AggregateError object.
  183. auto* error = AggregateError::create(global_object);
  184. // 2. Perform ! DefinePropertyOrThrow(error, "errors", PropertyDescriptor { [[Configurable]]: true, [[Enumerable]]: false, [[Writable]]: true, [[Value]]: ! CreateArrayFromList(errors) }).
  185. auto* errors_array = Array::create_from(global_object, errors.values());
  186. MUST(error->define_property_or_throw(vm.names.errors, { .value = errors_array, .writable = true, .enumerable = false, .configurable = true }));
  187. // 3. Return ThrowCompletion(error).
  188. vm.throw_exception(global_object, error);
  189. return throw_completion(error);
  190. },
  191. [&](PromiseValueList& errors, RemainingElements& remaining_elements_count, Value next_promise, size_t index) {
  192. // j. Let stepsRejected be the algorithm steps defined in Promise.any Reject Element Functions.
  193. // k. Let lengthRejected be the number of non-optional parameters of the function definition in Promise.any Reject Element Functions.
  194. // l. Let onRejected be ! CreateBuiltinFunction(stepsRejected, lengthRejected, "", « [[AlreadyCalled]], [[Index]], [[Errors]], [[Capability]], [[RemainingElements]] »).
  195. // m. Set onRejected.[[AlreadyCalled]] to false.
  196. // n. Set onRejected.[[Index]] to index.
  197. // o. Set onRejected.[[Errors]] to errors.
  198. // p. Set onRejected.[[Capability]] to resultCapability.
  199. // q. Set onRejected.[[RemainingElements]] to remainingElementsCount.
  200. auto* on_rejected = PromiseAnyRejectElementFunction::create(global_object, index, errors, result_capability, remaining_elements_count);
  201. on_rejected->define_direct_property(vm.names.name, js_string(vm, String::empty()), Attribute::Configurable);
  202. // s. Perform ? Invoke(nextPromise, "then", « resultCapability.[[Resolve]], onRejected »).
  203. return next_promise.invoke(global_object, vm.names.then, result_capability.resolve, on_rejected);
  204. });
  205. }
  206. // 27.2.4.5.1 PerformPromiseRace ( iteratorRecord, constructor, resultCapability, promiseResolve ), https://tc39.es/ecma262/#sec-performpromiserace
  207. static ThrowCompletionOr<Value> perform_promise_race(GlobalObject& global_object, Object& iterator_record, Value constructor, PromiseCapability result_capability, Value promise_resolve)
  208. {
  209. auto& vm = global_object.vm();
  210. return perform_promise_common(
  211. global_object, iterator_record, constructor, result_capability, promise_resolve,
  212. [&](PromiseValueList&) -> ThrowCompletionOr<Value> {
  213. // ii. Return resultCapability.[[Promise]].
  214. return Value(result_capability.promise);
  215. },
  216. [&](PromiseValueList&, RemainingElements&, Value next_promise, size_t) {
  217. // i. Perform ? Invoke(nextPromise, "then", « resultCapability.[[Resolve]], resultCapability.[[Reject]] »).
  218. return next_promise.invoke(global_object, vm.names.then, result_capability.resolve, result_capability.reject);
  219. });
  220. }
  221. PromiseConstructor::PromiseConstructor(GlobalObject& global_object)
  222. : NativeFunction(vm().names.Promise.as_string(), *global_object.function_prototype())
  223. {
  224. }
  225. void PromiseConstructor::initialize(GlobalObject& global_object)
  226. {
  227. auto& vm = this->vm();
  228. NativeFunction::initialize(global_object);
  229. // 27.2.4.4 Promise.prototype, https://tc39.es/ecma262/#sec-promise.prototype
  230. define_direct_property(vm.names.prototype, global_object.promise_prototype(), 0);
  231. u8 attr = Attribute::Writable | Attribute::Configurable;
  232. define_native_function(vm.names.all, all, 1, attr);
  233. define_native_function(vm.names.allSettled, all_settled, 1, attr);
  234. define_native_function(vm.names.any, any, 1, attr);
  235. define_native_function(vm.names.race, race, 1, attr);
  236. define_native_function(vm.names.reject, reject, 1, attr);
  237. define_native_function(vm.names.resolve, resolve, 1, attr);
  238. define_native_accessor(*vm.well_known_symbol_species(), symbol_species_getter, {}, Attribute::Configurable);
  239. define_direct_property(vm.names.length, Value(1), Attribute::Configurable);
  240. }
  241. // 27.2.3.1 Promise ( executor ), https://tc39.es/ecma262/#sec-promise-executor
  242. ThrowCompletionOr<Value> PromiseConstructor::call()
  243. {
  244. auto& vm = this->vm();
  245. // 1. If NewTarget is undefined, throw a TypeError exception.
  246. return vm.throw_completion<TypeError>(global_object(), ErrorType::ConstructorWithoutNew, vm.names.Promise);
  247. }
  248. // 27.2.3.1 Promise ( executor ), https://tc39.es/ecma262/#sec-promise-executor
  249. ThrowCompletionOr<Object*> PromiseConstructor::construct(FunctionObject& new_target)
  250. {
  251. auto& vm = this->vm();
  252. auto& global_object = this->global_object();
  253. auto executor = vm.argument(0);
  254. // 2. If IsCallable(executor) is false, throw a TypeError exception.
  255. if (!executor.is_function())
  256. return vm.throw_completion<TypeError>(global_object, ErrorType::PromiseExecutorNotAFunction);
  257. // 3. Let promise be ? OrdinaryCreateFromConstructor(NewTarget, "%Promise.prototype%", « [[PromiseState]], [[PromiseResult]], [[PromiseFulfillReactions]], [[PromiseRejectReactions]], [[PromiseIsHandled]] »).
  258. // 4. Set promise.[[PromiseState]] to pending.
  259. // 5. Set promise.[[PromiseFulfillReactions]] to a new empty List.
  260. // 6. Set promise.[[PromiseRejectReactions]] to a new empty List.
  261. // 7. Set promise.[[PromiseIsHandled]] to false.
  262. auto* promise = TRY(ordinary_create_from_constructor<Promise>(global_object, new_target, &GlobalObject::promise_prototype));
  263. // 8. Let resolvingFunctions be CreateResolvingFunctions(promise).
  264. auto [resolve_function, reject_function] = promise->create_resolving_functions();
  265. // 9. Let completion be Call(executor, undefined, « resolvingFunctions.[[Resolve]], resolvingFunctions.[[Reject]] »).
  266. (void)vm.call(executor.as_function(), js_undefined(), &resolve_function, &reject_function);
  267. // 10. If completion is an abrupt completion, then
  268. if (auto* exception = vm.exception()) {
  269. vm.clear_exception();
  270. vm.stop_unwind();
  271. // a. Perform ? Call(resolvingFunctions.[[Reject]], undefined, « completion.[[Value]] »).
  272. TRY(vm.call(reject_function, js_undefined(), exception->value()));
  273. }
  274. // 11. Return promise.
  275. return promise;
  276. }
  277. // 27.2.4.1 Promise.all ( iterable ), https://tc39.es/ecma262/#sec-promise.all
  278. JS_DEFINE_NATIVE_FUNCTION(PromiseConstructor::all)
  279. {
  280. // 1. Let C be the this value.
  281. auto* constructor = TRY(vm.this_value(global_object).to_object(global_object));
  282. // 2. Let promiseCapability be ? NewPromiseCapability(C).
  283. auto promise_capability = TRY(new_promise_capability(global_object, constructor));
  284. // 3. Let promiseResolve be GetPromiseResolve(C).
  285. // 4. IfAbruptRejectPromise(promiseResolve, promiseCapability).
  286. auto promise_resolve = TRY_OR_REJECT(vm, promise_capability, get_promise_resolve(global_object, constructor));
  287. // 5. Let iteratorRecord be GetIterator(iterable).
  288. // 6. IfAbruptRejectPromise(iteratorRecord, promiseCapability).
  289. auto* iterator_record = TRY_OR_REJECT(vm, promise_capability, get_iterator(global_object, vm.argument(0)));
  290. // 7. Let result be PerformPromiseAll(iteratorRecord, C, promiseCapability, promiseResolve).
  291. auto result = perform_promise_all(global_object, *iterator_record, constructor, promise_capability, promise_resolve);
  292. // 8. If result is an abrupt completion, then
  293. if (result.is_error()) {
  294. // a. If iteratorRecord.[[Done]] is false, set result to IteratorClose(iteratorRecord, result).
  295. if (!iterator_record_is_complete(global_object, *iterator_record))
  296. result = iterator_close(*iterator_record, result.release_error());
  297. // b. IfAbruptRejectPromise(result, promiseCapability).
  298. TRY_OR_REJECT(vm, promise_capability, result);
  299. }
  300. // 9. Return Completion(result).
  301. return result.release_value();
  302. }
  303. // 27.2.4.2 Promise.allSettled ( iterable ), https://tc39.es/ecma262/#sec-promise.allsettled
  304. JS_DEFINE_NATIVE_FUNCTION(PromiseConstructor::all_settled)
  305. {
  306. // 1. Let C be the this value.
  307. auto* constructor = TRY(vm.this_value(global_object).to_object(global_object));
  308. // 2. Let promiseCapability be ? NewPromiseCapability(C).
  309. auto promise_capability = TRY(new_promise_capability(global_object, constructor));
  310. // 3. Let promiseResolve be GetPromiseResolve(C).
  311. // 4. IfAbruptRejectPromise(promiseResolve, promiseCapability).
  312. auto promise_resolve = TRY_OR_REJECT(vm, promise_capability, get_promise_resolve(global_object, constructor));
  313. // 5. Let iteratorRecord be GetIterator(iterable).
  314. // 6. IfAbruptRejectPromise(iteratorRecord, promiseCapability).
  315. auto* iterator_record = TRY_OR_REJECT(vm, promise_capability, get_iterator(global_object, vm.argument(0)));
  316. // 7. Let result be PerformPromiseAllSettled(iteratorRecord, C, promiseCapability, promiseResolve).
  317. auto result = perform_promise_all_settled(global_object, *iterator_record, constructor, promise_capability, promise_resolve);
  318. // 8. If result is an abrupt completion, then
  319. if (result.is_error()) {
  320. // a. If iteratorRecord.[[Done]] is false, set result to IteratorClose(iteratorRecord, result).
  321. if (!iterator_record_is_complete(global_object, *iterator_record))
  322. result = iterator_close(*iterator_record, result.release_error());
  323. // b. IfAbruptRejectPromise(result, promiseCapability).
  324. TRY_OR_REJECT(vm, promise_capability, result);
  325. }
  326. // 9. Return Completion(result).
  327. return result.release_value();
  328. }
  329. // 27.2.4.3 Promise.any ( iterable ), https://tc39.es/ecma262/#sec-promise.any
  330. JS_DEFINE_NATIVE_FUNCTION(PromiseConstructor::any)
  331. {
  332. // 1. Let C be the this value.
  333. auto* constructor = TRY(vm.this_value(global_object).to_object(global_object));
  334. // 2. Let promiseCapability be ? NewPromiseCapability(C).
  335. auto promise_capability = TRY(new_promise_capability(global_object, constructor));
  336. // 3. Let promiseResolve be GetPromiseResolve(C).
  337. // 4. IfAbruptRejectPromise(promiseResolve, promiseCapability).
  338. auto promise_resolve = TRY_OR_REJECT(vm, promise_capability, get_promise_resolve(global_object, constructor));
  339. // 5. Let iteratorRecord be GetIterator(iterable).
  340. // 6. IfAbruptRejectPromise(iteratorRecord, promiseCapability).
  341. auto* iterator_record = TRY_OR_REJECT(vm, promise_capability, get_iterator(global_object, vm.argument(0)));
  342. // 7. Let result be PerformPromiseAny(iteratorRecord, C, promiseCapability, promiseResolve).
  343. auto result = perform_promise_any(global_object, *iterator_record, constructor, promise_capability, promise_resolve);
  344. // 8. If result is an abrupt completion, then
  345. if (result.is_error()) {
  346. // a. If iteratorRecord.[[Done]] is false, set result to IteratorClose(iteratorRecord, result).
  347. if (!iterator_record_is_complete(global_object, *iterator_record))
  348. result = iterator_close(*iterator_record, result.release_error());
  349. // b. IfAbruptRejectPromise(result, promiseCapability).
  350. TRY_OR_REJECT(vm, promise_capability, result);
  351. }
  352. // 9. Return Completion(result).
  353. return result.release_value();
  354. }
  355. // 27.2.4.5 Promise.race ( iterable ), https://tc39.es/ecma262/#sec-promise.race
  356. JS_DEFINE_NATIVE_FUNCTION(PromiseConstructor::race)
  357. {
  358. // 1. Let C be the this value.
  359. auto* constructor = TRY(vm.this_value(global_object).to_object(global_object));
  360. // 2. Let promiseCapability be ? NewPromiseCapability(C).
  361. auto promise_capability = TRY(new_promise_capability(global_object, constructor));
  362. // 3. Let promiseResolve be GetPromiseResolve(C).
  363. // 4. IfAbruptRejectPromise(promiseResolve, promiseCapability).
  364. auto promise_resolve = TRY_OR_REJECT(vm, promise_capability, get_promise_resolve(global_object, constructor));
  365. // 5. Let iteratorRecord be GetIterator(iterable).
  366. // 6. IfAbruptRejectPromise(iteratorRecord, promiseCapability).
  367. auto* iterator_record = TRY_OR_REJECT(vm, promise_capability, get_iterator(global_object, vm.argument(0)));
  368. // 7. Let result be PerformPromiseRace(iteratorRecord, C, promiseCapability, promiseResolve).
  369. auto result = perform_promise_race(global_object, *iterator_record, constructor, promise_capability, promise_resolve);
  370. // 8. If result is an abrupt completion, then
  371. if (result.is_error()) {
  372. // a. If iteratorRecord.[[Done]] is false, set result to IteratorClose(iteratorRecord, result).
  373. if (!iterator_record_is_complete(global_object, *iterator_record))
  374. result = iterator_close(*iterator_record, result.release_error());
  375. // b. IfAbruptRejectPromise(result, promiseCapability).
  376. TRY_OR_REJECT(vm, promise_capability, result);
  377. }
  378. // 9. Return Completion(result).
  379. return result.release_value();
  380. }
  381. // 27.2.4.6 Promise.reject ( r ), https://tc39.es/ecma262/#sec-promise.reject
  382. JS_DEFINE_NATIVE_FUNCTION(PromiseConstructor::reject)
  383. {
  384. auto reason = vm.argument(0);
  385. // 1. Let C be the this value.
  386. auto* constructor = TRY(vm.this_value(global_object).to_object(global_object));
  387. // 2. Let promiseCapability be ? NewPromiseCapability(C).
  388. auto promise_capability = TRY(new_promise_capability(global_object, constructor));
  389. // 3. Perform ? Call(promiseCapability.[[Reject]], undefined, « r »).
  390. [[maybe_unused]] auto result = TRY(vm.call(*promise_capability.reject, js_undefined(), reason));
  391. // 4. Return promiseCapability.[[Promise]].
  392. return promise_capability.promise;
  393. }
  394. // 27.2.4.7 Promise.resolve ( x ), https://tc39.es/ecma262/#sec-promise.resolve
  395. JS_DEFINE_NATIVE_FUNCTION(PromiseConstructor::resolve)
  396. {
  397. auto value = vm.argument(0);
  398. // 1. Let C be the this value.
  399. auto constructor = vm.this_value(global_object);
  400. // 2. If Type(C) is not Object, throw a TypeError exception.
  401. if (!constructor.is_object())
  402. return vm.throw_completion<TypeError>(global_object, ErrorType::NotAnObject, constructor.to_string_without_side_effects());
  403. // 3. Return ? PromiseResolve(C, x).
  404. return TRY(promise_resolve(global_object, constructor.as_object(), value));
  405. }
  406. // 27.2.4.8 get Promise [ @@species ], https://tc39.es/ecma262/#sec-get-promise-@@species
  407. JS_DEFINE_NATIVE_FUNCTION(PromiseConstructor::symbol_species_getter)
  408. {
  409. // 1. Return the this value.
  410. return vm.this_value(global_object);
  411. }
  412. }