Add BABEL_7_TO_8_DANGEROUSLY_DISABLE_VERSION_CHECK (#17569)

nicolo-ribaudo · web-flow · commit d725e399fd6a · 2025-11-11T10:33:26.000-05:00
* Add `BABEL_ALLOW_VERSION_MISMATCH` to suppress version check

* update
diff --git a/packages/babel-core/src/config/helpers/config-api.ts b/packages/babel-core/src/config/helpers/config-api.ts
@@ -136,6 +136,23 @@ function assertVersion(range: string | number): void {
   // do not want ^7.0.0 to match 8.0.0-alpha.1.
   if (range === "*" || semver.satisfies(coreVersion, range)) return;
 
+  const message =
+    `Requires Babel "${range}", but was loaded with "${coreVersion}". ` +
+    `If you are sure you have a compatible version of @babel/core, ` +
+    `it is likely that something in your build process is loading the ` +
+    `wrong version. Inspect the stack trace of this error to look for ` +
+    `the first entry that doesn't mention "@babel/core" or "babel-core" ` +
+    `to see what is calling Babel.`;
+
+  if (
+    typeof process !== "undefined" &&
+    process.env.BABEL_8_BREAKING &&
+    process.env.BABEL_7_TO_8_DANGEROUSLY_DISABLE_VERSION_CHECK
+  ) {
+    console.warn(message);
+    return;
+  }
+
   const limit = Error.stackTraceLimit;
 
   if (typeof limit === "number" && limit < 25) {
@@ -144,14 +161,7 @@ function assertVersion(range: string | number): void {
     Error.stackTraceLimit = 25;
   }
 
-  const err = new Error(
-    `Requires Babel "${range}", but was loaded with "${coreVersion}". ` +
-      `If you are sure you have a compatible version of @babel/core, ` +
-      `it is likely that something in your build process is loading the ` +
-      `wrong version. Inspect the stack trace of this error to look for ` +
-      `the first entry that doesn't mention "@babel/core" or "babel-core" ` +
-      `to see what is calling Babel.`,
-  );
+  const err = new Error(message);
 
   if (typeof limit === "number") {
     Error.stackTraceLimit = limit;
