CyclicModule.cpp 28 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661
  1. /*
  2. * Copyright (c) 2022, David Tuin <davidot@serenityos.org>
  3. *
  4. * SPDX-License-Identifier: BSD-2-Clause
  5. */
  6. #include <LibJS/CyclicModule.h>
  7. #include <LibJS/Runtime/PromiseConstructor.h>
  8. #include <LibJS/Runtime/PromiseReaction.h>
  9. namespace JS {
  10. CyclicModule::CyclicModule(Realm& realm, StringView filename, bool has_top_level_await, Vector<ModuleRequest> requested_modules)
  11. : Module(realm, filename)
  12. , m_requested_modules(move(requested_modules))
  13. , m_has_top_level_await(has_top_level_await)
  14. {
  15. }
  16. // 16.2.1.5.1 Link ( ), https://tc39.es/ecma262/#sec-moduledeclarationlinking
  17. ThrowCompletionOr<void> CyclicModule::link(VM& vm)
  18. {
  19. dbgln_if(JS_MODULE_DEBUG, "[JS MODULE] link[{}]()", this);
  20. // 1. Assert: module.[[Status]] is not linking or evaluating.
  21. VERIFY(m_status != ModuleStatus::Linking && m_status != ModuleStatus::Evaluating);
  22. // 2. Let stack be a new empty List.
  23. Vector<Module*> stack;
  24. // 3. Let result be Completion(InnerModuleLinking(module, stack, 0)).
  25. auto result = inner_module_linking(vm, stack, 0);
  26. // 4. If result is an abrupt completion, then
  27. if (result.is_throw_completion()) {
  28. // a. For each Cyclic Module Record m of stack, do
  29. for (auto* module : stack) {
  30. if (is<CyclicModule>(module)) {
  31. auto& cyclic_module = static_cast<CyclicModule&>(*module);
  32. // i. Assert: m.[[Status]] is linking.
  33. VERIFY(cyclic_module.m_status == ModuleStatus::Linking);
  34. // ii. Set m.[[Status]] to unlinked.
  35. cyclic_module.m_status = ModuleStatus::Unlinked;
  36. }
  37. }
  38. // b. Assert: module.[[Status]] is unlinked.
  39. VERIFY(m_status == ModuleStatus::Unlinked);
  40. // c. Return result.
  41. return result.release_error();
  42. }
  43. // 5. Assert: module.[[Status]] is linked, evaluating-async, or evaluated.
  44. VERIFY(m_status == ModuleStatus::Linked || m_status == ModuleStatus::EvaluatingAsync || m_status == ModuleStatus::Evaluated);
  45. // 6. Assert: stack is empty.
  46. VERIFY(stack.is_empty());
  47. // 7. Return unused.
  48. return {};
  49. }
  50. // 16.2.1.5.1.1 InnerModuleLinking ( module, stack, index ), https://tc39.es/ecma262/#sec-InnerModuleLinking
  51. ThrowCompletionOr<u32> CyclicModule::inner_module_linking(VM& vm, Vector<Module*>& stack, u32 index)
  52. {
  53. // 1. If module is not a Cyclic Module Record, then
  54. // a. Perform ? module.Link().
  55. // b. Return index.
  56. // Note: Step 1, 1.a and 1.b are handled in Module.cpp
  57. dbgln_if(JS_MODULE_DEBUG, "[JS MODULE] inner_module_linking[{}](vm, {}, {})", this, String::join(',', stack), index);
  58. // 2. If module.[[Status]] is linking, linked, evaluating-async, or evaluated, then
  59. if (m_status == ModuleStatus::Linking || m_status == ModuleStatus::Linked || m_status == ModuleStatus::EvaluatingAsync || m_status == ModuleStatus::Evaluated) {
  60. // a. Return index.
  61. return index;
  62. }
  63. // 3. Assert: module.[[Status]] is unlinked.
  64. VERIFY(m_status == ModuleStatus::Unlinked);
  65. // 4. Set module.[[Status]] to linking.
  66. m_status = ModuleStatus::Linking;
  67. // 5. Set module.[[DFSIndex]] to index.
  68. m_dfs_index = index;
  69. // 6. Set module.[[DFSAncestorIndex]] to index.
  70. m_dfs_ancestor_index = index;
  71. // 7. Set index to index + 1.
  72. ++index;
  73. // 8. Append module to stack.
  74. stack.append(this);
  75. #if JS_MODULE_DEBUG
  76. StringBuilder request_module_names;
  77. for (auto& module_request : m_requested_modules) {
  78. request_module_names.append(module_request.module_specifier);
  79. request_module_names.append(", "sv);
  80. }
  81. dbgln_if(JS_MODULE_DEBUG, "[JS MODULE] module: {} has requested modules: [{}]", filename(), request_module_names.string_view());
  82. #endif
  83. // 9. For each String required of module.[[RequestedModules]], do
  84. for (auto& required_string : m_requested_modules) {
  85. ModuleRequest required { required_string };
  86. // a. Let requiredModule be ? HostResolveImportedModule(module, required).
  87. auto required_module = TRY(vm.host_resolve_imported_module(this->make_weak_ptr(), required));
  88. // b. Set index to ? InnerModuleLinking(requiredModule, stack, index).
  89. index = TRY(required_module->inner_module_linking(vm, stack, index));
  90. // c. If requiredModule is a Cyclic Module Record, then
  91. if (is<CyclicModule>(*required_module)) {
  92. auto& cyclic_module = static_cast<CyclicModule&>(*required_module);
  93. // i. Assert: requiredModule.[[Status]] is either linking, linked, evaluating-async, or evaluated.
  94. VERIFY(cyclic_module.m_status == ModuleStatus::Linking || cyclic_module.m_status == ModuleStatus::Linked || cyclic_module.m_status == ModuleStatus::EvaluatingAsync || cyclic_module.m_status == ModuleStatus::Evaluated);
  95. // ii. Assert: requiredModule.[[Status]] is linking if and only if requiredModule is in stack.
  96. VERIFY((cyclic_module.m_status == ModuleStatus::Linking) == (stack.contains_slow(&cyclic_module)));
  97. // iii. If requiredModule.[[Status]] is linking, then
  98. if (cyclic_module.m_status == ModuleStatus::Linking) {
  99. // 1. Set module.[[DFSAncestorIndex]] to min(module.[[DFSAncestorIndex]], requiredModule.[[DFSAncestorIndex]]).
  100. m_dfs_ancestor_index = min(m_dfs_ancestor_index.value(), cyclic_module.m_dfs_ancestor_index.value());
  101. }
  102. }
  103. }
  104. // 10. Perform ? module.InitializeEnvironment().
  105. TRY(initialize_environment(vm));
  106. // 11. Assert: module occurs exactly once in stack.
  107. size_t count = 0;
  108. for (auto* module : stack) {
  109. if (module == this)
  110. count++;
  111. }
  112. VERIFY(count == 1);
  113. // 12. Assert: module.[[DFSAncestorIndex]] ≤ module.[[DFSIndex]].
  114. VERIFY(m_dfs_ancestor_index.value() <= m_dfs_index.value());
  115. dbgln_if(JS_MODULE_DEBUG, "[JS MODULE] module {} after inner_linking has dfs {} and ancestor dfs {}", filename(), m_dfs_index.value(), m_dfs_ancestor_index.value());
  116. // 13. If module.[[DFSAncestorIndex]] = module.[[DFSIndex]], then
  117. if (m_dfs_ancestor_index == m_dfs_index) {
  118. // a. Let done be false.
  119. // b. Repeat, while done is false,
  120. while (true) {
  121. // i. Let requiredModule be the last element in stack.
  122. // ii. Remove the last element of stack.
  123. auto* required_module = stack.take_last();
  124. // iii. Assert: requiredModule is a Cyclic Module Record.
  125. VERIFY(is<CyclicModule>(*required_module));
  126. // iv. Set requiredModule.[[Status]] to linked.
  127. static_cast<CyclicModule&>(*required_module).m_status = ModuleStatus::Linked;
  128. // v. If requiredModule and module are the same Module Record, set done to true.
  129. if (required_module == this)
  130. break;
  131. }
  132. }
  133. // 14. Return index.
  134. return index;
  135. }
  136. // 16.2.1.5.2 Evaluate ( ), https://tc39.es/ecma262/#sec-moduleevaluation
  137. ThrowCompletionOr<Promise*> CyclicModule::evaluate(VM& vm)
  138. {
  139. dbgln_if(JS_MODULE_DEBUG, "[JS MODULE] evaluate[{}](vm)", this);
  140. // 1. Assert: This call to Evaluate is not happening at the same time as another call to Evaluate within the surrounding agent.
  141. // FIXME: Verify this somehow
  142. // 2. Assert: module.[[Status]] is linked, evaluating-async, or evaluated.
  143. VERIFY(m_status == ModuleStatus::Linked || m_status == ModuleStatus::EvaluatingAsync || m_status == ModuleStatus::Evaluated);
  144. // 3. If module.[[Status]] is evaluating-async or evaluated, set module to module.[[CycleRoot]].
  145. if (m_status == ModuleStatus::EvaluatingAsync || m_status == ModuleStatus::Evaluated) {
  146. // Note: This will continue this function with module.[[CycleRoot]]
  147. VERIFY(m_cycle_root && m_cycle_root->m_status == ModuleStatus::Linked && this != m_cycle_root);
  148. dbgln_if(JS_MODULE_DEBUG, "[JS MODULE] evaluate[{}](vm) deferring to cycle root at {}", this, m_cycle_root);
  149. return m_cycle_root->evaluate(vm);
  150. }
  151. // 4. If module.[[TopLevelCapability]] is not empty, then
  152. if (m_top_level_capability.has_value()) {
  153. // a. Return module.[[TopLevelCapability]].[[Promise]].
  154. VERIFY(is<Promise>(*m_top_level_capability->promise));
  155. return static_cast<Promise*>(m_top_level_capability->promise);
  156. }
  157. // 5. Let stack be a new empty List.
  158. Vector<Module*> stack;
  159. auto& global_object = realm().global_object();
  160. // 6. Let capability be ! NewPromiseCapability(%Promise%).
  161. // 7. Set module.[[TopLevelCapability]] to capability.
  162. m_top_level_capability = MUST(new_promise_capability(vm, global_object.promise_constructor()));
  163. // 8. Let result be Completion(InnerModuleEvaluation(module, stack, 0)).
  164. auto result = inner_module_evaluation(vm, stack, 0);
  165. // 9. If result is an abrupt completion, then
  166. if (result.is_throw_completion()) {
  167. VERIFY(!m_evaluation_error.is_error());
  168. // a. For each Cyclic Module Record m of stack, do
  169. for (auto* mod : stack) {
  170. if (!is<CyclicModule>(*mod))
  171. continue;
  172. auto& cyclic_module = static_cast<CyclicModule&>(*mod);
  173. // i. Assert: m.[[Status]] is evaluating.
  174. VERIFY(cyclic_module.m_status == ModuleStatus::Evaluating);
  175. // ii. Set m.[[Status]] to evaluated.
  176. cyclic_module.m_status = ModuleStatus::Evaluated;
  177. // iii. Set m.[[EvaluationError]] to result.
  178. cyclic_module.m_evaluation_error = result.throw_completion();
  179. }
  180. // b. Assert: module.[[Status]] is evaluated.
  181. VERIFY(m_status == ModuleStatus::Evaluated);
  182. // c. Assert: module.[[EvaluationError]] is result.
  183. VERIFY(m_evaluation_error.is_error() && same_value(*m_evaluation_error.throw_completion().value(), *result.throw_completion().value()));
  184. // d. Perform ! Call(capability.[[Reject]], undefined, « result.[[Value]] »).
  185. MUST(call(global_object, m_top_level_capability->reject, js_undefined(), *result.throw_completion().value()));
  186. }
  187. // 10. Else,
  188. else {
  189. // a. Assert: module.[[Status]] is evaluating-async or evaluated.
  190. VERIFY(m_status == ModuleStatus::EvaluatingAsync || m_status == ModuleStatus::Evaluated);
  191. // b. Assert: module.[[EvaluationError]] is empty.
  192. VERIFY(!m_evaluation_error.is_error());
  193. // c. If module.[[AsyncEvaluation]] is false, then
  194. if (!m_async_evaluation) {
  195. // i. Assert: module.[[Status]] is evaluated.
  196. VERIFY(m_status == ModuleStatus::Evaluated);
  197. // ii. Perform ! Call(capability.[[Resolve]], undefined, « undefined »).
  198. MUST(call(global_object, m_top_level_capability->resolve, js_undefined(), js_undefined()));
  199. }
  200. // d. Assert: stack is empty.
  201. VERIFY(stack.is_empty());
  202. }
  203. // 11. Return capability.[[Promise]].
  204. VERIFY(is<Promise>(*m_top_level_capability->promise));
  205. return static_cast<Promise*>(m_top_level_capability->promise);
  206. }
  207. // 16.2.1.5.2.1 InnerModuleEvaluation ( module, stack, index ), https://tc39.es/ecma262/#sec-innermoduleevaluation
  208. ThrowCompletionOr<u32> CyclicModule::inner_module_evaluation(VM& vm, Vector<Module*>& stack, u32 index)
  209. {
  210. dbgln_if(JS_MODULE_DEBUG, "[JS MODULE] inner_module_evaluation[{}](vm, {}, {})", this, String::join(", "sv, stack), index);
  211. // Note: Step 1 is performed in Module.cpp
  212. // 2. If module.[[Status]] is evaluating-async or evaluated, then
  213. if (m_status == ModuleStatus::EvaluatingAsync || m_status == ModuleStatus::Evaluated) {
  214. // a. If module.[[EvaluationError]] is empty, return index.
  215. if (!m_evaluation_error.is_error())
  216. return index;
  217. // b. Otherwise, return ? module.[[EvaluationError]].
  218. return m_evaluation_error.throw_completion();
  219. }
  220. // 3. If module.[[Status]] is evaluating, return index.
  221. if (m_status == ModuleStatus::Evaluating)
  222. return index;
  223. // 4. Assert: module.[[Status]] is linked.
  224. VERIFY(m_status == ModuleStatus::Linked);
  225. // 5. Set module.[[Status]] to evaluating.
  226. m_status = ModuleStatus::Evaluating;
  227. // 6. Set module.[[DFSIndex]] to index.
  228. m_dfs_index = index;
  229. // 7. Set module.[[DFSAncestorIndex]] to index.
  230. m_dfs_ancestor_index = index;
  231. // 8. Set module.[[PendingAsyncDependencies]] to 0.
  232. m_pending_async_dependencies = 0;
  233. // 9. Set index to index + 1.
  234. ++index;
  235. // 10. Append module to stack.
  236. stack.append(this);
  237. // 11. For each String required of module.[[RequestedModules]], do
  238. for (auto& required : m_requested_modules) {
  239. // a. Let requiredModule be ! HostResolveImportedModule(module, required).
  240. auto* required_module = MUST(vm.host_resolve_imported_module(this->make_weak_ptr(), required)).ptr();
  241. // b. NOTE: Link must be completed successfully prior to invoking this method, so every requested module is guaranteed to resolve successfully.
  242. // c. Set index to ? InnerModuleEvaluation(requiredModule, stack, index).
  243. index = TRY(required_module->inner_module_evaluation(vm, stack, index));
  244. // d. If requiredModule is a Cyclic Module Record, then
  245. if (!is<CyclicModule>(*required_module))
  246. continue;
  247. auto* cyclic_module = static_cast<CyclicModule*>(required_module);
  248. // i. Assert: requiredModule.[[Status]] is either evaluating, evaluating-async, or evaluated.
  249. VERIFY(cyclic_module->m_status == ModuleStatus::Evaluating || cyclic_module->m_status == ModuleStatus::EvaluatingAsync || cyclic_module->m_status == ModuleStatus::Evaluated);
  250. // ii. Assert: requiredModule.[[Status]] is evaluating if and only if requiredModule is in stack.
  251. VERIFY(cyclic_module->m_status != ModuleStatus::Evaluating || stack.contains_slow(cyclic_module));
  252. // iii. If requiredModule.[[Status]] is evaluating, then
  253. if (cyclic_module->m_status == ModuleStatus::Evaluating) {
  254. // 1. Set module.[[DFSAncestorIndex]] to min(module.[[DFSAncestorIndex]], requiredModule.[[DFSAncestorIndex]]).
  255. m_dfs_ancestor_index = min(m_dfs_ancestor_index.value(), cyclic_module->m_dfs_ancestor_index.value());
  256. }
  257. // iv. Else,
  258. else {
  259. // 1. Set requiredModule to requiredModule.[[CycleRoot]].
  260. cyclic_module = cyclic_module->m_cycle_root;
  261. // 2. Assert: requiredModule.[[Status]] is evaluating-async or evaluated.
  262. VERIFY(cyclic_module->m_status == ModuleStatus::EvaluatingAsync || cyclic_module->m_status == ModuleStatus::Evaluated);
  263. // 3. If requiredModule.[[EvaluationError]] is not empty, return ? requiredModule.[[EvaluationError]].
  264. if (cyclic_module->m_evaluation_error.is_error())
  265. return cyclic_module->m_evaluation_error.throw_completion();
  266. }
  267. // v. If requiredModule.[[AsyncEvaluation]] is true, then
  268. if (cyclic_module->m_async_evaluation) {
  269. // 1. Set module.[[PendingAsyncDependencies]] to module.[[PendingAsyncDependencies]] + 1.
  270. ++m_pending_async_dependencies.value();
  271. // 2. Append module to requiredModule.[[AsyncParentModules]].
  272. cyclic_module->m_async_parent_modules.append(this);
  273. }
  274. }
  275. dbgln_if(JS_MODULE_DEBUG, "[JS MODULE] inner_module_evaluation on {} has tla: {} and pending async dep: {} dfs: {} ancestor dfs: {}", filename(), m_has_top_level_await, m_pending_async_dependencies.value(), m_dfs_index.value(), m_dfs_ancestor_index.value());
  276. // 12. If module.[[PendingAsyncDependencies]] > 0 or module.[[HasTLA]] is true, then
  277. if (m_pending_async_dependencies.value() > 0 || m_has_top_level_await) {
  278. // a. Assert: module.[[AsyncEvaluation]] is false and was never previously set to true.
  279. VERIFY(!m_async_evaluation); // FIXME: I don't think we can check previously?
  280. // b. Set module.[[AsyncEvaluation]] to true.
  281. m_async_evaluation = true;
  282. // c. NOTE: The order in which module records have their [[AsyncEvaluation]] fields transition to true is significant. (See 16.2.1.5.2.4.)
  283. // d. If module.[[PendingAsyncDependencies]] is 0, perform ExecuteAsyncModule(module).
  284. if (m_pending_async_dependencies.value() == 0)
  285. execute_async_module(vm);
  286. }
  287. // 13. Otherwise, perform ? module.ExecuteModule().
  288. else {
  289. TRY(execute_module(vm));
  290. }
  291. // 14. Assert: module occurs exactly once in stack.
  292. auto count = 0;
  293. for (auto* module : stack) {
  294. if (module == this)
  295. count++;
  296. }
  297. VERIFY(count == 1);
  298. // 15. Assert: module.[[DFSAncestorIndex]] ≤ module.[[DFSIndex]].
  299. VERIFY(m_dfs_ancestor_index.value() <= m_dfs_index.value());
  300. // 16. If module.[[DFSAncestorIndex]] = module.[[DFSIndex]], then
  301. if (m_dfs_ancestor_index == m_dfs_index) {
  302. // a. Let done be false.
  303. bool done = false;
  304. // b. Repeat, while done is false,
  305. while (!done) {
  306. // i. Let requiredModule be the last element in stack.
  307. // ii. Remove the last element of stack.
  308. auto* required_module = stack.take_last();
  309. // iii. Assert: requiredModule is a Cyclic Module Record.
  310. VERIFY(is<CyclicModule>(*required_module));
  311. auto& cyclic_module = static_cast<CyclicModule&>(*required_module);
  312. // iv. If requiredModule.[[AsyncEvaluation]] is false, set requiredModule.[[Status]] to evaluated.
  313. if (!cyclic_module.m_async_evaluation)
  314. cyclic_module.m_status = ModuleStatus::Evaluated;
  315. // v. Otherwise, set requiredModule.[[Status]] to evaluating-async.
  316. else
  317. cyclic_module.m_status = ModuleStatus::EvaluatingAsync;
  318. // vi. If requiredModule and module are the same Module Record, set done to true.
  319. if (required_module == this)
  320. done = true;
  321. // vii. Set requiredModule.[[CycleRoot]] to module.
  322. cyclic_module.m_cycle_root = this;
  323. }
  324. }
  325. // 17. Return index.
  326. return index;
  327. }
  328. ThrowCompletionOr<void> CyclicModule::initialize_environment(VM&)
  329. {
  330. // Note: In ecma262 this is never called on a cyclic module only on SourceTextModules.
  331. // So this check is to make sure we don't accidentally call this.
  332. VERIFY_NOT_REACHED();
  333. }
  334. ThrowCompletionOr<void> CyclicModule::execute_module(VM&, Optional<PromiseCapability>)
  335. {
  336. // Note: In ecma262 this is never called on a cyclic module only on SourceTextModules.
  337. // So this check is to make sure we don't accidentally call this.
  338. VERIFY_NOT_REACHED();
  339. }
  340. // 16.2.1.5.2.2 ExecuteAsyncModule ( module ), https://tc39.es/ecma262/#sec-execute-async-module
  341. void CyclicModule::execute_async_module(VM& vm)
  342. {
  343. auto& global_object = realm().global_object();
  344. auto& realm = *global_object.associated_realm();
  345. dbgln_if(JS_MODULE_DEBUG, "[JS MODULE] executing async module {}", filename());
  346. // 1. Assert: module.[[Status]] is evaluating or evaluating-async.
  347. VERIFY(m_status == ModuleStatus::Evaluating || m_status == ModuleStatus::EvaluatingAsync);
  348. // 2. Assert: module.[[HasTLA]] is true.
  349. VERIFY(m_has_top_level_await);
  350. // 3. Let capability be ! NewPromiseCapability(%Promise%).
  351. auto capability = MUST(new_promise_capability(vm, global_object.promise_constructor()));
  352. // 4. Let fulfilledClosure be a new Abstract Closure with no parameters that captures module and performs the following steps when called:
  353. auto fulfilled_closure = [&](VM& vm, GlobalObject&) -> ThrowCompletionOr<Value> {
  354. // a. Perform AsyncModuleExecutionFulfilled(module).
  355. async_module_execution_fulfilled(vm);
  356. // b. Return undefined.
  357. return js_undefined();
  358. };
  359. // 5. Let onFulfilled be CreateBuiltinFunction(fulfilledClosure, 0, "", « »).
  360. auto* on_fulfilled = NativeFunction::create(realm, move(fulfilled_closure), 0, "");
  361. // 6. Let rejectedClosure be a new Abstract Closure with parameters (error) that captures module and performs the following steps when called:
  362. auto rejected_closure = [&](VM& vm, GlobalObject&) -> ThrowCompletionOr<Value> {
  363. auto error = vm.argument(0);
  364. // a. Perform AsyncModuleExecutionRejected(module, error).
  365. async_module_execution_rejected(vm, error);
  366. // b. Return undefined.
  367. return js_undefined();
  368. };
  369. // 7. Let onRejected be CreateBuiltinFunction(rejectedClosure, 0, "", « »).
  370. auto* on_rejected = NativeFunction::create(realm, move(rejected_closure), 0, "");
  371. VERIFY(is<Promise>(*capability.promise));
  372. // 8. Perform PerformPromiseThen(capability.[[Promise]], onFulfilled, onRejected).
  373. static_cast<Promise*>(capability.promise)->perform_then(on_fulfilled, on_rejected, {});
  374. // 9. Perform ! module.ExecuteModule(capability).
  375. MUST(execute_module(vm, capability));
  376. // 10. Return unused.
  377. }
  378. // 16.2.1.5.2.3 GatherAvailableAncestors ( module, execList ), https://tc39.es/ecma262/#sec-gather-available-ancestors
  379. void CyclicModule::gather_available_ancestors(Vector<CyclicModule*>& exec_list)
  380. {
  381. // 1. For each Cyclic Module Record m of module.[[AsyncParentModules]], do
  382. for (auto* module : m_async_parent_modules) {
  383. // a. If execList does not contain m and m.[[CycleRoot]].[[EvaluationError]] is empty, then
  384. if (!exec_list.contains_slow(module) && !module->m_cycle_root->m_evaluation_error.is_error()) {
  385. // i. Assert: m.[[Status]] is evaluating-async.
  386. VERIFY(module->m_status == ModuleStatus::EvaluatingAsync);
  387. // ii. Assert: m.[[EvaluationError]] is empty.
  388. VERIFY(!module->m_evaluation_error.is_error());
  389. // iii. Assert: m.[[AsyncEvaluation]] is true.
  390. VERIFY(module->m_async_evaluation);
  391. // iv. Assert: m.[[PendingAsyncDependencies]] > 0.
  392. VERIFY(module->m_pending_async_dependencies.value() > 0);
  393. // v. Set m.[[PendingAsyncDependencies]] to m.[[PendingAsyncDependencies]] - 1.
  394. module->m_pending_async_dependencies.value()--;
  395. // vi. If m.[[PendingAsyncDependencies]] = 0, then
  396. if (module->m_pending_async_dependencies.value() == 0) {
  397. // 1. Append m to execList.
  398. exec_list.append(module);
  399. // 2. If m.[[HasTLA]] is false, perform GatherAvailableAncestors(m, execList).
  400. if (!module->m_has_top_level_await)
  401. module->gather_available_ancestors(exec_list);
  402. }
  403. }
  404. }
  405. // 2. Return unused.
  406. }
  407. // 16.2.1.5.2.4 AsyncModuleExecutionFulfilled ( module ), https://tc39.es/ecma262/#sec-async-module-execution-fulfilled
  408. void CyclicModule::async_module_execution_fulfilled(VM& vm)
  409. {
  410. // 1. If module.[[Status]] is evaluated, then
  411. if (m_status == ModuleStatus::Evaluated) {
  412. // a. Assert: module.[[EvaluationError]] is not empty.
  413. VERIFY(m_evaluation_error.is_error());
  414. // b. Return unused.
  415. return;
  416. }
  417. // 2. Assert: module.[[Status]] is evaluating-async.
  418. VERIFY(m_status == ModuleStatus::EvaluatingAsync);
  419. // 3. Assert: module.[[AsyncEvaluation]] is true.
  420. VERIFY(m_async_evaluation);
  421. // 4. Assert: module.[[EvaluationError]] is empty.
  422. VERIFY(!m_evaluation_error.is_error());
  423. // 5. Set module.[[AsyncEvaluation]] to false.
  424. m_async_evaluation = false;
  425. // 6. Set module.[[Status]] to evaluated.
  426. m_status = ModuleStatus::Evaluated;
  427. // 7. If module.[[TopLevelCapability]] is not empty, then
  428. if (m_top_level_capability.has_value()) {
  429. // a. Assert: module.[[CycleRoot]] is module.
  430. VERIFY(m_cycle_root == this);
  431. VERIFY(vm.current_realm());
  432. // b. Perform ! Call(module.[[TopLevelCapability]].[[Resolve]], undefined, « undefined »).
  433. MUST(call(vm.current_realm()->global_object(), m_top_level_capability->resolve, js_undefined(), js_undefined()));
  434. }
  435. // 8. Let execList be a new empty List.
  436. Vector<CyclicModule*> exec_list;
  437. // 9. Perform GatherAvailableAncestors(module, execList).
  438. gather_available_ancestors(exec_list);
  439. // 10. Let sortedExecList be a List whose elements are the elements of execList, in the order in which they had their [[AsyncEvaluation]] fields set to true in InnerModuleEvaluation.
  440. // FIXME: Sort the list. To do this we need to use more than an Optional<bool> to track [[AsyncEvaluation]].
  441. // 11. Assert: All elements of sortedExecList have their [[AsyncEvaluation]] field set to true, [[PendingAsyncDependencies]] field set to 0, and [[EvaluationError]] field set to empty.
  442. VERIFY(all_of(exec_list, [&](CyclicModule* module) { return module->m_async_evaluation && module->m_pending_async_dependencies.value() == 0 && !module->m_evaluation_error.is_error(); }));
  443. // 12. For each Cyclic Module Record m of sortedExecList, do
  444. for (auto* module : exec_list) {
  445. // a. If m.[[Status]] is evaluated, then
  446. if (module->m_status == ModuleStatus::Evaluated) {
  447. // i. Assert: m.[[EvaluationError]] is not empty.
  448. VERIFY(module->m_evaluation_error.is_error());
  449. }
  450. // b. Else if m.[[HasTLA]] is true, then
  451. else if (module->m_has_top_level_await) {
  452. // i. Perform ExecuteAsyncModule(m).
  453. module->execute_async_module(vm);
  454. }
  455. // c. Else,
  456. else {
  457. // i. Let result be m.ExecuteModule().
  458. auto result = module->execute_module(vm);
  459. // ii. If result is an abrupt completion, then
  460. if (result.is_throw_completion()) {
  461. // 1. Perform AsyncModuleExecutionRejected(m, result.[[Value]]).
  462. module->async_module_execution_rejected(vm, *result.throw_completion().value());
  463. }
  464. // iii. Else,
  465. else {
  466. // 1. Set m.[[Status]] to evaluated.
  467. module->m_status = ModuleStatus::Evaluated;
  468. // 2. If m.[[TopLevelCapability]] is not empty, then
  469. if (module->m_top_level_capability.has_value()) {
  470. // a. Assert: m.[[CycleRoot]] is m.
  471. VERIFY(module->m_cycle_root == module);
  472. VERIFY(vm.current_realm());
  473. // b. Perform ! Call(m.[[TopLevelCapability]].[[Resolve]], undefined, « undefined »).
  474. MUST(call(vm.current_realm()->global_object(), module->m_top_level_capability->resolve, js_undefined(), js_undefined()));
  475. }
  476. }
  477. }
  478. }
  479. // 13. Return unused.
  480. }
  481. // 16.2.1.5.2.5 AsyncModuleExecutionRejected ( module, error ), https://tc39.es/ecma262/#sec-async-module-execution-rejected
  482. void CyclicModule::async_module_execution_rejected(VM& vm, Value error)
  483. {
  484. // 1. If module.[[Status]] is evaluated, then
  485. if (m_status == ModuleStatus::Evaluated) {
  486. // a. Assert: module.[[EvaluationError]] is not empty.
  487. VERIFY(m_evaluation_error.is_error());
  488. // b. Return unused.
  489. return;
  490. }
  491. // 2. Assert: module.[[Status]] is evaluating-async.
  492. VERIFY(m_status == ModuleStatus::EvaluatingAsync);
  493. // 3. Assert: module.[[AsyncEvaluation]] is true.
  494. VERIFY(m_async_evaluation);
  495. // 4. Assert: module.[[EvaluationError]] is empty.
  496. VERIFY(!m_evaluation_error.is_error());
  497. // 5. Set module.[[EvaluationError]] to ThrowCompletion(error)
  498. m_evaluation_error = throw_completion(error);
  499. // 6. Set module.[[Status]] to evaluated.
  500. m_status = ModuleStatus::Evaluated;
  501. // 7. For each Cyclic Module Record m of module.[[AsyncParentModules]], do
  502. for (auto* module : m_async_parent_modules) {
  503. // a. Perform AsyncModuleExecutionRejected(m, error).
  504. module->async_module_execution_rejected(vm, error);
  505. }
  506. // 8. If module.[[TopLevelCapability]] is not empty, then
  507. if (m_top_level_capability.has_value()) {
  508. // a. Assert: module.[[CycleRoot]] is module.
  509. VERIFY(m_cycle_root == this);
  510. VERIFY(vm.current_realm());
  511. // b. Perform ! Call(module.[[TopLevelCapability]].[[Reject]], undefined, « error »).
  512. MUST(call(vm.current_realm()->global_object(), m_top_level_capability->reject, js_undefined(), error));
  513. }
  514. // 9. Return unused.
  515. }
  516. }