CyclicModule.cpp 28 KB

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