From 38c74d3114c71281aa73db82357a634052b626fa Mon Sep 17 00:00:00 2001
From: Joyee Cheung <joyeec9h3@gmail.com>
Date: Tue, 5 Mar 2024 17:05:51 +0100
Subject: [PATCH] src: add --print-pending-tla flag

---
 doc/api/cli.md      | 12 ++++++++++++
 src/node_options.cc |  7 +++++++
 src/node_options.h  |  1 +
 3 files changed, 20 insertions(+)

diff --git a/doc/api/cli.md b/doc/api/cli.md
index df90e9ae306b45..bdae4a7e771391 100644
--- a/doc/api/cli.md
+++ b/doc/api/cli.md
@@ -1578,6 +1578,17 @@ changes:
 
 Identical to `-e` but prints the result.
 
+### `--print-pending-tla`
+
+<!-- YAML
+added: REPLACEME
+-->
+
+Print pending top-level await in the graph.
+
+<!-- TODO(joyeecheung): do a PR separately for this flag because we can also
+fix https://github.com/nodejs/node/issues/42868 with it -->
+
 ### `--prof`
 
 <!-- YAML
@@ -2556,6 +2567,7 @@ Node.js options that are allowed are:
 * `--policy-integrity`
 * `--preserve-symlinks-main`
 * `--preserve-symlinks`
+* `--print-pending-tla`
 * `--prof-process`
 * `--redirect-warnings`
 * `--report-compact`
diff --git a/src/node_options.cc b/src/node_options.cc
index 65840ff1be6136..bf5265967fb1aa 100644
--- a/src/node_options.cc
+++ b/src/node_options.cc
@@ -352,6 +352,13 @@ EnvironmentOptionsParser::EnvironmentOptionsParser() {
             "ES module syntax, try again to evaluate them as ES modules",
             &EnvironmentOptions::detect_module,
             kAllowedInEnvvar);
+  AddOption("--print-pending-tla",
+            "Print pending top-level await. If --experimental-require-module "
+            "is true, evaluate asynchronous graphs loaded by `require()` but "
+            "do not run the microtasks, in order to to find and print "
+            "top-level await in the graph",
+            &EnvironmentOptions::print_pending_tla,
+            kAllowedInEnvvar);
   AddOption("--diagnostic-dir",
             "set dir for all output files"
             " (default: current working directory)",
diff --git a/src/node_options.h b/src/node_options.h
index 2f59f70f8ed60e..97aec1ec8b98d2 100644
--- a/src/node_options.h
+++ b/src/node_options.h
@@ -105,6 +105,7 @@ class EnvironmentOptions : public Options {
   bool abort_on_uncaught_exception = false;
   std::vector<std::string> conditions;
   bool detect_module = false;
+  bool print_pending_tla = false;
   std::string dns_result_order;
   bool enable_source_maps = false;
   bool experimental_fetch = true;