Skip to content

fix: print error when internal cli error happens (more helpful than ERROR: null) #5344

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 2 commits into
base: main
Choose a base branch
from

Conversation

Rob--W
Copy link
Contributor

@Rob--W Rob--W commented Apr 27, 2025

PR Checklist

Overview

There have been issues where the reported error is "ERROR: null", which is very unhelpful. Here is an analysis of a specific example: #5048 (comment)

Although the trigger for that error was fixed by #5074, the unhelpfulness of "ERROR: null" was not addressed.

To help with debugging, this patch prints the original error when this stage is unexpectedly reached.

There have been issues where the reported error is "ERROR: null", which
is very unhelpful. Here is an analysis of a specific example:
mochajs#5048 (comment)

Although the trigger for that error was fixed by mochajs#5074, the
unhelpfulness of "ERROR: null" was not addressed.

To help with debugging, this patch prints the original error when this
stage is unexpectedly reached.
Copy link

linux-foundation-easycla bot commented Apr 27, 2025

CLA Signed

The committers listed above are authorized under a signed CLA.

  • ✅ login: mark-wiemer / name: Mark Wiemer (7cda07e)
  • ✅ login: Rob--W / name: Rob Wu (dd88210)

@JoshuaKGoldberg
Copy link
Member

Switching to draft pending #5078 (comment). We can't review without a reproduction, and it might be that all buggy behavior was already fixed?

Thanks for the PR in the interim though!

@Rob--W
Copy link
Contributor Author

Rob--W commented May 1, 2025

Switching to draft pending #5078 (comment). We can't review without a reproduction, and it might be that all buggy behavior was already fixed?

For clarity, this is not about fixing whatever that triggered the error, but about improving the logged diagnostics information when an error (unexpectedly) happens.

While the specific trigger was fixed, it is still possible to end up in this case if some other internal error occurs. If you want to reproduce locally, you could throw an error from

console.error('\n Exception during run:', err);

There are probably other ways to trigger this issue, but I haven't looked.

If you are concerned about logging too much information (when an error message is already present), I could add a check to only log the error when the message is null.

@voxpelli voxpelli requested a review from Copilot June 12, 2025 07:45
Copy link

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR enhances error reporting in the CLI by printing the original error object to stderr when an internal error occurs, making the “ERROR: null” message more informative.

  • Prints the caught error object after showing help and the generic error message.
  • Exits with status code 1 after logging the full error.
Comments suppressed due to low confidence (1)

lib/cli/cli.js:64

  • Add a test case that simulates an internal CLI error to verify that the original error message (or stack) is printed as expected.
console.error(err);

@@ -61,6 +61,7 @@ exports.main = (argv = process.argv.slice(2), mochaArgs) => {
debug('caught error sometime before command handler: %O', err);
yargs.showHelp();
console.error(`\n${symbols.error} ${pc.red('ERROR:')} ${msg}`);
console.error(err);
Copy link
Preview

Copilot AI Jun 12, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Consider logging the error stack (e.g., console.error(err.stack || err)) instead of the error object itself to provide full context for debugging.

Suggested change
console.error(err);
console.error(err.stack || err);

Copilot uses AI. Check for mistakes.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

🐛 Bug: mocha 10.2.0 prints out command help text and ERROR: null when unexpected error in -r module occurs
3 participants