packages/babel-node/src/babel-node.ts - main - githubmirror/babel

packages/babel-node/src/babel-node.ts
176 строк5 KB
liuxingbaoyu
Enable `strictNullChecks` for more packages (#17828)
27 фев 2026, 20:06
27 фев 2026, 20:064fcbae7
/**
 * This tiny wrapper file checks for known node flags and appends them
 * when found, before invoking the "real" _babel-node(1) executable.
 */

import path from "node:path";
import child_process from "node:child_process";
import { fileURLToPath } from "node:url";
import getV8FlagsRaw from "v8flags";

import { splitArgs, nodeFlagsWithValue } from "./split-args.ts";
import { program } from "./program-setup.ts";

function getV8Flags(): Promise<(str: string) => boolean> {
  /**
   * Replace underscores with dashes in the v8Flag name
   * Also ensure that if the arg contains a value (e.g. --arg=true)
   * that only the flag is returned.
   */
  function getNormalizedV8Flag(arg: string) {
    // v8 uses the "no" prefix to negate boolean flags (e.g. --nolazy),
    // but they are not listed by v8flags
    const matches = /--(?:no)?(.+)/.exec(arg);

    if (matches) {
      return `--${matches[1].replace(/_/g, "-")}`;
    }

    return arg;
  }

  return new Promise((resolve, reject) => {
    getV8FlagsRaw((err: Error, flags: string[]) => {
      if (err) {
        reject(err);
        return;
      }

      const flagsSet = new Set(flags.map(getNormalizedV8Flag));
      resolve(
        test =>
          flagsSet.has(getNormalizedV8Flag(test)) ||
          process.allowedNodeEnvironmentFlags.has(test),
      );
    });
  });
}

const babelNodePath = path.join(
  path.dirname(fileURLToPath(import.meta.url)),
  "_babel-node",
);

(async () => {
  const babelOptions = new Set<string>([]);
  const babelOptionsWithValue = new Set<string>([]);
  for (const option of program.options) {
    const hasValue = option.flags.includes("[");
    if (option.short) {
      babelOptions.add(option.short);
      if (hasValue) babelOptionsWithValue.add(option.short);
    }
    if (option.long) {
      babelOptions.add(option.long);
      if (hasValue) babelOptionsWithValue.add(option.long);
    }
  }

  const { programArgs, fileName, userArgs, explicitSeparator } = splitArgs(
    process.argv.slice(2),
    babelOptionsWithValue,
  );

  const babelArgs: string[] = [];
  const nodeArgs: string[] = [];

  for (let i = 0; i < programArgs.length; i++) {
    const arg = programArgs[i];
    const list = babelOptions.has(arg.split("=")[0]) ? babelArgs : nodeArgs;
    list.push(arg);
    if (i + 1 < programArgs.length && !programArgs[i + 1].startsWith("-")) {
      list.push(programArgs[++i]);
    }
  }

  if (!explicitSeparator) {
    const isV8flag = await getV8Flags();

    const ambiguousArgsNames: string[] = [];
    const ambiguousArgs: string[] = [];
    let unambiguousArgs: string[] | null = null;
    for (let i = 0; i < userArgs.length; i++) {
      const [arg, value] = userArgs[i].split("=");
      if (babelOptions.has(arg) || isV8flag(arg)) {
        unambiguousArgs ??= userArgs.slice(0, i);
        ambiguousArgsNames.push(arg);
        ambiguousArgs.push(userArgs[i]);
        if (
          value === undefined &&
          (babelOptionsWithValue.has(arg) || nodeFlagsWithValue.has(arg)) &&
          i + 1 < userArgs.length
        ) {
          ambiguousArgs.push(userArgs[++i]);
        }
      } else {
        unambiguousArgs?.push(userArgs[i]);
      }
    }
    if (ambiguousArgsNames.length > 0) {
      const them = ambiguousArgsNames.length === 1 ? "it" : "them";
      const they = ambiguousArgsNames.length === 1 ? "it" : "they";
      const are = ambiguousArgsNames.length === 1 ? "is" : "are";
      console.warn(
        `Warning: ${ambiguousArgsNames.join(", ")} ${are} a valid option for Babel or Node.js, ` +
          `but ${they} ${are} defined after the script name. Up to Babel 7 ${they} would have ` +
          `been passed to Babel, while now ${they} ${are} passed to the script itself.\n` +
          `  If the intention is to pass ${them} to Babel, move ${them} before the filename:\n` +
          `    babel-node ${programArgs.join(" ")} ${ambiguousArgs.join(" ")} ${fileName} ${unambiguousArgs!.join(" ")}\n` +
          `  If passing ${them} to the script is intended, you can silence this warning by explicitly ` +
          `using the -- separator before the script name:\n` +
          `    babel-node ${programArgs.join(" ")} -- ${fileName} ${userArgs.join(" ")}`,
      );
    }
  }

  await spawn([
    ...nodeArgs,
    "--",
    babelNodePath,
    ...babelArgs,
    "--",
    fileName!,
    ...userArgs,
  ]);
})().catch(err => {
  console.error(err);
  process.exitCode = 1;
});

async function spawn(args: string[]) {
  try {
    // eslint-disable-next-line import/no-unresolved
    const { default: kexec } = await import("kexec");
    kexec(process.argv[0], args);
  } catch (err) {
    if (
      err.code !== "ERR_MODULE_NOT_FOUND" &&
      err.code !== "MODULE_NOT_FOUND" &&
      err.code !== "UNDECLARED_DEPENDENCY"
    ) {
      throw err;
    }

    // passthrough IPC only if babel-node itself has an IPC channel
    const shouldPassthroughIPC = process.send !== undefined;
    const proc = child_process.spawn(process.argv[0], args, {
      stdio: shouldPassthroughIPC
        ? ["inherit", "inherit", "inherit", "ipc"]
        : "inherit",
    });
    proc.on("exit", function (code, signal) {
      process.on("exit", function () {
        if (signal) {
          process.kill(process.pid, signal);
        } else {
          process.exitCode = code ?? undefined;
        }
      });
    });
    if (shouldPassthroughIPC) {
      proc.on("message", message => process.send!(message));
    }
    process.on("SIGINT", () => proc.kill("SIGINT"));
    process.on("SIGTERM", () => proc.kill("SIGTERM"));
  }
}