feat: add header overflow detection and user guidance for large HTTP headers

Author: shriyanss

CHANGELOG.md

@@ -14,6 +14,7 @@
 - Fix errors when the target is using a CDN
 - Fix "possible EventEmitter memory leak detected" error
 - Fix "Maximum call stack size exceeded" error in resolveNodeValue
+- Fix "UND_ERR_HEADERS_OVERFLOW" error
 
 ## 1.2.1-alpha.2 - 2025.08.06
 

Dockerfile

@@ -16,4 +16,5 @@ USER pptruser
 RUN npx puppeteer browsers install chrome
 
 ENV IS_DOCKER=true
+ENV NODE_OPTIONS="--max-http-header-size=99999999"
 ENTRYPOINT ["node", "build/index.js"]

src/utility/makeReq.ts

@@ -201,6 +201,19 @@ const makeRequest = async (url: string, args: RequestInit) => {
                 }
             } catch (err) {
                 counter++;
+                // BUG: https://github.com/nodejs/node/issues/47246
+                // if the header content is too large, it will throw an error like
+                // code: `UND_ERR_HEADERS_OVERFLOW`
+                // so, if this error happens, tell the user to fix it using setting the environment variables
+                // if this is docker, this will be increased by default
+                if (err.cause && err.cause.code === "UND_ERR_HEADERS_OVERFLOW") {
+                    console.log(
+                        chalk.yellow(
+                            `[!] The tool detected a header overflow. Please increase the limit by setting environment variable \`NODE_OPTIONS="--max-http-header-size=99999999"\`. If the error still persists, please try again with a higher limit.`
+                        )
+                    );
+                    process.exit(21);
+                }
                 if (counter > 10) {
                     console.log(chalk.red(`[!] Failed to fetch ${url} : ${err}`));
                     return null;