[ { "path": ".browserslistrc", "content": "node >= 14\nlast 2 Chrome versions\nlast 2 Edge versions\nlast 2 Firefox versions\nlast 2 Safari versions\nlast 2 Opera versions\nunreleased Chrome versions\nunreleased Edge versions\nunreleased Firefox versions\nunreleased Safari versions\nunreleased Opera versions\n" }, { "path": ".editorconfig", "content": "# This file is for unifying the coding style for different editors and IDEs\n# editorconfig.org\n\nroot = true\n\n[*]\nend_of_line = lf\ncharset = utf-8\ninsert_final_newline = true\ntrim_trailing_whitespace = true\nindent_style = space\nindent_size = 2\n" }, { "path": ".gitattributes", "content": "* text=auto eol=lf\n" }, { "path": ".github/CODE_OF_CONDUCT.md", "content": "# Mocha Code of Conduct\n\n## Be friendly and patient\n\nWe understand that everyone has different levels of experience or knowledge in many diverse fields, be it technical or\nnon-technical in nature.\nWe also have areas of knowledge we are eager to expand; we want to be a community where people can not only contribute, but feel comfortable to ask questions as well and learn along the way.\nIf someone says something wrong, or says something accidentally offensive, respond with patience and try to keep it polite and civil.\nRemember that we all were newbies at one point.\n\n## Be welcoming\n\nWe strive to be a community that welcomes and supports people of all backgrounds and identities.\nThis includes, but is not limited to, members of any race, ethnicity, culture, national origin, color, immigration status, social and economic class, educational level, sex, sexual orientation, gender identity and expression, age, size, family status, political belief, religion, and mental and physical ability.\n\n## Be considerate\n\nYour work will be used by other people, and you in turn will depend on the work of others.\nAny decision you make will affect users and colleagues, and you should take those consequences into account when making decisions.\nRemember that we’re a world-wide community, so you might not be communicating in someone else’s primary language.\n\n## Be respectful\n\nNot all of us will agree all the time, but disagreement is no excuse for poor behavior and poor manners.\nWe might all experience some frustration now and then, but we cannot allow that frustration to turn into a personal attack.\nIt’s important to remember that a community where people feel uncomfortable or threatened is not a productive one.\nMembers of the OpenJS Foundation community should be respectful when dealing with other members as well as with people outside the OpenJS Foundation community.\n\n## Be careful in the words that you choose\n\nWe are a community of professionals, and we conduct ourselves professionally.\nBe kind to others.\nDo not insult or put down other participants.\nHarassment and other exclusionary behavior aren’t acceptable.\nThis includes, but is not limited to:\n\n- Violent threats or language directed against another person.\n- Discriminatory jokes and language.\n- Posting sexually explicit or violent material.\n- Posting (or threatening to post) other people’s personally identifying information (“doxing”).\n- Personal insults, especially those using racist or sexist terms.\n- Unwelcome sexual attention.\n- Advocating for, or encouraging, any of the above behavior.\n- Repeated harassment of others.\n In general, if someone asks you to stop, then stop.\n\n## When we disagree, try to understand why\n\nDisagreements, both social and technical, happen all the time and OpenJS Foundation projects are no exception.\nIt is important that we resolve disagreements and differing views constructively.\nRemember that we’re different.\nThe strength of the OpenJS Foundation comes from its varied community, people from a wide range of backgrounds.\nDifferent people have different perspectives on issues.\nBeing unable to understand why someone holds a viewpoint doesn’t mean that they’re wrong.\nDon’t forget that it is human to err and blaming each other doesn’t get us anywhere.\nInstead, focus on helping to resolve issues and learning from mistakes.\n\nOriginal text courtesy of the Speak Up! project and Django Project.\n\n## QUESTIONS?\n\nIf you have questions, please see the FAQ.\nIf that doesn’t answer your questions, feel free to email .\n\n# OpenJS Foundation Code of Conduct\n\nThe OpenJS Foundation and its member projects use the Contributor Covenant v1.4.1 as its Code of Conduct.\nRefer to the following for the full text:\n\n- [Contributor Covenant v1.4.1 in english](https://www.contributor-covenant.org/version/1/4/code-of-conduct)\n- [Contributor Covenant v1.4.1 translations](https://www.contributor-covenant.org/translations)\n\nRefer to the section on reporting and escalation in this document for the specific emails that can be used to report and escalate issues.\n\n## Reporting\n\n### Project Spaces\n\nFor reporting issues in spaces related to a member project please use the email provided by the project for reporting.\nProjects handle CoC issues related to the spaces that they maintain.\nProjects maintainers commit to:\n\n- maintain the confidentiality with regard to the reporter of an incident\n- to participate in the path for escalation as outlined in\n the section on Escalation when required.\n\n### Foundation Spaces\n\nFor reporting issues in spaces managed by the OpenJS Foundation, for example, repositories within the OpenJS organization, use the email `report@lists.openjsf.org`.\nThe Cross Project Council (CPC) is responsible for managing these reports and commits to:\n\n- maintain the confidentiality with regard to the reporter of an incident\n- to participate in the path for escalation as outlined in\n the section on Escalation when required.\n\n## Escalation\n\nThe OpenJS Foundation maintains a Code of Conduct Panel (CoCP).\nThis is a foundation-wide team established to manage escalation when a reporter believes that a report to a member project or the CPC has not been properly handled.\nIn order to escalate to the CoCP send an email to `\"coc-escalation@lists.openjsf.org`.\n\nFor more information, refer to the full\n[Code of Conduct governance document](https://github.com/openjs-foundation/cross-project-council/tree/main/proposals/approved/CODE_OF_CONDUCT).\n" }, { "path": ".github/CONTRIBUTING.md", "content": "# Contributing to Mocha\n\n> Please read these guidelines before submitting an issue, filing a feature request, or contributing code.\n\n## ❓ Got a Question?\n\nIf you have a question about using Mocha, please use [StackOverflow](https://stackoverflow.com) or ask the friendly people in [our Discord](https://discord.gg/KeDn2uXhER).\n\n## ✏️ Filing Issues\n\nBefore adding anything to the issue tracker, **please [search issues](https://github.com/mochajs/mocha/issues) to see if it's already been reported**.\nMake sure to check closed and/or older issues as well.\n\nWith the exception of minor documentation typos, all changes to Mocha should be discussed in the issue tracker first.\nThis includes bugs, feature requests, and improvements to documentation.\n\n### 🐛 I Found a Bug\n\nSorry!\nIt happens to the best of us.\n\nPlease [file an issue using the bug report template](https://github.com/mochajs/mocha/issues/new?assignees=&labels=type%3A+bug&projects=&template=01-bug.yml&title=%F0%9F%90%9B+Bug%3A+%3Cshort+description+of+the+bug%3E) with _as much detail as possible_ to help us reproduce and diagnose the bug.\nMost importantly:\n\n- Let us know _how_ you're running Mocha (options, flags, environment, browser or Node.js, etc.).\n- Include your test code or file(s).\n If large, please provide a link to a repository or [gist](https://gist.github.com).\n\nIf we need more information from you, we'll let you know.\nIf you don't within a few weeks, your issue will be closed for inactivity.\n\n### ❗️ Propose a Change\n\nPlease [file an issue using the feature request template](https://github.com/mochajs/mocha/issues/new?assignees=&labels=type%3A+feature&projects=&template=03-feature-request.yml&title=%F0%9F%9A%80+Feature%3A+%3Cshort+description+of+the+feature%3E).\nMost importantly:\n\n- Let us know _what_ the proposed change is, in as much detail as you can\n- Explain _why_ you want the change\n- Include your test code or file(s).\n If large, please provide a link to a repository or [gist](https://gist.github.com).\n\nWe'll discuss your proposed changes and how they relate to the overarching goals of Mocha, detailed below in [⚽️ About Project Goals](#%EF%B8%8F-about-project-goals).\n\n## ⚽️ About Project Goals\n\nMocha is a test framework.\nDevelopers use it against anything from legacy spaghetti in barely-supported browsers to stage-0 TC39 features in Electron.\nMocha is committed to providing support for maintained (LTS) versions of Node.js and popular browsers.\n\nMocha adheres strictly to [semantic versioning](https://semver.org).\nWe are _extremely cautious_ with changes that have the potential to break; given the size of Mocha's user base, it's _highly unlikely_ a breaking change will slide by.\n\nMocha's usage far outweighs its resources.\nIf a proposed feature would incur a maintenance penalty, it could be a hard sell.\n\nWe ask you please keep these goals in mind when making or proposing changes.\n\n## 😇 I Just Want To Help\n\n_Excellent._ Here's how:\n\n- **Handy with JavaScript?** Please check out the issues labeled [`status: accepting prs`](https://github.com/mochajs/mocha/issues?q=is%3Aissue+is%3Aopen+label%3A%22status%3A+accepting+prs%22) or [`good first issue`](https://github.com/mochajs/mocha/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22+).\n Try `npx good-first-issue mocha`!\n- **Can you write ~~good~~ well?** The [documentation](https://mochajs.org) almost always needs some love.\n See the [doc-related issues](https://github.com/mochajs/mocha/issues?q=is%3Aopen+is%3Aissue+label%3A%22area%3A+documentation%22).\n- **Design your thing?** [Our site](https://mochajs.org) needs your magic touch.\n- **Familiar with Mocha's codebase?** We could use your help triaging issues and/or reviewing pull requests.\n Please contact an [org member](https://github.com/orgs/mochajs/people), and we'll chat.\n- **Want to build our community?** Mocha has a _lot_ of users.\n We could use your help bringing everyone together in peace and harmony.\n Please contact an [org member](https://github.com/orgs/mochajs/people).\n- **Do you write unit tests for _fun_?** A PR which increases coverage is unlikely to be turned down.\n- **Are you experienced?** 🎸 If you're a seasoned Mocha user, why not help answer some questions in [our Discord's `#help` channel](https://discord.gg/KeDn2uXhER)?\n\n## 🙋 Frequently Asked Questions\n\n### Can I work on this issue?\n\nAnyone can work on any issue marked `status: accepting prs` 🙂 Please check if there is already a PR for this issue, and if it's still being worked on. If it hasn't been updated for over a week, you're welcome to open your own PR and we'll review it when we can!\n\n## 👞 Contributing Code: Step-by-Step\n\nFirst follow the steps in [DEVELOPMENT.md](./DEVELOPMENT.md) to get Mocha's repository installed locally.\nThen:\n\n### 🎋 Initial Creation\n\n1. Make sure the issue is labeled with [`status: accepting prs`](https://github.com/mochajs/mocha/issues?q=is%3Aissue+is%3Aopen+label%3A%22status%3A+accepting+prs%22)\n1. Create a new branch in your working copy.\n1. Make your changes and add them via `git add`.\n - Your changes will likely be somewhere in `lib/`, `bin/`, or (if your changes are browser-specific) `browser-entry.js`.\n - Unit and/or integration **tests are required** for any code change.\n These live in `test/`.\n - **Do not modify** the root `mocha.js` file directly; it is automatically generated.\n - Keep your PR focused.\n Don't fix two things at once; don't upgrade dependencies unless necessary.\n1. Before committing, run `npm test`.\n - This will run both Node.js-based and browser-based tests.\n - Ultimately, your pull request will be built on our continuous integration servers ([GitHub Actions](https://github.com/mochajs/mocha/actions?query=workflow%3A%22Tests%22)).\n The first step to ensuring these checks pass is to test on your own machine.\n - When tests are run in CI, a coverage check is sent to [Codecov](https://app.codecov.io/gh/mochajs/mocha). You'll need to [add the Codecov GitHub app](https://app.codecov.io/login) to upload these results from your fork. This is recommended but not necessary to open a PR.\n **A drop in code coverage % is considered a failed check**.\n1. Commit your changes.\n - Use a brief message on the first line, referencing a relevant issue (e.g. `closes #12345`).\n - Add detail in subsequent lines.\n - A pre-commit hook will run which automatically formats your staged changes (and fixes any problems it can) with ESLint and Prettier.\n If ESLint fails to fix an issue, your commit will fail and you will need to manually correct the problem.\n1. (Optional) Ensure you are up-to-date with Mocha's `main` branch:\n - You can add an \"upstream\" remote repo using `git remote add upstream https://github.com/mochajs/mocha.git && git fetch upstream`.\n - Navigate to your `main` branch using `git checkout main`.\n - Pull changes from `upstream` using `git pull upstream main`.\n - If any changes were pulled in, update your branch from `main` by switching back to your branch (`git checkout `) then merging using `git merge main`.\n1. Push your changes to your fork; `git push origin`.\n1. In your browser, navigate to [mochajs/mocha](https://github.com/mochajs/mocha).\n You should see a notification about your recent changes in your fork's branch, with a (green?) button to create a pull request.\n Click it.\n1. Describe your changes in detail here, following the template.\n Once you're satisfied, submit the form.\n\nAt that point, hooray! 🎉\nYou should see a pull request on github.com/mochajs/mocha/pulls.\n\n### 🤖 AI-Generated Code\n\nWe recognize that AI tools like GitHub Copilot, Claude, and others can be valuable aids in software development.\nHowever, **all code contributions, whether written by humans or generated by AI, must meet the same quality standards**.\n\nIf you use AI to help generate code for a pull request:\n\n- **All automated tests must pass**: Your code must pass linting, unit tests, integration tests, and any other automated checks.\n- **Manual review is required**: AI-generated code must undergo the same thorough manual inspection as any other contribution. This includes checking for correctness, security vulnerabilities, adherence to project conventions, and overall code quality.\n- **You are responsible**: As the submitter of the pull request, you are fully responsible for understanding and maintaining the code, regardless of how it was generated.\n\nThese requirements apply to all contributions and are not unique to AI-generated code—they simply reinforce our existing standards.\n\n### 🏭 PR Process\n\nNow that the pull request exists, some tasks will be run on it:\n\n1. If you have not signed our [Contributor License Agreement](docs.linuxfoundation.org/lfx/easycla/v2-current/contributors), a friendly robot will prompt you to do so.\n A [CLA](https://cla.js.foundation/mochajs/mocha) (electronic) signature is **required** for all contributions of code to Mocha.\n1. Continuous integration checks will run against your changes.\n The result of these checks will be displayed on your PR.\n - If the checks fail, you must address those before the PR is accepted.\n1. Be patient while your PR is reviewed.\n This can take a while.\n We may request changes, but don't be afraid to question them.\n1. Your PR might become conflicted with the code in `main`.\n If this is the case, you will need to [update your PR](#up-to-date) and resolve your conflicts.\n1. You don't need to make a new PR to any needed changes.\n Instead, commit on top of your changes, and push these to your fork's branch.\n The PR will be updated, and CI will re-run.\n1. Once you've addressed all the feedback you can, [re-request review on GitHub](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/about-pull-request-reviews#re-requesting-a-review).\n\nJoin us in [our Discord](https://discord.gg/KeDn2uXhER)!\n\n## 🌐 External Services\n\nMocha uses several external services for project infrastructure:\n\n- **[Codecov](https://app.codecov.io/gh/mochajs/mocha)**: Code coverage tracking. PRs must not decrease coverage. Contributors should add the Codecov GitHub app to upload coverage from forks.\n\n- **[Discord](https://discord.gg/KeDn2uXhER)**: Official community chat for support, discussions, and connecting with maintainers and users.\n\n- **[EasyCLA](https://cla.js.foundation/mochajs/mocha)**: Contributor License Agreement system via Linux Foundation. All code contributions require a signed CLA. A bot prompts contributors on their first PR.\n\n- **Netlify**: Hosts the documentation website at mochajs.org. Provides automatic deploy previews for documentation PRs and nightly scheduled deploys to update supporter information.\n\n- **[npm registry](https://www.npmjs.com/package/mocha)**: Package distribution. Mocha is also available via GitHub Releases.\n\n- **[Open Collective](https://opencollective.com/mochajs)**: Transparent donations to Mocha and expenses from maintainers.\n\n- **[OpenJS Foundation](https://openjsf.org)**: Mocha is part of the OpenJS Foundation which provides governance and infrastructure support. See [PROJECT_CHARTER.md](../PROJECT_CHARTER.md) for governance details.\n" }, { "path": ".github/DEVELOPMENT.md", "content": "# Development\n\nFollow these steps to get going in local development.\nIf you are having trouble, don't be afraid to [ask for help](./CONTRIBUTING.md#❓-got-a-question).\n\n## Prerequisites\n\n- [Install Node.js 14 LTS or newer with npm@7+](https://nodejs.org/en/download).\n - If you're new to installing Node, a tool like [nvm](https://github.com/nvm-sh/nvm#install-script) can help you manage multiple version installations.\n- You will need [Google Chrome](https://www.google.com/chrome) to run browser-based tests locally.\n\n## Setup\n\n1. Follow [Github's documentation](https://help.github.com/articles/fork-a-repo) on setting up Git, forking, and cloning.\n1. Execute `npm install` to install the development dependencies.\n - Do not use `yarn install` or `pnpm install`.\n - Some optional dependencies may fail; you can safely ignore these unless you are trying to build the documentation.\n - If you're sick of seeing the failures, run `npm install --ignore-scripts`.\n\n## Developing Mocha\n\nWhen you contribute to Mocha, you will probably want to try to run your changes on the test suite of another project. You can (and should) run the test suite of Mocha itself before committing, but also confirming that your changes give the expected result on another project.\n\nFor example, [WebSocket.io](https://github.com/LearnBoost/websocket.io/):\n\n $ git clone https://github.com/LearnBoost/websocket.io.git\n\nRetrieve websocket.io's dependencies, which will include the stable version of Mocha:\n\n $ cd websocket.io/\n $ npm install\n\nReplace the Mocha dependency by the current git repository:\n\n $ cd node_modules/\n $ mv mocha/ mocha.save\n $ git clone https://github.com/mochajs/mocha.git\n\nInstall Mocha's dependencies for the development version:\n\n $ cd mocha\n $ npm install\n\nRun websocket.io's test suite using the development version you just installed:\n\n $ cd ../..\n $ ./node_modules/.bin/mocha\n" }, { "path": ".github/FUNDING.yml", "content": "open_collective: mochajs\n" }, { "path": ".github/ISSUE_TEMPLATE/01-bug.yml", "content": "body:\n - attributes:\n description: If any of these required steps are not taken, we may not be able to review your issue. Help us to help you!\n label: Bug Report Checklist\n options:\n - label: This is NOT a [security, `npm audit`, or GitHub Advisory issue](https://mochajs.org/explainers/security-vulnerability-reports).\n required: true\n - label: I have read and agree to Mocha's [Code of Conduct](https://github.com/mochajs/mocha/blob/main/.github/CODE_OF_CONDUCT.md) and [Contributing Guidelines](https://github.com/mochajs/mocha/blob/main/.github/CONTRIBUTING.md)\n required: true\n - label: I have searched for [related issues](https://github.com/mochajs/mocha/issues?q=is%3Aissue) and [issues with the `faq` label](https://github.com/mochajs/mocha/issues?utf8=%E2%9C%93&q=is%3Aissue%20label%3Afaq%20), but none matched my issue.\n required: true\n - label: I have 'smoke tested' the code to be tested by running it outside the real test suite to get a better sense of whether the problem is in the code under test, my usage of Mocha, or Mocha itself.\n required: true\n - label: I want to provide a PR to resolve this\n type: checkboxes\n - attributes:\n description: What did you expect to happen?\n label: Expected\n type: textarea\n validations:\n required: true\n - attributes:\n description: What happened instead?\n label: Actual\n type: textarea\n validations:\n required: true\n - attributes:\n description: Detail the steps necessary to reproduce the problem. To get the fastest support, create an [MCVE](https://stackoverflow.com/help/mcve) and upload it to GitHub.\n label: Minimal, Complete and Verifiable Example\n type: textarea\n validations:\n required: true\n - attributes:\n description: What do `mocha --version`, `node_modules/.bin/mocha --version`, and `node --version` output? What name and version of browser/environment, shell, and any other related modules such as transpilers are you using?\n label: Versions\n type: textarea\n validations:\n required: true\n - attributes:\n description: Any additional info you'd like to provide.\n label: Additional Info\n type: textarea\ndescription: Report a bug trying to use Mocha\nlabels:\n - \"status: in triage\"\n - \"type: bug\"\nname: 🐛 Bug\ntitle: \"🐛 Bug: \"\n" }, { "path": ".github/ISSUE_TEMPLATE/02-documentation.yml", "content": "body:\n - attributes:\n description: If any of these required steps are not taken, we may not be able to review your issue. Help us to help you!\n label: Documentation Request Checklist\n options:\n - label: I have read and agree to Mocha's [Code of Conduct](https://github.com/mochajs/mocha/blob/main/.github/CODE_OF_CONDUCT.md) and [Contributing Guidelines](https://github.com/mochajs/mocha/blob/main/.github/CONTRIBUTING.md)\n required: true\n - label: I have searched for [related issues](https://github.com/mochajs/mocha/issues?q=is%3Aissue) and [issues with the `faq` label](https://github.com/mochajs/mocha/issues?utf8=%E2%9C%93&q=is%3Aissue%20label%3Afaq%20), but none matched my issue.\n required: true\n - label: I want to provide a PR to resolve this\n type: checkboxes\n - attributes:\n description: What would you like to report?\n label: Overview\n type: textarea\n validations:\n required: true\n - attributes:\n description: Any additional info you'd like to provide.\n label: Additional Info\n type: textarea\ndescription: Report a typo or missing area of documentation\nlabels:\n - \"area: documentation\"\n - \"status: in triage\"\nname: 📝 Docs\ntitle: \"📝 Docs: \"\n" }, { "path": ".github/ISSUE_TEMPLATE/03-feature-request.yml", "content": "body:\n - attributes:\n description: If any of these required steps are not taken, we may not be able to review your issue. Help us to help you!\n label: Feature Request Checklist\n options:\n - label: I have read and agree to Mocha's [Code of Conduct](https://github.com/mochajs/mocha/blob/main/.github/CODE_OF_CONDUCT.md) and [Contributing Guidelines](https://github.com/mochajs/mocha/blob/main/.github/CONTRIBUTING.md)\n required: true\n - label: I have searched for [related issues](https://github.com/mochajs/mocha/issues?q=is%3Aissue) and [issues with the `faq` label](https://github.com/mochajs/mocha/issues?utf8=%E2%9C%93&q=is%3Aissue%20label%3Afaq%20), but none matched my issue.\n required: true\n - label: I want to provide a PR to resolve this\n type: checkboxes\n - attributes:\n description: What is the feature gap or problem you'd like to address?\n label: Overview\n type: textarea\n validations:\n required: true\n - attributes:\n description: How would you like to solve this need?\n label: Suggested Solution\n type: textarea\n validations:\n required: true\n - attributes:\n description: What other features or solutions have you also considered?\n label: Alternatives\n type: textarea\n validations:\n required: true\n - attributes:\n description: Any additional info you'd like to provide.\n label: Additional Info\n type: textarea\ndescription: Request that a new feature be added or an existing feature improved\nlabels:\n - \"status: in triage\"\n - \"type: feature\"\nname: 🚀 Feature\ntitle: \"🚀 Feature: \"\n" }, { "path": ".github/ISSUE_TEMPLATE/04-performance.yml", "content": "body:\n - type: markdown\n attributes:\n value: |\n Thanks for taking the time to suggest a performance improvement to Mocha! Please note that Mocha is a widely used library with many millions of weekly downloads, many thousands of dependents, and many years of longstanding behavior. Every change to it is inherently risky and may break user edge cases that we have no way to learn of otherwise.\n\n So, to accept a performance improvement, we'd need to see _measurable, non-negligible improvement_ in Mocha's real-world usage. That requires providing at least:\n\n - Exhaustive comparison with other alternatives that proves this is the winning approach\n - Disclosure of any personal affiliation with the proposed solution and alternatives\n - For runtime performance: some kind of reproducible benchmark to demonstrate exactly what's different\n - For dependency cleanups:\n - The specific change to the dependency tree of a project with Mocha and no other dependencies\n - The specific change to the dependency tree of a project with Mocha and other common dependencies, such as `chai`, `express`, and `sinon`\n\n You can always suggest a performance improvement without those validations, but we are unlikely to accept it without them.\n For more information, see [mochajs/mocha#5377 🛠️ Repo: Add issue template for performance improvements](https://github.com/mochajs/mocha/issues/5377).\n - attributes:\n description: If any of these required steps are not taken, we may not be able to review your issue. Help us to help you!\n label: Performance Suggestion Checklist\n options:\n - label: I am using the latest version of Mocha.\n required: true\n - label: I have read and understood the nuances around performance reports.\n required: true\n - label: I have read and agree to Mocha's [Code of Conduct](https://github.com/mochajs/mocha/blob/main/.github/CODE_OF_CONDUCT.md) and [Contributing Guidelines](https://github.com/mochajs/mocha/blob/main/.github/CONTRIBUTING.md)\n required: true\n - label: I have searched for [related issues](https://github.com/mochajs/mocha/issues?q=is%3Aissue) and [issues with the `faq` label](https://github.com/mochajs/mocha/issues?utf8=%E2%9C%93&q=is%3Aissue%20label%3Afaq%20), but none matched my issue.\n required: true\n - label: I want to provide a PR to resolve this\n type: checkboxes\n - attributes:\n description: What is your suggestion?\n label: Overview\n type: textarea\n validations:\n required: true\n - attributes:\n description: If you have a suggested implementation, please explain why you believe it's the best one here.\n label: Validations\n type: textarea\n - attributes:\n description: Any additional info you'd like to provide.\n label: Additional Info\n type: textarea\ndescription: Suggest a way to make Mocha faster, more memory- and/or space-efficient, or otherwise improve performance\nlabels:\n - \"area: performance\"\n - \"status: in triage\"\nname: ⚡️ Performance\ntitle: \"⚡️ Performance: \"\n" }, { "path": ".github/ISSUE_TEMPLATE/05-repository-tooling.yml", "content": "body:\n - attributes:\n description: If any of these required steps are not taken, we may not be able to review your issue. Help us to help you!\n label: Tooling Suggestion Checklist\n options:\n - label: I have tried restarting my IDE and the issue persists.\n required: true\n - label: I have pulled the latest `main` branch of the repository.\n required: true\n - label: I have read and agree to Mocha's [Code of Conduct](https://github.com/mochajs/mocha/blob/main/.github/CODE_OF_CONDUCT.md) and [Contributing Guidelines](https://github.com/mochajs/mocha/blob/main/.github/CONTRIBUTING.md)\n required: true\n - label: I have searched for [related issues](https://github.com/mochajs/mocha/issues?q=is%3Aissue) and [issues with the `faq` label](https://github.com/mochajs/mocha/issues?utf8=%E2%9C%93&q=is%3Aissue%20label%3Afaq%20), but none matched my issue.\n required: true\n - label: I want to provide a PR to resolve this\n type: checkboxes\n - attributes:\n description: What changes would you like, and how do they help contributors?\n label: Overview\n type: textarea\n validations:\n required: true\n - attributes:\n description: Any additional info you'd like to provide.\n label: Additional Info\n type: textarea\ndescription: Report a bug or request an enhancement in the Mocha repository's internal tooling\nlabels:\n - \"area: repository tooling\"\n - \"status: in triage\"\nname: 🛠️ Repository Tooling\ntitle: \"🛠️ Repo: \"\n" }, { "path": ".github/ISSUE_TEMPLATE/config.yml", "content": "blank_issues_enabled: true\ncontact_links:\n - name: Documentation Website\n about: Please read our documentation website before filing new issues.\n url: https://mochajs.org\n - name: Documentation Website > APIs\n about: If you're using Mocha's API, see also the website's API docs.\n url: https://mochajs.org/api\n - name: Discord\n about: Our Discord is the right place for quick informal questions.\n url: https://discord.gg/KeDn2uXhER\n - name: StackOverflow\n about: For more questions, see the `mocha` tag on StackOverflow.\n url: https://stackoverflow.com/questions/tagged/mocha\n" }, { "path": ".github/PULL_REQUEST_TEMPLATE.md", "content": "\n\n## PR Checklist\n\n- [ ] Addresses an existing open issue: fixes #000\n- [ ] That issue was marked as [`status: accepting prs`](https://github.com/mochajs/mocha/issues?q=is%3Aopen+is%3Aissue+label%3A%22status%3A+accepting+prs%22)\n- [ ] Steps in [CONTRIBUTING.md](https://github.com/mochajs/mocha/blob/main/.github/CONTRIBUTING.md) were taken\n\n## Overview\n\n\n" }, { "path": ".github/dependabot.yml", "content": "version: 2\nupdates:\n - package-ecosystem: \"github-actions\"\n directory: \"/\"\n schedule:\n interval: \"weekly\"\n groups:\n github-actions:\n patterns:\n - \"*\"\n" }, { "path": ".github/release-please/config.json", "content": "{\n \"$schema\": \"https://raw.githubusercontent.com/googleapis/release-please/v17.1.3/schemas/config.json\",\n \"release-type\": \"node\",\n \"include-component-in-tag\": false,\n\n \"prerelease\": true,\n \"versioning\": \"prerelease\",\n\n \"changelog-sections\": [\n { \"type\": \"feat\", \"section\": \"🌟 Features\", \"hidden\": false },\n { \"type\": \"fix\", \"section\": \"🩹 Fixes\", \"hidden\": false },\n { \"type\": \"docs\", \"section\": \"📚 Documentation\", \"hidden\": false },\n\n { \"type\": \"chore\", \"section\": \"🧹 Chores\", \"hidden\": false },\n { \"type\": \"perf\", \"section\": \"🧹 Chores\", \"hidden\": false },\n { \"type\": \"refactor\", \"section\": \"🧹 Chores\", \"hidden\": false },\n { \"type\": \"test\", \"section\": \"🧹 Chores\", \"hidden\": false },\n\n { \"type\": \"build\", \"section\": \"🤖 Automation\", \"hidden\": false },\n { \"type\": \"ci\", \"section\": \"🤖 Automation\", \"hidden\": true }\n ],\n \"packages\": {\n \".\": {}\n }\n}\n" }, { "path": ".github/release-please/manifest.json", "content": "{\".\":\"12.0.0-beta.10\"}\n" }, { "path": ".github/workflows/mocha.yml", "content": "name: Tests\n\non:\n push:\n branches:\n - main\n paths-ignore:\n [\"*.md\", \"docs/**\", \".github/**\", \".prettierignore\", \"AUTHORS\", \"LICENSE\"]\n pull_request:\n branches:\n - main\n paths-ignore:\n [\"*.md\", \"docs/**\", \".github/**\", \".prettierignore\", \"AUTHORS\", \"LICENSE\"]\n types: [opened, synchronize, reopened, edited]\n workflow_dispatch:\n\npermissions:\n contents: read\n id-token: write # for Codecov OIDC\n\njobs:\n format:\n uses: ./.github/workflows/npm-script.yml\n with:\n npm-script: format:check\n\n lint:\n uses: ./.github/workflows/npm-script.yml\n with:\n npm-script: lint\n\n smoke:\n uses: ./.github/workflows/npm-script.yml\n with:\n node-versions: \"20,22,24\"\n npm-script: test-smoke\n\n test-node-lts:\n # TODO: Restore \"mocha-github-actions-reporter\" style reporting without relying on third party module\n # https://github.com/mochajs/mocha/issues/5183\n uses: ./.github/workflows/npm-script.yml\n needs: smoke\n strategy:\n fail-fast: false\n matrix:\n test-part:\n - interfaces\n - unit\n - integration\n - jsapi\n - requires\n - reporters\n - only\n with:\n npm-script: test-node:${{ matrix.test-part }}\n\n test-node-all:\n name: Test ${{ matrix.test-part }} in all environments\n permissions:\n id-token: write # for Codecov OIDC\n contents: read # for Codecov OIDC\n # TODO: Restore \"mocha-github-actions-reporter\" style reporting without relying on third party module\n # https://github.com/mochajs/mocha/issues/5183\n uses: ./.github/workflows/npm-script.yml\n needs: test-node-lts\n strategy:\n fail-fast: false\n matrix:\n coverage: [true]\n test-part:\n - interfaces\n - unit\n - integration\n - requires\n - reporters\n - only\n include:\n - test-part: jsapi\n coverage: false\n with:\n os: \"ubuntu-latest,windows-latest\"\n # We pin exact versions here per https://github.com/mochajs/mocha/issues/5052\n # Ref https://nodejs.org/en/about/previous-releases\n node-versions: \"20.19.4,22.18.0,24.6.0\"\n npm-script: test-node:${{ matrix.test-part }}\n coverage: ${{ matrix.coverage }}\n\n test-browser-local:\n uses: ./.github/workflows/npm-script.yml\n with:\n browsers: ChromeHeadless\n npm-script: test-browser\n\n tsc:\n uses: ./.github/workflows/npm-script.yml\n with:\n npm-script: tsc\n" }, { "path": ".github/workflows/nightly-site-deploy.yml", "content": "# Deploy `mochajs.org` branch nightly by hitting a netlify build URL.\n# This updates the list of supporters\n# It uses commands from netlify.toml at root of repo\n\nname: Nightly mochajs.org Deploy\n\non:\n schedule:\n - cron: \"0 0 * * *\"\n workflow_dispatch:\n\npermissions:\n contents: read\n\njobs:\n deploy:\n runs-on: ubuntu-latest\n steps:\n - name: Webhook Action\n uses: joelwmale/webhook-action@6cebc9d7dc8435b684e1e1945c0013d9023b76a4\n env:\n data: \"\"\n WEBHOOK_URL: ${{ secrets.NETLIFY_NIGHTLY_DEPLOY_URL }}\n" }, { "path": ".github/workflows/npm-script.yml", "content": "name: Reusable npm script runner\n\non:\n workflow_call:\n inputs:\n npm-script:\n description: \"npm script\"\n required: true\n type: string\n browsers:\n description: \"A comma separated list of browser names to test with.\"\n required: false\n type: string\n node-versions:\n description: \"A comma separated list of Node versions to test with.\"\n required: false\n type: string\n os:\n description: \"A comma separated list of operating systems to test on.\"\n required: false\n type: string\n coverage:\n description: \"Whether to set up coverage reporting or not\"\n required: false\n type: boolean\n\npermissions:\n contents: read\n id-token: write\n\njobs:\n resolve-inputs:\n runs-on: ubuntu-latest\n outputs:\n browsers: ${{ steps.split-browsers.outputs.splitted }}\n nodeVersions: ${{ steps.split-node-versions.outputs.splitted }}\n os: ${{ steps.split-os.outputs.splitted }}\n steps:\n - id: split-browsers\n if: inputs.browsers\n run: echo \"splitted=$(echo '${{ inputs.browsers }}' | jq -R -c 'split(\",\")')\" >> $GITHUB_OUTPUT\n - id: split-node-versions\n if: inputs.node-versions\n run: echo \"splitted=$(echo '${{ inputs.node-versions }}' | jq -R -c 'split(\",\")')\" >> $GITHUB_OUTPUT\n - id: split-os\n if: inputs.os\n run: echo \"splitted=$(echo '${{ inputs.os }}' | jq -R -c 'split(\",\")')\" >> $GITHUB_OUTPUT\n\n script:\n name: ${{ inputs.npm-script }}${{ needs.resolve-inputs.outputs.browsers && format('[{0}]', matrix.browser) }}${{ needs.resolve-inputs.outputs.nodeVersions && format(' with node.js {0}', matrix.node_version) }}${{ needs.resolve-inputs.outputs.os && format(' on {0}', matrix.os) }}\n runs-on: ${{ matrix.os }}\n timeout-minutes: 20\n needs:\n - resolve-inputs\n strategy:\n fail-fast: false\n matrix:\n node_version: ${{ fromJson(needs.resolve-inputs.outputs.nodeVersions || '[\"22\"]') }}\n os: ${{ fromJson(needs.resolve-inputs.outputs.os || '[\"ubuntu-latest\"]') }}\n browser: ${{ fromJson(needs.resolve-inputs.outputs.browsers || '[\"\"]') }}\n steps:\n - uses: actions/checkout@v6\n with:\n persist-credentials: false\n - uses: actions/setup-node@v6\n with:\n node-version: ${{ matrix.node_version }}\n cache: \"npm\"\n - run: npm ci --ignore-scripts\n - run: npm run ${{ inputs.npm-script }}\n env:\n BROWSER: ${{ matrix.browser }}\n COVERAGE: ${{ inputs.coverage && '1'}}\n NODE_OPTIONS: \"--trace-warnings\"\n # Generate and upload coverage, even if tests fail\n - name: Generate coverage report\n if: always() && inputs.coverage\n run: npm run test-coverage-generate\n # https://github.com/marketplace/actions/codecov\n # https://app.codecov.io/gh/mochajs/mocha\n - name: Upload coverage reports\n if: always() && inputs.coverage\n uses: codecov/codecov-action@v5\n with:\n fail_ci_if_error: true\n use_oidc: true\n" }, { "path": ".github/workflows/octoguide.yml", "content": "jobs:\n octoguide:\n if: ${{ !endsWith(github.actor, '[bot]') }}\n runs-on: ubuntu-latest\n steps:\n - uses: OctoGuide/bot@0.21.10\n with:\n github-token: ${{ secrets.GITHUB_TOKEN }}\n\nname: OctoGuide\n\non:\n discussion:\n types: [created, edited]\n discussion_comment:\n types: [created, deleted, edited]\n issue_comment:\n types: [created, deleted, edited]\n issues:\n types: [edited, opened]\n pull_request_review_comment:\n types: [created, deleted, edited]\n pull_request_target:\n types: [edited, opened]\n\npermissions:\n discussions: write\n issues: write\n pull-requests: write\n" }, { "path": ".github/workflows/release-please.yml", "content": "name: Release Please\n\non:\n push:\n branches:\n - main\n workflow_dispatch:\n\npermissions:\n contents: read\n id-token: write\n\njobs:\n release_please:\n name: release-please\n runs-on: ubuntu-latest\n outputs:\n releaseCreated: ${{ steps.release.outputs.release_created }}\n permissions:\n contents: write\n pull-requests: write\n steps:\n - uses: googleapis/release-please-action@v4\n id: release\n with:\n config-file: .github/release-please/config.json\n manifest-file: .github/release-please/manifest.json\n\n npm_publish:\n name: Publish to npm\n runs-on: ubuntu-latest\n environment: npm\n needs: release_please\n if: needs.release_please.outputs.releaseCreated\n steps:\n - uses: actions/checkout@v6\n with:\n show-progress: false\n - uses: actions/setup-node@v6\n with:\n node-version: \"22\"\n registry-url: \"https://registry.npmjs.org\"\n\n - name: Upgrade npm for OIDC support\n run: npm install -g npm@latest\n\n - name: Install dependencies\n run: npm ci --ignore-scripts --force --no-fund --no-audit\n\n - run: npm publish --provenance --access public --tag=next\n env:\n NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}\n" }, { "path": ".gitignore", "content": "# Mocha-specific\ndocs/images/supporters\nmocha.js\nmocha.js.map\n.karma/\n!bin/mocha.js\n!lib/mocha.js\n\n# Bundle debugging\nstats.html\n\n#########################################\n# NON-MOCHA STUFF GOES BELOW THIS THING #\n#########################################\n\n# Git mergetool\n# Use `git config mergetool.keepBackup false` to stop generating these files\n*.orig\n\n# Logs\nlogs\n*.log\nnpm-debug.log*\nyarn-debug.log*\nyarn-error.log*\n\n# nyc/istanbul\ncoverage\n.nyc_output\n\n# Dependencies\nnode_modules/\n\n# npm\n.npm\n*.tgz\n\n# Optional eslint cache\n.eslintcache\n\n# Optional REPL history\n.node_repl_history\n\n# dotenv environment variables file\n.env\n.env.test\n\n# Yarn\nyarn.lock\n.yarn-integrity\n\n# Various temporary files\n*~\n\n# Emacs\n\\#*\\#\n/.emacs.desktop\n/.emacs.desktop.lock\n*.elc\nauto-save-list\ntramp\n.\\#*\n\n# Vim\n[._]*.s[a-v][a-z]\n[._]*.sw[a-p]\n[._]s[a-rt-v][a-z]\n[._]ss[a-gi-z]\n[._]sw[a-p]\nSession.vim\n[._]*.un~\n\n# Diff\n*.patch\n*.diff\n\n# VSCode\n.vscode/\n\n# JetBrains' IDEs\n.idea/\n*.iws\nout/\n.idea_modules/\natlassian-ide-plugin.xml\n\n# SourceTree\n*_BACKUP_*\n*_BASE_*\n*_LOCAL_*\n*_REMOTE_*\n\n# SublimeText\n*.tmlanguage.cache\n*.tmPreferences.cache\n*.stTheme.cache\n*.sublime-workspace\n*.sublime-project\nsftp-config.json\nPackage Control.last-run\nPackage Control.ca-list\nPackage Control.ca-bundle\nPackage Control.system-ca-bundle\nPackage Control.cache/\nPackage Control.ca-certs/\nPackage Control.merged-ca-bundle\nPackage Control.user-ca-bundle\noscrypto-ca-bundle.crt\nbh_unicode_properties.cache\nGitHub.sublime-settings\n\n# direnv\n.envrc\n\n# Linux\n.fuse_hidden*\n.directory\n.Trash-*\n.nfs*\n\n# Windows\nThumbs.db\nehthumbs.db\nehthumbs_vista.db\n*.stackdump\n[Dd]esktop.ini\n$RECYCLE.BIN/\n*.cab\n*.msi\n*.msix\n*.msm\n*.msp\n*.lnk\n\n# macOS\n.DS_Store\n.AppleDouble\n.LSOverride\n._*\n.AppleDB\n.AppleDesktop\nNetwork Trash Folder\nTemporary Items\n.apdisk\n\n# Local Netlify folder\n.netlify\n" }, { "path": ".knip.jsonc", "content": "{\n \"$schema\": \"https://unpkg.com/knip@5/schema-jsonc.json\",\n \"entry\": [\n \"bin/mocha.js!\",\n \"bin/_mocha!\",\n \"browser-entry.js!\",\n \"docs/_data/supporters.cjs\",\n \"index.js!\",\n \"lib/cli/index.js!\",\n ],\n \"project\": [\"{bin,lib,scripts,test}/**/*.{js,ts,mjs,cjs}\"],\n \"ignore\": [\n \"test/integration/fixtures/esm/type-module/test-that-imports-non-existing-module.fixture.js\",\n \"test/integration/fixtures/options/watch/test-with-dependency.fixture.js\",\n ],\n \"ignoreDependencies\": [\n \"@test/esm-only-loader\",\n \"coffeescript\",\n \"fake\",\n \"non-existent-package\",\n ],\n \"mocha\": {\n \"entry\": [\"test/**/*.{js,ts,mjs,cjs}\"],\n },\n \"webpack\": {\n \"config\": \"test/browser-specific/fixtures/webpack/webpack.config.js\",\n },\n \"rules\": {\n \"exports\": \"off\",\n },\n}\n" }, { "path": ".lintstagedrc.json", "content": "{\n \"@(**/*.js|bin/*)\": [\"eslint --fix\"],\n \"!(package*).json\": [\"prettier --write\"],\n \"*.{yml,md,html}\": [\"prettier --write\"]\n}\n" }, { "path": ".mailmap", "content": "# see https://www.git-scm.com/docs/git-check-mailmap for formatting info\nTJ Holowaychuk \nTravis Jeffery \nTravis Jeffery Dr. Travis Jeffery \nChristopher Hiller \nDavid da Silva Contín David da Silva \nDavid da Silva Contín David da Silva \nDavid da Silva Contín \nAriel Mashraki \nAriel Mashraki \nForbes Lindesay \nBen Bradley <[ben.bradley@cigna.com|mailto:ben.bradley@cigna.com]>\nGlen Mailer \n38elements <38elements@users.noreply.github.com>\nAndreas Lind Petersen Andreas Lind \nBen Harris \nCan Oztokmak \nWill Langstroth \nSulabh Bista \nRustem Mustafin \nRico Sta. Cruz \nPete Hawkins \nRaynos <=>\nRaynos Raynos (Jake Verbaten) \nMarkus Tacker \nLong Ho \nLászló Bácsi Laszlo Bacsi \nEli Skeggs \nDomenic Denicola domenic \nMichael Schoonmaker \n" }, { "path": ".mocharc.yml", "content": "require: \"test/setup\"\nui: \"bdd\"\nglobal:\n - \"okGlobalA,okGlobalB\"\n - \"okGlobalC\"\n - \"callback*\"\ntimeout: 1000\nwatch-ignore:\n - \".*\"\n - \"docs/_site/**\"\n - \"node_modules\"\n - \"coverage\"\n - \"cache\"\n" }, { "path": ".npmrc", "content": " message=Release v%s" }, { "path": ".nycrc", "content": "{\n \"reporter\": [\"json\", \"text-summary\"],\n \"all\": true,\n \"exclude\": [\n \"coverage/**\",\n \"docs/**\",\n \"packages/*/test{,s}/**\",\n \"**/*.d.ts\",\n \"test{,s}/**\",\n \"test{,-*}.{js,cjs,mjs,ts}\",\n \"**/*{.,-}test.{js,cjs,mjs,ts}\",\n \"**/__tests__/**\",\n \"**/{karma,rollup,webpack}.config.js\",\n \"**/{babel.config,.eslintrc,.mocharc}.{js,cjs}\",\n \"lib/browser/**\",\n \"package-scripts.js\",\n \"package-lock.json\",\n \"**/package-lock.json\",\n \"node_modules/**\",\n \"scripts/**\"\n ]\n}\n" }, { "path": ".prettierignore", "content": "/.karma/\n/.nyc_output\n/CHANGELOG.md\n/coverage\n/pnpm-lock.yaml\n/test/*/fixtures/**\n\n# release-please generate a compact manifest.json by default\n/.github/release-please/manifest.json\n" }, { "path": ".wallaby.js", "content": "\"use strict\";\n\nmodule.exports = () => {\n return {\n files: [\n \"index.js\",\n \"lib/**/*.{js,json}\",\n \"test/setup.js\",\n \"test/assertions.js\",\n {\n pattern: \"test/node-unit/**/*.fixture.js\",\n instrument: false,\n },\n {\n pattern: \"test/unit/**/*.fixture.js\",\n instrument: false,\n },\n \"package.json\",\n \"mocharc.yml\",\n \"!lib/browser/growl.js\",\n ],\n filesWithNoCoverageCalculated: [\n \"test/**/*.fixture.js\",\n \"test/setup.js\",\n \"test/assertions.js\",\n \"lib/browser/**/*.js\",\n ],\n tests: [\"test/unit/**/*.spec.js\", \"test/node-unit/**/*.spec.js\"],\n env: {\n type: \"node\",\n runner: \"node\",\n },\n workers: { recycle: true },\n testFramework: { type: \"mocha\", path: __dirname },\n setup(wallaby) {\n // running mocha instance is not the same as mocha under test,\n // running mocha is the project's source code mocha, mocha under test is instrumented version of the source code\n const runningMocha = wallaby.testFramework;\n runningMocha.timeout(1000);\n // to expose it/describe etc. on the mocha under test\n const MochaUnderTest = require(\"./\");\n const mochaUnderTest = new MochaUnderTest();\n mochaUnderTest.suite.emit(\n MochaUnderTest.Suite.constants.EVENT_FILE_PRE_REQUIRE,\n global,\n \"\",\n mochaUnderTest,\n );\n require(\"./test/setup\");\n },\n debug: true,\n runMode: \"onsave\",\n };\n};\n" }, { "path": "AUTHORS", "content": "# Authors ordered by first contribution.\n\nTJ Holowaychuk \nJames Carr \nFredrik Lindin \nKonstantin Käfer \nDavid Henderson \nHarry Brundage \nQuang Van \nhokaccha \nGuillermo Rauch \nFARKAS Máté \nBen Lindsey \nSteve Mason \nRyunosuke SATO \nNathan Rajlich \nRaynos \nYuest Wang \nMaciej Małecki \nJoshua Krall \nFedor Indutny \nWill Langstroth \nAttila Domokos \nJussi Virtanen \nPhil Sung \nvlad \nPaul Miller \nBjørge Næss \nJeff Kunkle \nFabio M. Costa \nMichael Riley \nIan Young \nJakub Nešetřil \nTyson Tate \nJo Liss \nArian Stolwijk \nBrendan Nee \nXavier Antoviaque \nDomenic Denicola \nBrian Beck \nDave McKenna \nRichard Dingwall \nCory Thomas \nR56 \nIan Storm Taylor \nAndreas Brekken \nabrkn \nNathan Bowser \nLászló Bácsi \nAtsuya Takagi \nGavin Mogan \nfengmk2 \nSeiya Konno \nJan Lehnardt \nMatt Robenolt \nJonas Westerlund \nKoen Punt \nJason Barry \nAustin Birch \nAdam Crabtree \nCasey Foster \nJonathan Creamer \nBrian Moore \ntraleig1 \nJohn Firebaugh \nairportyh \nAaron Heckmann \nRuss Bradberry \nIvan \nCorey Butler \nPaul Armstrong \nHerman Junge \nMichael Schoonmaker \nWil Moore III \nPete Hawkins \ntgautier@yahoo.com \nyuitest \nMatt Smith \nKatie Gengler \nBryan Donovan \nNathan Alderson \nShawn Krisman \nMerrick Christensen \nTimo Tijhof \nSimon Gaeremynck \nJaakko Salonen \nJonathan Rajavuori \nForbes Lindesay \nStanda Opichal \nMatthew Shanley \nJames Lal \nGreg Perkins \nGareth Murphy \nJuzer Ali \nSasha Koss \nJustin DuJardin \nFrederico Silva \nJesse Dailey \nYanis Wang \nfcrisci \nJavier Aranda \nFlorian Margaine \nfool2fish \nJames Bowes \nValentin Agachi \nMathieu Desvé \nGlen Huang \nSimon Goumaz \nAlexander Early \nJimmy Cuadra \nRussell Munson \nlodr \nLiam Newman \nDmitry Shirokov \nFredrik Enestad \nKirill Korolyov \ngrasGendarme \nMike Pennisi \nVictor Costan \nTim Ehat \nJeremy Martin \nMal Graty \nDi Wu \nbadunk \nMarc Kuo \nSindre Sorhus \nSalehen Shovon Rahman \neiji.ienaga \nOscar Godson \nDaniel Stockman \nStephen Mathieson \nTravis Jeffery \nAndreas Lind Petersen \nRomain Prieto \nJP Bochi \nTeddy Zeenny \nRoman Neuhauser \nXhmikosR \nBrian Lalor \nRefael Ackermann \nChrisWren \nAndrew Nesbitt \nberni \nAndrey Popp <8mayday@gmail.com>\nBrian M. Carlson \nMichael Olson \nArnaud Brousseau \nPeter Rust \nVadim Nikitin \nRoman Shtylman \nTapiwa Kelvin \nRustem Mustafin \nGlen Mailer \nNathan Black \nsebv \nandy matthews \nBenjie Gillam \nNoshir Patel \nBen Noordhuis \nJacob Wejendorp \nclaudyus \nDenis Bardadym \nConnor Dunn \nJonathan Ong \nHarish \nMichal Charemza \nstartswithaj \nGareth Aye \nNick Fitzgerald \nJan Kopriva \nkavun \nChristoffer Hallas \nJonathan Park \nDevin Weaver \nJohn Doty \nShaine Hatch \nBen Bradley \nqiuzuhui \nJean Ponchon \nLinus Unnebäck \nMattias Tidlund \nMatija Marohnić \nMichael Jackson \nJoel Kemp \nZsolt Takács \njsdevel \nlakmeer \nJoshua Appelman \nChristopher Hiller \nMichael Demmer \nGiovanni Bassi \nPanu Horsmalahti \nnishigori \nNicolo Taddei \nDiogo Monteiro \nmrShturman \nPoppinL \nsamuel goldszmidt \nRob Wu \nKent C. Dodds \nKevin Conway \nDominique Quatravaux \nzhiyelee \nQuanlong He \nomardelarosa \nAriel Mashraki \nSean Lang \nDavid da Silva Contín \nC. Scott Ananian \nDouglas Christopher Wilson \nRichard Knop \nBuck Doyle \nJonas Dohse \noveddan \nmonowerker \nMarcello Bastea-Forte \nBenoît Zugmeyer \nVlad Magdalin \nMoshe Kolodny \nTom Coquereau \nTimothy Gu \nIan Zamojc \nMartin Marko \nChris Buckley \nJake Craige \nFede Ramirez \nParker Moore \nTodd Agulnick \nDaniel St. Jules \nRico Sta. Cruz \nAnis Safine \nAdam Gruber \nSam Mussell \nklaemo \nStewart Taylor \nJordan Sexton \nKeith Cirkel \nAndrii Shumada \nDominic Barnes \nMaximilian Antoni \nSune Simonsen \nKyle Mitchell \nJames Nylen \nJonathan Delgado \nJake Marsh \nslyg \nTomer Eskenazi \nJeff Schilling \nRyan Hubbard \namsul \nKevin Kirsche \nGabriel Silk \nJohnathon Sanders \nMax Goodman \nNathan Houle \nBen Vinegar \nDuncan Beevers \nTingan Ho \nGuy Arye \nNik Nyby \nArtem Govorov \nAjay Kodali \nRyan Tablada \nPavel Zubkou \ngigadude \nOutsider \nJason Lai \nAaron Krause \nwsw \nKevin Burke \nBerker Peksag \nnexdrew \nHugo Giraudel \nRich Trott \nMatt Giles \nJoey Cozza \nKris Rasmussen \nJames G. Kim \nSorin Iclanzan \nRob Raux \nSergey Simonchik \nIan W. Remmel \ntmont \nJohn Reeves \nFagner Brack \nMark Banner \nMichiel de Jong \nBenoit Larroque \nCharles Lowell \nJoao Moreno \nLong Ho \nRobert Rossmann \nAaron Hamid \nStone \nTom Hughes \nSoel \nMislav Marohnić \nPrayag Verma \nFrank Leon Rose \nRyan Shaw \nThedark1337 \nGyandeep Singh \nryym \nJosh Lory \nJonathan Kim \nAl Scott \nTobias Bieniek \nBenjamin Eidelman \nJulien Wajsberg \nsarehag \nAlexander Shepelin \nOlegTsyba \nXavier Damman \nMick Brooks \nErik Eng \nKelong Wang \nJérémie Astori \nScottFreeCode \nSergio Santoro \nAdrian Ludwig \nAnders Olsen Sandvik \nThomas Grainger \njimenglish81 \nAvi Vahl \nJason Leyba \nsilentcloud \nDmitriy Simushev \nsimov \nRoss Warren \nBenson Trent \nrmacklin \nRob Loach \nShinnosuke Watanabe \nCallum Macrae \nELLIOTTCABLE \nAnton \nPeter Müller \nAPerson \nnot-an-aardvark \nAlhadis \nSlobodan Mišković \nPhilip M. White \nChristian \nanton \nDmitry Sorin \nVivek Ganesan \nJosh Eversmann \ninxorable \nBen Harris \nAaron Petcoff \nMatt Bierner \nVille Saukkonen \nBen Hutchison \nVolker Buzek \nScott Kao \nSulabh Bista \nrotemdan \nFumiaki MATSUSHIMA \nMarkus Tacker \nChristoph Neuroth \nEnric Pallerols \nCraig Taub \nYoshiya Hinosawa \nSebastian Van Sande \nChris Lamb \nIgwe Kalu \nKevin Wang \nLaurence Rowe \nJakob Krigovsky \nChris \nKunal Nagpal \nelergy \nJupp Müller \nPoprádi Árpád \nCharlie Rudolph \nAngelica Valenta \nJan Krems \nJosh Soref \nsolodynamo \nEli Skeggs \nNikolaos Georgiou \nolsonpm \nDavid Neubauer \nDarryl Pogue \n38elements \nGuangcong Luo \nDavid M. Lee \ntripu \nPat Finnigan \nEugene Tiutiunnyk \nAaron Brady \nCharles Merriam \nKevin Partington \nLane Kelly \nCube \nyehiyam \nJon Surrell \n现充 \nAhmad Bamieh \nCapacitor Set \nAnthony \nCan Oztokmak \nImgBot <31427850+ImgBotApp@users.noreply.github.com>\nThomas Broadley \nFND \nDina Berry \nMarais Rossouw \nAndrew Krawchyk <903716+akrawchyk@users.noreply.github.com>\nTed Yavuzkurt \nDaniel Ruf \nHarry Wolff \nValeri Karpov \nSilvio Massari \nJoseph Lin \nHonza Javorek \nHarry Sarson \nAnish Karandikar \nVictor \nEmanuele \nThomas Vantuycom \nAlex Bainter \nJerry Muzsik \nNicolas Girault \ndfberry \nDavNej \nPaul Roebuck \nTim Harshman \nCharles Samborski \nTobias Mollstam \nBen Glassman \nMark Owsiak \nfargies \nMarc Udoff \ngizemkeser <44727928+gizemkeser@users.noreply.github.com>\nFin Chen \nBrittany Moore \nFábio Santos \nJayasankar \nJuerg B <44573692+juergba@users.noreply.github.com>\nSvetlana <39729453+Lana-Light@users.noreply.github.com>\nMartijn Cuppens \nAnna Henningsen \nAndreas Lind \nChen Yangjian <252317+cyjake@users.noreply.github.com>\nCorey Farrell \nWanseob Lim \nSzauka <33459309+Szauka@users.noreply.github.com>\nBrian Tomlin \nSylvain \nAdam Ginzberg \nXhmikosR \nGastón I. Silva \nAndrew Bradley \nAndrew Bradley \nDavidLi119 \nJames D. Rogers \nCarl-Erik Kopseng \njuergba \nSylvester Keil \nBjorn Stromberg \nStephen Hess \ntoyjhlee \nPiotr Kuczynski \nThomas Scholtes \nBrian Lagerman <49239617+brian-lagerman@users.noreply.github.com>\nPascal \nGabe Gorelick \nDaniel Ruf <827205+DanielRuf@users.noreply.github.com>\nMario Díaz Ceñera <46492068+MarioDiaz98@users.noreply.github.com>\nOliver Salzburg \nSona Lee \nPark Seong-beom \nEunChan Park \nMia \nLindsay-Needs-Sleep <51773923+Lindsay-Needs-Sleep@users.noreply.github.com>\nSoobin Bak \nPeter Schmidt \nSheetJSDev \nHyunSangHan \nJan-Philip Gehrcke \nRobert Kieffer \nSaerom Bang \nKyle Fuller \nRens Groothuijsen \nHugo Kim \nKyoungWan \nZirak \nChristian Holm \nKai Cataldo \nGil Tayar \nUlises Gascón \nkundol \nArvid Ottenberg \nDaniel0113 \nNico Jansen \nJacobLey <37151850+JacobLey@users.noreply.github.com>\nGil Tayar \nMartin Oppitz \nBenjamin E. Coe \nMichael Brade \nGopishankar Haridas \ndevjeel \nMartin Oppitz \nindieisaconcept \nSri Harsha \nirrationnelle \nDonghoon Song <32301380+Donghoon759@users.noreply.github.com>\nSujin Park \nKIM HYO RIN \nChuf <42591821+GChuf@users.noreply.github.com>\nDonghoon Song \nEvaline Ju \nPark Juhyung \nFrançois Hodierne \nEvaline Ju <69598118+evaline-ju@users.noreply.github.com>\nValeria \nJordan Stephens \nAdam Keating <1427265+akeating@users.noreply.github.com>\nHazem \nJosé Jesús Sinohui Fernández \nMaxwell Gerber \nSebastian Noack \nChristian Bromann \nAlexander Fenster \nMoonSupport \nDayzen \nAlexander Fenster \nkirill-golovan <57108967+kirill-golovan@users.noreply.github.com>\nMichal Dorner \nCurtis Man \n华 <1395348685z@gmail.com>\nAndrei Rusu \nQuentin Barbe \nMattias Norlander \nCommanderRoot \nElihu Cruz \nSukka \nDarius Dzien \nYeting Li \nGreggman \nJosh Goldberg \nKleis Auke Wolthuizen \nPaulo Gonçalves \nAnton Usmansky \njb2311 <32516995+jb2311@users.noreply.github.com>\nAras Abbasi \nSpencer <16455389+Spencer-Doak@users.noreply.github.com>\nFeng Yu \nPelle Wessman \nOrgad Shaneh \nLucas Lopes \nBryan Mishkin <698306+bmish@users.noreply.github.com>\nVille Lahdenvuo \nNathan Phillip Brink \nStåle Tomten \ndependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>\nSleepy Flower \nStevenMia <166844090+StevenMia@users.noreply.github.com>\nSimon Hanna <33220646+simhnna@users.noreply.github.com>\nIlia Choly \nMarjorie Saito \nKhoa Huynh <58313491+khoaHyh@users.noreply.github.com>\nSam Adams <107990625+sam-super@users.noreply.github.com>\nMarc Durdin \nIlya Goncharov \ngithub-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>\nMark Wiemer <7833360+mark-wiemer@users.noreply.github.com>\nDanny Lin \nKristján Oddsson \nDavid Huggins-Daines \nJoy Dey \nJulian Grinblat \nLinda_pp \nEric Cornelissen \nKelechi Ebiri <56020538+TG199@users.noreply.github.com>\nDinika \nKevin Locke \nPhillip Barta \nGrzegorz Godlewski \nDarren DeRidder <73rhodes@users.noreply.github.com>\nChengzhong Wu \nMarcelo Shima \nChengzhong Wu \nSamuel Henrique \nMark Wiemer \nMartin Slota <46676886+martinslota@users.noreply.github.com>\n\n# Generated by scripts/update-authors.js\n" }, { "path": "CHANGELOG.md", "content": "# Changelog\n\n## [12.0.0-beta-10](https://github.com/mochajs/mocha/compare/v12.0.0-beta-9...v12.0.0-beta-10) (2026-02-21)\n\n\n### 🌟 Features\n\n* remove Sauce Labs ([#5700](https://github.com/mochajs/mocha/issues/5700)) ([625c34e](https://github.com/mochajs/mocha/commit/625c34e8469562dbde8440c2b4d64e820f7019fa))\n\n\n### 🩹 Fixes\n\n* change Pending to properly extend Error ([#5679](https://github.com/mochajs/mocha/issues/5679)) ([158effd](https://github.com/mochajs/mocha/commit/158effd7de677c21b3a4ccd79ce0879fe0f97f8b))\n* **deps:** update dependency chokidar to v5 ([#5734](https://github.com/mochajs/mocha/issues/5734)) ([ff2f17f](https://github.com/mochajs/mocha/commit/ff2f17fb25e5001420d48035f81f5b19a5f0974f))\n* **deps:** update dependency minimatch to v10 ([#5743](https://github.com/mochajs/mocha/issues/5743)) ([3f3e449](https://github.com/mochajs/mocha/commit/3f3e449f889cb2ddcf950e7bf2268091000b9f7c))\n* **deps:** update dependency starlight-package-managers to ^0.12.0 ([#5717](https://github.com/mochajs/mocha/issues/5717)) ([aa4ba48](https://github.com/mochajs/mocha/commit/aa4ba483a4a25f5dfc36334439caf2b8935874d2))\n\n\n### 📚 Documentation\n\n* fix client redirects ([#5697](https://github.com/mochajs/mocha/issues/5697)) ([dd9145d](https://github.com/mochajs/mocha/commit/dd9145dd9c5a684aa918ca5ed10155293df2bb91)), closes [#5696](https://github.com/mochajs/mocha/issues/5696)\n\n\n### 🧹 Chores\n\n* Configure Renovate ([#5678](https://github.com/mochajs/mocha/issues/5678)) ([a9c9b90](https://github.com/mochajs/mocha/commit/a9c9b90098a831d82e69d82bfc7ce8c7aa749911))\n* **deps:** update dependency @rollup/plugin-alias to v6 ([#5718](https://github.com/mochajs/mocha/issues/5718)) ([267d751](https://github.com/mochajs/mocha/commit/267d751dd05270de4e18e0348584fbb12d90ce04))\n* **deps:** update dependency @rollup/plugin-commonjs to v29 ([#5719](https://github.com/mochajs/mocha/issues/5719)) ([9ed4ee5](https://github.com/mochajs/mocha/commit/9ed4ee55d975281ea54f237d23666d7b0307a596))\n* **deps:** update dependency astro to v5.17.1 ([#5703](https://github.com/mochajs/mocha/issues/5703)) ([ec3d1fa](https://github.com/mochajs/mocha/commit/ec3d1fa02e285a4430942942c11c376e63d395ca))\n* **deps:** update dependency chai to v4.5.0 ([#5705](https://github.com/mochajs/mocha/issues/5705)) ([870f9f8](https://github.com/mochajs/mocha/commit/870f9f8df7d1f9cace40bfc29a9b5b79a26ccb4e))\n* **deps:** update dependency cross-env to v10 ([#5721](https://github.com/mochajs/mocha/issues/5721)) ([20b7476](https://github.com/mochajs/mocha/commit/20b7476904592b356a48c3f89817e930c78f15cb))\n* **deps:** update dependency knip to v5.83.1 ([#5708](https://github.com/mochajs/mocha/issues/5708)) ([d833413](https://github.com/mochajs/mocha/commit/d833413622807c91cc2dea243c2be3518e2fe10b))\n* **deps:** update dependency npm-run-all2 to v8 ([#5727](https://github.com/mochajs/mocha/issues/5727)) ([e38e0ec](https://github.com/mochajs/mocha/commit/e38e0ec3dd91be11b2b999959e6245ec721168e3))\n* **deps:** update dependency prettier to v3.8.1 ([#5709](https://github.com/mochajs/mocha/issues/5709)) ([2f98cfd](https://github.com/mochajs/mocha/commit/2f98cfd1e3e9fce8a3c1a645f99a6b4b3b69ea6c))\n* **deps:** update dependency rimraf to v6 ([#5728](https://github.com/mochajs/mocha/issues/5728)) ([ba124e9](https://github.com/mochajs/mocha/commit/ba124e9161e5efd052df77dda50925c5666ccd6d))\n* **deps:** update dependency rollup to v4.57.1 ([#5710](https://github.com/mochajs/mocha/issues/5710)) ([178749d](https://github.com/mochajs/mocha/commit/178749da1bee978b5ef109a253337ae88206365c))\n* **deps:** update dependency unexpected-map to v3 ([#5736](https://github.com/mochajs/mocha/issues/5736)) ([c1f3379](https://github.com/mochajs/mocha/commit/c1f33798ab925c76c5f9a69dcb8c1ce71da2fbc9))\n* **deps:** update dependency unist-util-visit to v5.1.0 ([#5711](https://github.com/mochajs/mocha/issues/5711)) ([7ede894](https://github.com/mochajs/mocha/commit/7ede8943ff8f7925b51d4e4a226ee76b0a77619d))\n* **deps:** update dependency webdriverio to v9 ([#5739](https://github.com/mochajs/mocha/issues/5739)) ([ff334df](https://github.com/mochajs/mocha/commit/ff334df744c93f27c7cce08ced320833ee69cb2f))\n* **deps:** update dependency webpack-cli to v6 ([#5741](https://github.com/mochajs/mocha/issues/5741)) ([95c9d75](https://github.com/mochajs/mocha/commit/95c9d75120078e4c1fbb87d23f4fd7ec1f8a5405))\n* **deps:** update dependency workerpool to v9.3.4 ([#5715](https://github.com/mochajs/mocha/issues/5715)) ([c030a3b](https://github.com/mochajs/mocha/commit/c030a3bd4774db679ac8dc7d56e705975f1a1b6e))\n* **deps:** update remark ([#5745](https://github.com/mochajs/mocha/issues/5745)) ([37a25f1](https://github.com/mochajs/mocha/commit/37a25f174e6f3f16cae34923b86ab7d2504985ce))\n* fix timeout issue with some XUnit tests ([53cc467](https://github.com/mochajs/mocha/commit/53cc46755571ed53e32254fb7d896f599a1a7d1f))\n* switch Suite from util.inherits to ES2015 classes ([#5179](https://github.com/mochajs/mocha/issues/5179)) ([1ce690e](https://github.com/mochajs/mocha/commit/1ce690e590ca7bff7f47b108d3a5cc61dde6aa1b))\n\n\n### 🤖 Automation\n\n* **deps:** bump OctoGuide/bot in the github-actions group ([#5724](https://github.com/mochajs/mocha/issues/5724)) ([87224d8](https://github.com/mochajs/mocha/commit/87224d8400fa3b074f77a8ba1baadf7e0b99d864))\n* run `npm audit fix` ([#5695](https://github.com/mochajs/mocha/issues/5695)) ([c7b00b0](https://github.com/mochajs/mocha/commit/c7b00b0e4f03583c4dcc407f28a5453df436f32b))\n\n## [12.0.0-beta-9](https://github.com/mochajs/mocha/compare/v12.0.0-beta-8...v12.0.0-beta-9) (2026-02-13)\n\n\n### 🌟 Features\n\n* remove `log-symbols` dependency ([#5469](https://github.com/mochajs/mocha/issues/5469)) ([b92168f](https://github.com/mochajs/mocha/commit/b92168f5625be7343fb94d458d8a055cca8ff0a4))\n\n## [12.0.0-beta-8](https://github.com/mochajs/mocha/compare/v12.0.0-beta-7...v12.0.0-beta-8) (2026-02-06)\n\n\n### 🧹 Chores\n\n* use OIDC to publish to npm ([#5681](https://github.com/mochajs/mocha/issues/5681)) ([5567aed](https://github.com/mochajs/mocha/commit/5567aed50a00b63074d5c7703c6d8196dee92088))\n\n## [12.0.0-beta-7](https://github.com/mochajs/mocha/compare/v12.0.0-beta-6...v12.0.0-beta-7) (2026-02-03)\n\n\n### 🩹 Fixes\n\n* bump diff dependency to ^8.0.3 ([#5674](https://github.com/mochajs/mocha/issues/5674)) ([15fb31a](https://github.com/mochajs/mocha/commit/15fb31a8b25a4d03242e5c5f901ff3800889263e))\n* print helpful message when internal CLI error happens ([#5344](https://github.com/mochajs/mocha/issues/5344)) ([1e11836](https://github.com/mochajs/mocha/commit/1e118367dbb27f558edb7389985cca97d6d7da4b))\n\n\n### 📚 Documentation\n\n* update sponsor image to be larger ([#5659](https://github.com/mochajs/mocha/issues/5659)) ([bbe2bdb](https://github.com/mochajs/mocha/commit/bbe2bdbb69f7aa560645a5ab2cbd596dd0b43448))\n\n\n### 🧹 Chores\n\n* move nyc config changes from package.json into .nycrc ([#5668](https://github.com/mochajs/mocha/issues/5668)) ([e923e40](https://github.com/mochajs/mocha/commit/e923e4063f6a24dcaf7c6d7c7a3c8be998cb7980))\n* remove extra newline ([bbe2bdb](https://github.com/mochajs/mocha/commit/bbe2bdbb69f7aa560645a5ab2cbd596dd0b43448))\n\n## [12.0.0-beta-6](https://github.com/mochajs/mocha/compare/v12.0.0-beta-5...v12.0.0-beta-6) (2026-01-23)\n\n\n### 🩹 Fixes\n\n* allow chain call timeout to override nested items timeout ([#5612](https://github.com/mochajs/mocha/issues/5612)) ([5525da6](https://github.com/mochajs/mocha/commit/5525da60cf8d2596e14ff5441ea518d47bd732da))\n* import() fallback prevention ([#5647](https://github.com/mochajs/mocha/issues/5647)) ([6a78fa3](https://github.com/mochajs/mocha/commit/6a78fa39576ffb42700811661a94c9ac996707f2))\n\n\n### 🤖 Automation\n\n* **deps:** bump OctoGuide/bot in the github-actions group ([#5653](https://github.com/mochajs/mocha/issues/5653)) ([e06cce7](https://github.com/mochajs/mocha/commit/e06cce7a49b79a163e33db166e9b078b0d7b4001))\n\n## [12.0.0-beta-5](https://github.com/mochajs/mocha/compare/v12.0.0-beta-4...v12.0.0-beta-5) (2026-01-16)\n\n\n### 🌟 Features\n\n* add --fail-hook-affected-tests option to report skipped tests as failed ([#5519](https://github.com/mochajs/mocha/issues/5519)) ([0ed524a](https://github.com/mochajs/mocha/commit/0ed524af347b59200e03b972c2450d36f6818a45))\n\n\n### 📚 Documentation\n\n* add missing /next/* redirects ([#5627](https://github.com/mochajs/mocha/issues/5627)) ([8fa183d](https://github.com/mochajs/mocha/commit/8fa183d592b29346901b55e2fa479c8f598a1ec3))\n\n\n### 🧹 Chores\n\n* cleanup issue templates ([#5624](https://github.com/mochajs/mocha/issues/5624)) ([1972dd7](https://github.com/mochajs/mocha/commit/1972dd76ec66e8e11532bb6aca9157c4f8892d3c))\n* remove unused assets folder ([#5638](https://github.com/mochajs/mocha/issues/5638)) ([ddf8644](https://github.com/mochajs/mocha/commit/ddf864482ff66b1ca46ef7f08e63ca923222e717))\n* update spam filter ([#5645](https://github.com/mochajs/mocha/issues/5645)) ([cf945fb](https://github.com/mochajs/mocha/commit/cf945fb73b7c5a74f0856cabca5b5b1c8a6ff1c8))\n* update tagline ([#5635](https://github.com/mochajs/mocha/issues/5635)) ([8ff0209](https://github.com/mochajs/mocha/commit/8ff0209db575c8231eea77e6ab23e6fe95620c92))\n\n\n### 🤖 Automation\n\n* **deps:** bump OctoGuide/bot in the github-actions group ([#5648](https://github.com/mochajs/mocha/issues/5648)) ([fed6bbd](https://github.com/mochajs/mocha/commit/fed6bbdb891c518e61e8ef4bbf07ed46b469f860))\n* **docs/dev-deps:** use JS-native `fetch` to get supporters data instead of external `needle` ([#5643](https://github.com/mochajs/mocha/issues/5643)) ([e37e56f](https://github.com/mochajs/mocha/commit/e37e56fbe6a1072f1784ef87278d46f7ac48cdb8))\n* initial file implementation for ocotoguide ([#5608](https://github.com/mochajs/mocha/issues/5608)) ([a5f5c64](https://github.com/mochajs/mocha/commit/a5f5c6442505069573a17798a515f267c24a38f3))\n\n## [12.0.0-beta-4](https://github.com/mochajs/mocha/compare/v12.0.0-beta-3...v12.0.0-beta-4) (2026-01-04)\n\n\n### 🌟 Features\n\n* ESM configuration file ([#5397](https://github.com/mochajs/mocha/issues/5397)) ([dff9d78](https://github.com/mochajs/mocha/commit/dff9d7873f2d47a799e0adef338a7d6045ba0731))\n* migrate Markdown lint to `@eslint/markdown` ([#5593](https://github.com/mochajs/mocha/issues/5593)) ([d9e1f0a](https://github.com/mochajs/mocha/commit/d9e1f0aa7e39caa11edb81581c14cd02b3f40b3f))\n\n\n### 🩹 Fixes\n\n* remove `run` and use globalThis `setup` ([#5592](https://github.com/mochajs/mocha/issues/5592)) ([1544c39](https://github.com/mochajs/mocha/commit/1544c39dcd76916cca23a111c88eee8cbb781c24))\n\n\n### 📚 Documentation\n\n* fix v3_older changelog duplicate headings ([#5602](https://github.com/mochajs/mocha/issues/5602)) ([a750518](https://github.com/mochajs/mocha/commit/a7505180b64541ac71639ec3d1193f26e73527d9))\n\n\n### 🧹 Chores\n\n* **ci:** use OIDC token for trusted publishing to `npm` ([#5610](https://github.com/mochajs/mocha/issues/5610)) ([dc0fdb7](https://github.com/mochajs/mocha/commit/dc0fdb767fe46b885f7a0ccfb67acfb453156a3b))\n* create exclusions for nyc ([#5609](https://github.com/mochajs/mocha/issues/5609)) ([702473a](https://github.com/mochajs/mocha/commit/702473a54d9348948a63b4600171afa6956ccb0b))\n* **main:** release 12.0.0-beta-4 ([#5598](https://github.com/mochajs/mocha/issues/5598)) ([424516e](https://github.com/mochajs/mocha/commit/424516ed3c34c6716afbf554425cf5df439cd86c))\n* prevent unwanted Prettier rewrites ([#5591](https://github.com/mochajs/mocha/issues/5591)) ([3ea1578](https://github.com/mochajs/mocha/commit/3ea15789ddb4b77c591d9da36d2476ac359de00d))\n* remove broken browser-test.yml ([#5615](https://github.com/mochajs/mocha/issues/5615)) ([33ce345](https://github.com/mochajs/mocha/commit/33ce345f9ab4f47573a4994c5c01de6eda2af45d))\n* remove legacy `docs/` ([#5583](https://github.com/mochajs/mocha/issues/5583)) ([d8c310e](https://github.com/mochajs/mocha/commit/d8c310e3eddd235be55ad1891cde84c3be6f56f3))\n* revert \"chore(main): release 12.0.0-beta-4 ([#5598](https://github.com/mochajs/mocha/issues/5598))\" ([#5619](https://github.com/mochajs/mocha/issues/5619)) ([dba8091](https://github.com/mochajs/mocha/commit/dba809196541df415fac2681822f5cd35cf20442))\n\n\n### 🤖 Automation\n\n* **dep:** update `diff` from v7 to v8 ([#5605](https://github.com/mochajs/mocha/issues/5605)) ([8ca311c](https://github.com/mochajs/mocha/commit/8ca311c6c9b0d353b1c9d65b5751296d9baddd83))\n* update npm command for format ([#5603](https://github.com/mochajs/mocha/issues/5603)) ([c6a29cc](https://github.com/mochajs/mocha/commit/c6a29ccb38f81d65100cb2a0e6d73ad4303f58fb))\n\n## [12.0.0-beta-3](https://github.com/mochajs/mocha/compare/v12.0.0-beta-2...v12.0.0-beta-3) (2026-01-01)\n\n\n### 🌟 Features\n\n* add mocha.mjs export ([#5527](https://github.com/mochajs/mocha/issues/5527)) ([e1cf23c](https://github.com/mochajs/mocha/commit/e1cf23cbc2049a375ab9980337dbf2486450f7cb))\n* bump serialize-javascript from 6.0.2 to 7.0.2 ([#5589](https://github.com/mochajs/mocha/issues/5589)) ([24fb1b6](https://github.com/mochajs/mocha/commit/24fb1b6f8a45b4ca93b4577838bc1d9a47c74ec1))\n* bump strip-json-comments from 3 to 5 ([#5484](https://github.com/mochajs/mocha/issues/5484)) ([9b0db24](https://github.com/mochajs/mocha/commit/9b0db24740c65717dcd1838dcafccbfc1c538d3b))\n\n\n### 🩹 Fixes\n\n* allow importing ESM interface and reporters ([#5563](https://github.com/mochajs/mocha/issues/5563)) ([bc9fc84](https://github.com/mochajs/mocha/commit/bc9fc842213d00cf7ac4a4b0de898bf29e38bdad))\n* **docs-next:** backer's logo is consistent regardless of size ([#5594](https://github.com/mochajs/mocha/issues/5594)) ([1a53a10](https://github.com/mochajs/mocha/commit/1a53a100a4f3b83a725ccf3c166dcbefebca8602))\n* surface ts-node compile errors ([#5572](https://github.com/mochajs/mocha/issues/5572)) ([add4cf8](https://github.com/mochajs/mocha/commit/add4cf8166b330c9af4342def643c606459331d7))\n\n\n### 📚 Documentation\n\n* bumped docs-next Astro to ^5.16.6 ([#5574](https://github.com/mochajs/mocha/issues/5574)) ([806222b](https://github.com/mochajs/mocha/commit/806222b0998ffb4d09399090f4ec638e90974427))\n* fix light mode Astro accent text color ([#5585](https://github.com/mochajs/mocha/issues/5585)) ([9cc3ada](https://github.com/mochajs/mocha/commit/9cc3ada85b4ab4a4f2a8c7dc1b9d9ff8f101ffc1))\n* update Contributor License Agreement link in CONTRIBUTING.md ([#5567](https://github.com/mochajs/mocha/issues/5567)) ([410ce0d](https://github.com/mochajs/mocha/commit/410ce0d2a0f799aaca2c0bc627294d70c62dd3f4))\n\n\n### 🧹 Chores\n\n* normalized ESLint config to v9's recommended structure ([#5575](https://github.com/mochajs/mocha/issues/5575)) ([7f9ed1f](https://github.com/mochajs/mocha/commit/7f9ed1fb3480e0658c2c7d84c60a1b505c941ce5))\n* update Rollup to v4 ([#5510](https://github.com/mochajs/mocha/issues/5510)) ([cafa782](https://github.com/mochajs/mocha/commit/cafa782f010021e7055f8482ede2c02c6503f0a0))\n\n\n### 🤖 Automation\n\n* **dev-deps:** upgrade `eslint` from v8 to v9 ([#5559](https://github.com/mochajs/mocha/issues/5559)) ([bb24ca8](https://github.com/mochajs/mocha/commit/bb24ca8fde15471ff68d5b01b74c2d7e6047d966))\n* **dev-deps:** upgrade `markdownlint-cli` to latest v0.46.0 ([#5560](https://github.com/mochajs/mocha/issues/5560)) ([a124f1d](https://github.com/mochajs/mocha/commit/a124f1d3b7d0f8277962cae295cd43878294e183))\n* **dev-deps:** upgrade `nyc` from 15 to 17 ([#5556](https://github.com/mochajs/mocha/issues/5556)) ([599ab01](https://github.com/mochajs/mocha/commit/599ab013f526e78b3888a092a928ea4bc67138c0))\n\n## [12.0.0-beta-2](https://github.com/mochajs/mocha/compare/v12.0.0-beta-1...v12.0.0-beta-2) (2025-11-25)\n\n\n### 🧹 Chores\n\n* bump glob to version 13 ([#5546](https://github.com/mochajs/mocha/issues/5546)) ([f4d4ad2](https://github.com/mochajs/mocha/commit/f4d4ad23e9e994668c7d95c5a9bf59f581dccebf))\n\n## [12.0.0-beta-1](https://github.com/mochajs/mocha/compare/v11.7.4...v12.0.0-beta-1) (2025-11-25)\n\n\n### ⚠ BREAKING CHANGES\n\n* cleanup references of --compilers ([#5403](https://github.com/mochajs/mocha/issues/5403))\n* change the default of --forbid-only to check for process.env.CI ([#5496](https://github.com/mochajs/mocha/issues/5496))\n* bump minimum Node.js version from 18.18.0 to 20.19.0 ([#5477](https://github.com/mochajs/mocha/issues/5477))\n\n### 🌟 Features\n\n* allow FIFOs as test files ([#5512](https://github.com/mochajs/mocha/issues/5512)) ([ca4af43](https://github.com/mochajs/mocha/commit/ca4af439d5766fdfb2b5a7d7e06db0280b1abb6e))\n* bump minimum Node.js version from 18.18.0 to 20.19.0 ([#5477](https://github.com/mochajs/mocha/issues/5477)) ([1c34eef](https://github.com/mochajs/mocha/commit/1c34eef426f29e5e46ec348272ccaa869ae43922))\n* change the default of --forbid-only to check for process.env.CI ([#5496](https://github.com/mochajs/mocha/issues/5496)) ([3d94dde](https://github.com/mochajs/mocha/commit/3d94ddea2f45d18473bf00e71db2b9766ab227fe))\n* cleanup references of --compilers ([#5403](https://github.com/mochajs/mocha/issues/5403)) ([f75d150](https://github.com/mochajs/mocha/commit/f75d150cf6115334e7f14b8ee1fbbda04eb87087))\n\n\n### 🩹 Fixes\n\n* correct assertion import syntax in getting-started guide ([#5526](https://github.com/mochajs/mocha/issues/5526)) ([fb0215b](https://github.com/mochajs/mocha/commit/fb0215bd4fba44fde0cc7b8f9b91a4f07020a13b))\n* handle empty null-prototyped objects ([#5506](https://github.com/mochajs/mocha/issues/5506)) ([2a0bce0](https://github.com/mochajs/mocha/commit/2a0bce02f6f696c74fb8fdcd9f72089e82935903))\n\n\n### 📚 Documentation\n\n* add maintainer expectations to MAINTAINERS.md ([#5514](https://github.com/mochajs/mocha/issues/5514)) ([76f95a1](https://github.com/mochajs/mocha/commit/76f95a1113ea0472800ff6b1781f2750836a6db7))\n* migrate how-to wiki pages to main documentation ([#5463](https://github.com/mochajs/mocha/issues/5463)) ([b85aec6](https://github.com/mochajs/mocha/commit/b85aec6e4307903f31b2b8039dd749efc44ffcf5))\n* migrate programmatic usage to docs, development content to DEVELOPMENT.md ([#5464](https://github.com/mochajs/mocha/issues/5464)) ([cb47925](https://github.com/mochajs/mocha/commit/cb47925f99b39bd66bdd09218395bf5e0a54802d))\n* test/integration/README: remove ref to non-existent dir ([#5516](https://github.com/mochajs/mocha/issues/5516)) ([d2c2d40](https://github.com/mochajs/mocha/commit/d2c2d4026d0f6a09b96344f034e9cba9ee6277af))\n\n\n### 🧹 Chores\n\n* applied formatting to all files ([#5493](https://github.com/mochajs/mocha/issues/5493)) ([76d7194](https://github.com/mochajs/mocha/commit/76d719495d09dc4afb37d1179ede8911c52a011e))\n* fix broken link in .github/CONTRIBUTING.md ([681e843](https://github.com/mochajs/mocha/commit/681e843800051a9d3ab66c1bfb7ad71428e34315))\n* remove Node.js 18 from test-smoke in CI too ([d643105](https://github.com/mochajs/mocha/commit/d643105aa6f3fbac9d13e8a44f4c4c7302512193))\n* switch from Coveralls to Codecov ([#5447](https://github.com/mochajs/mocha/issues/5447)) ([f4e7e54](https://github.com/mochajs/mocha/commit/f4e7e54eb285765d7c50bce9c501db2e1b1e22be))\n* unpin node-version in release-please ([#5550](https://github.com/mochajs/mocha/issues/5550)) ([62c90cd](https://github.com/mochajs/mocha/commit/62c90cd2aea4c719d2014e7134b2a1d7c189fd7a))\n* use `ps-list` instead of `pidtree` to remove wmic ([#5479](https://github.com/mochajs/mocha/issues/5479)) ([b2985b3](https://github.com/mochajs/mocha/commit/b2985b3428b4b88ca220a14a26e9eb7139e8d445))\n\n\n### 🤖 Automation\n\n* **deps:** bump actions/checkout in the github-actions group ([#5547](https://github.com/mochajs/mocha/issues/5547)) ([561eb03](https://github.com/mochajs/mocha/commit/561eb039f7cfc36563a9583b17c7d4cb7ec30652))\n* **deps:** bump actions/setup-node in the github-actions group ([#5503](https://github.com/mochajs/mocha/issues/5503)) ([9a70533](https://github.com/mochajs/mocha/commit/9a7053349589344236b20301de965030eaabfea9))\n\n## [11.7.4](https://github.com/mochajs/mocha/compare/v11.7.3...v11.7.4) (2025-10-01)\n\n\n### 🩹 Fixes\n\n* watch mode using chokidar v4 ([#5379](https://github.com/mochajs/mocha/issues/5379)) ([c2667c3](https://github.com/mochajs/mocha/commit/c2667c3b3fca33c21306f59a1cca55bb7e1dac1f))\n\n\n### 📚 Documentation\n\n* migrate remaining legacy wiki pages to main documentation ([#5465](https://github.com/mochajs/mocha/issues/5465)) ([bff9166](https://github.com/mochajs/mocha/commit/bff91660733b71b124aad939538dee7747cfbeb8))\n\n\n### 🧹 Chores\n\n* remove trailing spaces ([#5475](https://github.com/mochajs/mocha/issues/5475)) ([7f68e5c](https://github.com/mochajs/mocha/commit/7f68e5c1565606bcebeb715b8591c52973d00dff))\n\n## [11.7.3](https://github.com/mochajs/mocha/compare/v11.7.2...v11.7.3) (2025-09-30)\n\n\n### 🩹 Fixes\n\n* use original require() error for TS files if ERR_UNKNOWN_FILE_EXTENSION ([#5408](https://github.com/mochajs/mocha/issues/5408)) ([ebdbc48](https://github.com/mochajs/mocha/commit/ebdbc487693254498de62068c59e3e43d078eff1))\n\n\n### 📚 Documentation\n\n* add security escalation policy ([#5466](https://github.com/mochajs/mocha/issues/5466)) ([4122c7d](https://github.com/mochajs/mocha/commit/4122c7d13d0941be451365397fbf43e1f3103027))\n* fix duplicate global leak documentation ([#5461](https://github.com/mochajs/mocha/issues/5461)) ([1164b9d](https://github.com/mochajs/mocha/commit/1164b9da895e56cf745acda2792e634080018ff6))\n* migrate third party UIs wiki page to docs ([#5434](https://github.com/mochajs/mocha/issues/5434)) ([6654704](https://github.com/mochajs/mocha/commit/66547045cb9bd2fa8209b34c36da2a5ef49d23fc))\n* update maintainer release notes for release-please ([#5453](https://github.com/mochajs/mocha/issues/5453)) ([185ae1e](https://github.com/mochajs/mocha/commit/185ae1eabe5c1e92c758bdfb398f7f47b6ef9483))\n\n\n### 🤖 Automation\n\n* **deps:** bump actions/setup-node in the github-actions group ([#5459](https://github.com/mochajs/mocha/issues/5459)) ([48c6f40](https://github.com/mochajs/mocha/commit/48c6f4068b5d22ebc49220900f0b53f8ecdc2b74))\n\n## [11.7.2](https://github.com/mochajs/mocha/compare/v11.7.1...v11.7.2) (2025-09-01)\n\n\n### 🩹 Fixes\n\n* fail with an informative error message on a file with a broken default import ([#5413](https://github.com/mochajs/mocha/issues/5413)) ([b0e6135](https://github.com/mochajs/mocha/commit/b0e61350594f2a044bf34ea153d1fab1e82e80cc))\n* load mjs files correctly ([#5429](https://github.com/mochajs/mocha/issues/5429)) ([a947b9b](https://github.com/mochajs/mocha/commit/a947b9b95501a35efa73c18aa57a74dad555c03a))\n\n\n### 📚 Documentation\n\n* add banner from old site to new site, link from new to old ([#5414](https://github.com/mochajs/mocha/issues/5414)) ([dedef11](https://github.com/mochajs/mocha/commit/dedef110a2af2f8632fb6c1b864fa0a46ad6ca9c))\n* add info on spies to legacy docs ([#5421](https://github.com/mochajs/mocha/issues/5421)) ([21f5544](https://github.com/mochajs/mocha/commit/21f554459c75f5a75b22556b6e2ac70d6ac0e9fc))\n* explain node import swallowing error ([#5401](https://github.com/mochajs/mocha/issues/5401)) ([09f5b2c](https://github.com/mochajs/mocha/commit/09f5b2c9de67ef40d5bd1775c3fca3bdb138f371))\n* fix links in new site ([#5416](https://github.com/mochajs/mocha/issues/5416)) ([b2bc769](https://github.com/mochajs/mocha/commit/b2bc769c6c8d87311ba0bdc9df8b9b588494eba5))\n* migrate assertion libraries wiki link to main docs ([#5442](https://github.com/mochajs/mocha/issues/5442)) ([95f3ca8](https://github.com/mochajs/mocha/commit/95f3ca8bc3a6c6af2932f7fd59a404768c0c6693))\n* migrate count assertions wiki page to docs ([#5438](https://github.com/mochajs/mocha/issues/5438)) ([02a306c](https://github.com/mochajs/mocha/commit/02a306c6cbf31f4eef7d4c9bf5e06c917d3efc11))\n* migrate shared behaviours to docs-next ([#5432](https://github.com/mochajs/mocha/issues/5432)) ([1dc4aa9](https://github.com/mochajs/mocha/commit/1dc4aa98eb3793865fa2a4da3373534dafc1c9a7))\n* migrate Spies wiki page to explainers ([#5420](https://github.com/mochajs/mocha/issues/5420)) ([cbcf007](https://github.com/mochajs/mocha/commit/cbcf007c5ae25f203863aac0b43eca1e8aefe093))\n* Migrate tagging wiki page to docs ([#5435](https://github.com/mochajs/mocha/issues/5435)) ([876247a](https://github.com/mochajs/mocha/commit/876247a8a636cc7bb1c3bf31390e7771182a090a))\n* migrate third party reporters wiki page to docs ([#5433](https://github.com/mochajs/mocha/issues/5433)) ([f70764c](https://github.com/mochajs/mocha/commit/f70764c9a56fcf12e316d5539788c7be0693b6a9))\n* migrate to global leak wiki page to docs ([#5437](https://github.com/mochajs/mocha/issues/5437)) ([8a6fdca](https://github.com/mochajs/mocha/commit/8a6fdcafccd94c888fae5e8be47dd29a604241b6))\n* update /next bug report link to be docs issue template ([#5424](https://github.com/mochajs/mocha/issues/5424)) ([668cb66](https://github.com/mochajs/mocha/commit/668cb66e1288051369ab144ccb50c840ebe34267))\n\n\n### 🧹 Chores\n\n* add issue form for ⚡️ Performance ([#5406](https://github.com/mochajs/mocha/issues/5406)) ([a908b3b](https://github.com/mochajs/mocha/commit/a908b3b86604d41d5751cccfaff505d7092c114f))\n* add test for `-R import-only-loader` ([#5391](https://github.com/mochajs/mocha/issues/5391)) ([6ee5b48](https://github.com/mochajs/mocha/commit/6ee5b483b8c29e0593c7765ad7a5c7b7f7764fc3))\n* also test Node.js 24 in CI ([#5405](https://github.com/mochajs/mocha/issues/5405)) ([15f5980](https://github.com/mochajs/mocha/commit/15f59805287f4c84ab8d057735a391a795be23f1))\n* bump CI to use 20.19.4, 22.18.0, 24.6.0 ([#5430](https://github.com/mochajs/mocha/issues/5430)) ([ace5eb4](https://github.com/mochajs/mocha/commit/ace5eb47a7926fe9d56ebcd95fd659c557a5be4d))\n* bump Knip to 5.61.2 ([#5394](https://github.com/mochajs/mocha/issues/5394)) ([f3d7430](https://github.com/mochajs/mocha/commit/f3d743061d6523f7077b21749089e6fb2f9c32e3))\n* cleanup references of --opts ([#5402](https://github.com/mochajs/mocha/issues/5402)) ([1096b37](https://github.com/mochajs/mocha/commit/1096b376c3c3bb9d4256c643ad35a459ed750928))\n* enabled ESLint's no-unused-vars ([#5399](https://github.com/mochajs/mocha/issues/5399)) ([d4168ae](https://github.com/mochajs/mocha/commit/d4168aef4c21f8fd119385da1cf1794a1ec5c2e1))\n* move callback and object typedefs to a new types.d.ts ([#5351](https://github.com/mochajs/mocha/issues/5351)) ([3300d21](https://github.com/mochajs/mocha/commit/3300d2155a1b06059fbe89c98a1d8bf979539019))\n* rewrite base path instead of copy-pasting ([#5431](https://github.com/mochajs/mocha/issues/5431)) ([c6c6740](https://github.com/mochajs/mocha/commit/c6c6740fb45da43510f86c1d22ea46ce9ee6a7ae))\n* unify caught errors as err ([#5439](https://github.com/mochajs/mocha/issues/5439)) ([d4912e7](https://github.com/mochajs/mocha/commit/d4912e705cf9ae1c3aa274b6449a6a0ff6d408c5))\n* Update experimental module detection test and pin exact Node versions ([#5417](https://github.com/mochajs/mocha/issues/5417)) ([2489090](https://github.com/mochajs/mocha/commit/2489090223f2629e4a380abe4cc6d46858ada922))\n\n\n### 🤖 Automation\n\n* **deps:** bump actions/checkout in the github-actions group ([#5419](https://github.com/mochajs/mocha/issues/5419)) ([03ac2d0](https://github.com/mochajs/mocha/commit/03ac2d0e6e75e95b3dc7fb08f2e1a1117d9718ca))\n\n## [11.7.1](https://github.com/mochajs/mocha/compare/v11.7.0...v11.7.1) (2025-06-24)\n\n\n### 🩹 Fixes\n\n* always fallback to import() if require() fails ([#5384](https://github.com/mochajs/mocha/issues/5384)) ([295c168](https://github.com/mochajs/mocha/commit/295c168628c2583245fb67d371b640309ba243ba))\n\n\n### 🧹 Chores\n\n* add esm loader test ([#5383](https://github.com/mochajs/mocha/issues/5383)) ([f58e49f](https://github.com/mochajs/mocha/commit/f58e49f08df2066e27f87f93ad7ee9cd6f91d225))\n\n## [11.7.0](https://github.com/mochajs/mocha/compare/v11.6.0...v11.7.0) (2025-06-18)\n\n\n### 🌟 Features\n\n* use require to load esm ([#5366](https://github.com/mochajs/mocha/issues/5366)) ([41e24a2](https://github.com/mochajs/mocha/commit/41e24a242944da0cfc9d4d6989dede85f648cb40))\n\n## [11.6.0](https://github.com/mochajs/mocha/compare/v11.5.0...v11.6.0) (2025-06-09)\n\n\n### 🌟 Features\n\n* bump workerpool from ^6.5.1 to ^9.2.0 ([#5350](https://github.com/mochajs/mocha/issues/5350)) ([581a3c5](https://github.com/mochajs/mocha/commit/581a3c554489855ac02860689d3f4ae772c2ea79))\n\n## [11.5.0](https://github.com/mochajs/mocha/compare/v11.4.0...v11.5.0) (2025-05-22)\n\n\n### 🌟 Features\n\n* bump mimimatch from ^5.1.6 to ^9.0.5 ([#5349](https://github.com/mochajs/mocha/issues/5349)) ([a3dea85](https://github.com/mochajs/mocha/commit/a3dea85b316e229ea95f51c715ad61708e9ab9a3))\n\n## [11.4.0](https://github.com/mochajs/mocha/compare/v11.3.0...v11.4.0) (2025-05-19)\n\n\n### 🌟 Features\n\n* bump diff from ^5.2.0 to ^7.0.0 ([#5348](https://github.com/mochajs/mocha/issues/5348)) ([554d6bb](https://github.com/mochajs/mocha/commit/554d6bbec92c3c938af0a533109749b6f3b7bd2c))\n\n\n### 📚 Documentation\n\n* added CHANGELOG.md note around 11.1 yargs-parser update ([#5362](https://github.com/mochajs/mocha/issues/5362)) ([618415d](https://github.com/mochajs/mocha/commit/618415d9c6fa3ef4e959207c8dd404f4703de7a7))\n\n## [11.3.0](https://github.com/mochajs/mocha/compare/v11.2.2...v11.3.0) (2025-05-16)\n\n\n### 🌟 Features\n\n* add option to use posix exit code upon fatal signal ([#4989](https://github.com/mochajs/mocha/issues/4989)) ([91bbf85](https://github.com/mochajs/mocha/commit/91bbf855012ee9b83700d3c563b517483de0831c))\n\n\n### 📚 Documentation\n\n* Deploy new site alongside old one ([#5360](https://github.com/mochajs/mocha/issues/5360)) ([6c96545](https://github.com/mochajs/mocha/commit/6c96545aee03efeee78c55feedcf70664426514c))\n* mention explicit browser support range ([#5354](https://github.com/mochajs/mocha/issues/5354)) ([c514c0b](https://github.com/mochajs/mocha/commit/c514c0bfad044f8450a63b2f9c6c781b9ce6f164))\n* update Node.js version requirements for 11.x ([#5329](https://github.com/mochajs/mocha/issues/5329)) ([abf3dd9](https://github.com/mochajs/mocha/commit/abf3dd921544b45c4c09eef8f7c9c3c4481a3d66))\n\n\n### 🧹 Chores\n\n* remove prerelease setting in release-please config ([#5363](https://github.com/mochajs/mocha/issues/5363)) ([8878f22](https://github.com/mochajs/mocha/commit/8878f222c418a0bf4fe170c17573c30b5ea2d567))\n\n## [11.2.2](https://github.com/mochajs/mocha/compare/v11.2.1...v11.2.2) (2025-04-10)\n\n\n### 🩹 Fixes\n\n* **deps:** update chokidar to v4 ([#5256](https://github.com/mochajs/mocha/issues/5256)) ([8af0f1a](https://github.com/mochajs/mocha/commit/8af0f1a9005a948fbefeb19be618a64dd910d39f))\n\n\n### 📚 Documentation\n\n* add ClientRedirects.astro ([#5324](https://github.com/mochajs/mocha/issues/5324)) ([b88d441](https://github.com/mochajs/mocha/commit/b88d441cc7616253892572778150998627d746ec))\n* add example/tests.html to docs-next ([#5325](https://github.com/mochajs/mocha/issues/5325)) ([6ec5762](https://github.com/mochajs/mocha/commit/6ec5762edd419578e9d3ce2fcc2b8dedcb0caf06))\n\n## [11.2.1](https://github.com/mochajs/mocha/compare/v11.2.0...v11.2.1) (2025-04-10)\n\n\n### 🩹 Fixes\n\n* switch from ansi-colors to picocolors ([#5323](https://github.com/mochajs/mocha/issues/5323)) ([7c08d09](https://github.com/mochajs/mocha/commit/7c08d0944d2255084bc4415238430b13c90f0df5))\n\n\n### 📚 Documentation\n\n* fix new website typos, improve readability ([#5312](https://github.com/mochajs/mocha/issues/5312)) ([fbceb19](https://github.com/mochajs/mocha/commit/fbceb19bbdad121f0100ec3434258775bd87aeaf))\n\n\n### 🧹 Chores\n\n* \"force\" Netlify to use npm to build new site ([#5319](https://github.com/mochajs/mocha/issues/5319)) ([3a46855](https://github.com/mochajs/mocha/commit/3a46855294f82e58a5a414aed3525e394b82aced))\n* Fix tests ([#5320](https://github.com/mochajs/mocha/issues/5320)) ([18699a0](https://github.com/mochajs/mocha/commit/18699a0d668ed2654dd15433f03b74348baf9559))\n\n## [11.2.0](https://github.com/mochajs/mocha/compare/v11.1.0...v11.2.0) (2025-03-17)\n\n\n### 🌟 Features\n\n* enable reporters to show relative paths of tests ([#5292](https://github.com/mochajs/mocha/issues/5292)) ([81ea666](https://github.com/mochajs/mocha/commit/81ea6667e9286c55ffa67977448b776a23c6da2d))\n\n\n### 📚 Documentation\n\n* add instructions for API docs ([#5287](https://github.com/mochajs/mocha/issues/5287)) ([b720ec1](https://github.com/mochajs/mocha/commit/b720ec1b3ca630a90f80311da391b2a0cdfead4e))\n* add new website using Astro Starlight ([#5246](https://github.com/mochajs/mocha/issues/5246)) ([b1f1cb7](https://github.com/mochajs/mocha/commit/b1f1cb78b655191b7a43dc962b513bf1b076890c))\n* improve third-party reporter docs ([#5285](https://github.com/mochajs/mocha/issues/5285)) ([c5a0ef5](https://github.com/mochajs/mocha/commit/c5a0ef523d52d8cab50e4a9b226af3790f54e75f))\n\n\n### 🧹 Chores\n\n* enabled eslint-plugin-n ([#5280](https://github.com/mochajs/mocha/issues/5280)) ([945d6e3](https://github.com/mochajs/mocha/commit/945d6e3bf5a9de19c3aa26fbdac966a721006b58))\n* pin node-lts tests to 22.11.0 ([#5279](https://github.com/mochajs/mocha/issues/5279)) ([664e1f4](https://github.com/mochajs/mocha/commit/664e1f49f7ae214a9666c90f388407e9fa100309))\n* replace `fs-extra` with newer `fs` built-ins ([#5284](https://github.com/mochajs/mocha/issues/5284)) ([75dcf8c](https://github.com/mochajs/mocha/commit/75dcf8c6c40ed1ce134ae5e174b6f4c4ca4d8c42))\n\n## [11.1.0](https://github.com/mochajs/mocha/compare/v11.0.2...v11.1.0) (2025-01-02)\n\n\n### 🌟 Features\n\n* bump yargs to 17 ([#5165](https://github.com/mochajs/mocha/issues/5165)) ([8f1c8d8](https://github.com/mochajs/mocha/commit/8f1c8d888b0104afcd95ca55a517320399755749))\n * Note that this also included a version bump of [`yargs-parser`](http://npmjs.com/package/yargs-parser) from `^20.2.9` to `^21.1.`, which fixed a bug that caused extra quotes in file paths to be removed.\n See [#5341](https://github.com/mochajs/mocha/issues/5341) for more information.\n* replace `strip-ansi` with `util.stripVTControlCharacters` ([#5267](https://github.com/mochajs/mocha/issues/5267)) ([3c191c0](https://github.com/mochajs/mocha/commit/3c191c05d9db1e99aec9b600edac2ce10a6b6d71)), closes [#5265](https://github.com/mochajs/mocha/issues/5265)\n\n## [11.0.2](https://github.com/mochajs/mocha/compare/v11.0.1...v11.0.2) (2024-12-09)\n\n\n### 🩹 Fixes\n\n* catch exceptions setting Error.stackTraceLimit ([#5254](https://github.com/mochajs/mocha/issues/5254)) ([259f8f8](https://github.com/mochajs/mocha/commit/259f8f8ba5709b5d84fa66e17cd10560a11f45c9))\n* error handling for unexpected numeric arguments passed to cli ([#5263](https://github.com/mochajs/mocha/issues/5263)) ([210d658](https://github.com/mochajs/mocha/commit/210d658678a2ec3b6f85c59d4b300b4722671099))\n\n\n### 📚 Documentation\n\n* correct outdated `status: accepting prs` link ([#5268](https://github.com/mochajs/mocha/issues/5268)) ([f729cd0](https://github.com/mochajs/mocha/commit/f729cd09b61bb598409f19b3c76b9e9536812237))\n* replace \"New in\" with \"Since\" in version annotations ([#5262](https://github.com/mochajs/mocha/issues/5262)) ([6f10d12](https://github.com/mochajs/mocha/commit/6f10d12c6c6dfa4df7d5221a3ce688f687aaf320))\n\n## [11.0.1](https://github.com/mochajs/mocha/compare/v11.0.0...v11.0.1) (2024-12-02)\n\n\n### 🌟 Features\n\n* bumped glob dependency from 8 to 10 ([#5250](https://github.com/mochajs/mocha/issues/5250)) ([43c3157](https://github.com/mochajs/mocha/commit/43c3157c6ef4f2d4bfecf3ad3a42479fd64187b8))\n\n\n### 📚 Documentation\n\n* fix examples for `linkPartialObjects` methods ([#5255](https://github.com/mochajs/mocha/issues/5255)) ([34e0e52](https://github.com/mochajs/mocha/commit/34e0e52e047a9119aeae9cb5b660a8438656a1e0))\n\n## [11.0.0](https://github.com/mochajs/mocha/compare/v10.8.2...v11.0.0) (2024-11-11)\n\n### ⚠ BREAKING CHANGES\n\n- adapt new engine range for Mocha 11 ([#5216](https://github.com/mochajs/mocha/issues/5216))\n\n### 🌟 Features\n\n- allow calling hook methods ([#5231](https://github.com/mochajs/mocha/issues/5231)) ([e3da641](https://github.com/mochajs/mocha/commit/e3da641b08bed20f12df524fc64cb9579f980c1e))\n\n### 🩹 Fixes\n\n- adapt new engine range for Mocha 11 ([#5216](https://github.com/mochajs/mocha/issues/5216)) ([80da25a](https://github.com/mochajs/mocha/commit/80da25a4132ca50d3ad35087cb62c9b0f8fc946a))\n\n### 📚 Documentation\n\n- downgrade example/tests chai to 4.5.0 ([#5245](https://github.com/mochajs/mocha/issues/5245)) ([eac87e1](https://github.com/mochajs/mocha/commit/eac87e10f49207a9b388f87d77d198583c6f889a))\n\n## [10.8.2](https://github.com/mochajs/mocha/compare/v10.8.1...v10.8.2) (2024-10-30)\n\n### 🩹 Fixes\n\n- support errors with circular dependencies in object values with --parallel ([#5212](https://github.com/mochajs/mocha/issues/5212)) ([ba0fefe](https://github.com/mochajs/mocha/commit/ba0fefe10b08a689cf49edc3818026938aa3a240))\n- test link in html reporter ([#5224](https://github.com/mochajs/mocha/issues/5224)) ([f054acc](https://github.com/mochajs/mocha/commit/f054acc1f60714bbe00ad1ab270fb4977836d045))\n\n### 📚 Documentation\n\n- indicate 'exports' interface does not work in browsers ([#5181](https://github.com/mochajs/mocha/issues/5181)) ([14e640e](https://github.com/mochajs/mocha/commit/14e640ee49718d587779a9594b18f3796c42cf2a))\n\n### 🧹 Chores\n\n- fix docs builds by re-adding eleventy and ignoring gitignore again ([#5240](https://github.com/mochajs/mocha/issues/5240)) ([881e3b0](https://github.com/mochajs/mocha/commit/881e3b0ca2e24284aab2a04f63639a0aa9e0ad1b))\n\n### 🤖 Automation\n\n- **deps:** bump the github-actions group with 1 update ([#5132](https://github.com/mochajs/mocha/issues/5132)) ([e536ab2](https://github.com/mochajs/mocha/commit/e536ab25b308774e3103006c044cb996a2e17c87))\n\n## [10.8.1](https://github.com/mochajs/mocha/compare/v10.8.0...v10.8.1) (2024-10-29)\n\n### 🩹 Fixes\n\n- handle case of invalid package.json with no explicit config ([#5198](https://github.com/mochajs/mocha/issues/5198)) ([f72bc17](https://github.com/mochajs/mocha/commit/f72bc17cb44164bcfff7abc83d0d37d99a061104))\n- Typos on mochajs.org ([#5237](https://github.com/mochajs/mocha/issues/5237)) ([d8ca270](https://github.com/mochajs/mocha/commit/d8ca270a960554c9d5c5fbf264e89d668d01ff0d))\n- use accurate test links in HTML reporter ([#5228](https://github.com/mochajs/mocha/issues/5228)) ([68803b6](https://github.com/mochajs/mocha/commit/68803b685d55dcccc51fa6ccfd27701cda4e26ed))\n\n## [10.8.0](https://github.com/mochajs/mocha/compare/v10.7.3...v10.8.0) (2024-10-29)\n\n### 🌟 Features\n\n- highlight browser failures ([#5222](https://github.com/mochajs/mocha/issues/5222)) ([8ff4845](https://github.com/mochajs/mocha/commit/8ff48453a8b12d9cacf56b0c0c544c8256af64c7))\n\n### 🩹 Fixes\n\n- remove `:is()` from `mocha.css` to support older browsers ([#5225](https://github.com/mochajs/mocha/issues/5225)) ([#5227](https://github.com/mochajs/mocha/issues/5227)) ([0a24b58](https://github.com/mochajs/mocha/commit/0a24b58477ea8ad146afc798930800b02c08790a))\n\n### 📚 Documentation\n\n- add `SECURITY.md` pointing to Tidelift ([#5210](https://github.com/mochajs/mocha/issues/5210)) ([bd7e63a](https://github.com/mochajs/mocha/commit/bd7e63a1f6d98535ce1ed1ecdb57b3e4db8a33c5))\n- adopt Collective Funds Guidelines 0.1 ([#5199](https://github.com/mochajs/mocha/issues/5199)) ([2b03d86](https://github.com/mochajs/mocha/commit/2b03d865eec63d627ff229e07d777f25061260d4))\n- update README, LICENSE and fix outdated ([#5197](https://github.com/mochajs/mocha/issues/5197)) ([1203e0e](https://github.com/mochajs/mocha/commit/1203e0ed739bbbf12166078738357fdb29a8c000))\n\n### 🧹 Chores\n\n- fix npm scripts on windows ([#5219](https://github.com/mochajs/mocha/issues/5219)) ([1173da0](https://github.com/mochajs/mocha/commit/1173da0bf614e8d2a826687802ee8cbe8671ccf1))\n- remove trailing whitespace in SECURITY.md ([7563e59](https://github.com/mochajs/mocha/commit/7563e59ae3c78ada305d26eadb86998ab54342da))\n\n## [10.7.3](https://github.com/mochajs/mocha/compare/v10.7.2...v10.7.3) (2024-08-09)\n\n### 🩹 Fixes\n\n- make release-please build work ([#5194](https://github.com/mochajs/mocha/issues/5194)) ([afd66ef](https://github.com/mochajs/mocha/commit/afd66ef3df20fab51ce38b97216c09108e5c2bfd))\n\n## [10.7.2](https://github.com/mochajs/mocha/compare/v10.7.1...v10.7.2) (2024-08-06)\n\n### 📚 Documentation\n\n- improve filtering ([#5191](https://github.com/mochajs/mocha/issues/5191)) ([1ac5b55](https://github.com/mochajs/mocha/commit/1ac5b552e3f32694d349023cb7f6196ba92b180e))\n\n### 🧹 Chores\n\n- fix failing markdown linting ([#5193](https://github.com/mochajs/mocha/issues/5193)) ([7e7a2ec](https://github.com/mochajs/mocha/commit/7e7a2ecb9bf8daba7e885a880bd8314b7b6fe07d))\n\n## [10.7.1](https://github.com/mochajs/mocha/compare/v10.7.0...v10.7.1) (2024-08-06)\n\n### 🩹 Fixes\n\n- crash with --parallel and --retries both enabled ([#5173](https://github.com/mochajs/mocha/issues/5173)) ([d7013dd](https://github.com/mochajs/mocha/commit/d7013ddb1099cfafe66a1af9640370998290e62c))\n\n### 🧹 Chores\n\n- add knip to validate included dependencies ([5c2989f](https://github.com/mochajs/mocha/commit/5c2989fcc7ae17618d9db16d7c99e23dfb1d38ee))\n- more fully remove assetgraph-builder and canvas ([#5175](https://github.com/mochajs/mocha/issues/5175)) ([1883c41](https://github.com/mochajs/mocha/commit/1883c41a49fad009bd407efc1bece3a5c75fd10a))\n- replace `nps` with npm scripts ([#5128](https://github.com/mochajs/mocha/issues/5128)) ([c44653a](https://github.com/mochajs/mocha/commit/c44653a3a04b8418ec24a942fa7513a4673f3667)), closes [#5126](https://github.com/mochajs/mocha/issues/5126)\n\n## 10.7.0 / 2024-07-20\n\n### :tada: Enhancements\n\n- [#4771](https://github.com/mochajs/mocha/pull/4771) feat: add option to not fail on failing test suite ([**@ilgonmic**](https://github.com/ilgonmic))\n\n## 10.6.1 / 2024-07-20\n\n### :bug: Fixes\n\n- [#3825](https://github.com/mochajs/mocha/pull/3825) fix: do not exit when only unref'd timer is present in test code ([**@boneskull**](https://github.com/boneskull))\n- [#5040](https://github.com/mochajs/mocha/pull/5040) fix: support canonical module ([**@JacobLey**](https://github.com/JacobLey))\n\n## 10.6.0 / 2024-07-02\n\n### :tada: Enhancements\n\n- [#5150](https://github.com/mochajs/mocha/pull/5150) feat: allow ^ versions for character encoding packages ([**@JoshuaKGoldberg**](https://github.com/JoshuaKGoldberg))\n- [#5151](https://github.com/mochajs/mocha/pull/5151) feat: allow ^ versions for file matching packages ([**@JoshuaKGoldberg**](https://github.com/JoshuaKGoldberg))\n- [#5152](https://github.com/mochajs/mocha/pull/5152) feat: allow ^ versions for yargs packages ([**@JoshuaKGoldberg**](https://github.com/JoshuaKGoldberg))\n- [#5153](https://github.com/mochajs/mocha/pull/5153) feat: allow ^ versions for data serialization packages ([**@JoshuaKGoldberg**](https://github.com/JoshuaKGoldberg))\n- [#5154](https://github.com/mochajs/mocha/pull/5154) feat: allow ^ versions for miscellaneous packages ([**@JoshuaKGoldberg**](https://github.com/JoshuaKGoldberg))\n\n## 10.5.2 / 2024-06-25\n\n### :bug: Fixes\n\n- [#5032](https://github.com/mochajs/mocha/pull/5032) fix: better tracking of seen objects in error serialization ([**@sam-super**](https://github.com/sam-super))\n\n## 10.5.1 / 2024-06-24\n\n### :bug: Fixes\n\n- [#5086](https://github.com/mochajs/mocha/pull/5086) fix: Add error handling for nonexistent file case with --file option ([**@khoaHyh**](https://github.com/khoaHyh))\n\n## 10.5.0 / 2024-06-24\n\n### :tada: Enhancements\n\n- [#5015](https://github.com/mochajs/mocha/pull/5015) feat: use \\ and \\ for browser progress indicator instead of \\ ([**@yourWaifu**](https://github.com/yourWaifu))\n- [#5143](https://github.com/mochajs/mocha/pull/5143) feat: allow using any 3.x chokidar dependencies ([**@simhnna**](https://github.com/simhnna))\n- [#4835](https://github.com/mochajs/mocha/pull/4835) feat: add MOCHA\\_OPTIONS env variable ([**@icholy**](https://github.com/icholy))\n\n### :bug: Fixes\n\n- [#5107](https://github.com/mochajs/mocha/pull/5107) fix: include stack in browser uncaught error reporting ([**@JoshuaKGoldberg**](https://github.com/JoshuaKGoldberg))\n\n### :nut\\_and\\_bolt: Other\n\n- [#5110](https://github.com/mochajs/mocha/pull/5110) chore: switch two-column list styles to be opt-in ([**@marjys**](https://github.com/marjys))\n- [#5135](https://github.com/mochajs/mocha/pull/5135) chore: fix some typos in comments ([**@StevenMia**](https://github.com/StevenMia))\n- [#5130](https://github.com/mochajs/mocha/pull/5130) chore: rename 'master' to 'main' in docs and tooling ([**@JoshuaKGoldberg**](https://github.com/JoshuaKGoldberg))\n\n## 10.4.0 / 2024-03-26\n\n### :tada: Enhancements\n\n- [#4829](https://github.com/mochajs/mocha/pull/4829) feat: include `.cause` stacks in the error stack traces ([**@voxpelli**](https://github.com/voxpelli))\n- [#4985](https://github.com/mochajs/mocha/pull/4985) feat: add file path to xunit reporter ([**@bmish**](https://github.com/bmish))\n\n### :bug: Fixes\n\n- [#5074](https://github.com/mochajs/mocha/pull/5074) fix: harden error handling in `lib/cli/run.js` ([**@stalet**](https://github.com/stalet))\n\n### :nut\\_and\\_bolt: Other\n\n- [#5077](https://github.com/mochajs/mocha/pull/5077) chore: add mtfoley/pr-compliance-action ([**@JoshuaKGoldberg**](https://github.com/JoshuaKGoldberg))\n- [#5060](https://github.com/mochajs/mocha/pull/5060) chore: migrate ESLint config to flat config ([**@JoshuaKGoldberg**](https://github.com/JoshuaKGoldberg))\n- [#5095](https://github.com/mochajs/mocha/pull/5095) chore: revert [#5069](https://github.com/mochajs/mocha/pull/5069) to restore Netlify builds ([**@voxpelli**](https://github.com/voxpelli))\n- [#5097](https://github.com/mochajs/mocha/pull/5097) docs: add sponsored to sponsorship link rels ([**@JoshuaKGoldberg**](https://github.com/JoshuaKGoldberg))\n- [#5093](https://github.com/mochajs/mocha/pull/5093) chore: add 'status: in triage' label to issue templates and docs ([**@JoshuaKGoldberg**](https://github.com/JoshuaKGoldberg))\n- [#5083](https://github.com/mochajs/mocha/pull/5083) docs: fix CHANGELOG.md headings to start with a root-level h1 ([**@JoshuaKGoldberg**](https://github.com/JoshuaKGoldberg))\n- [#5100](https://github.com/mochajs/mocha/pull/5100) chore: fix header generation and production build crashes ([**@JoshuaKGoldberg**](https://github.com/JoshuaKGoldberg))\n- [#5104](https://github.com/mochajs/mocha/pull/5104) chore: bump ESLint ecmaVersion to 2020 ([**@JoshuaKGoldberg**](https://github.com/JoshuaKGoldberg))\n- [#5116](https://github.com/mochajs/mocha/pull/5116) fix: eleventy template builds crash with 'unexpected token at \": string, msg...\"' ([**@LcsK**](https://github.com/LcsK))\n- [#4869](https://github.com/mochajs/mocha/pull/4869) docs: fix documentation concerning glob expansion on UNIX ([**@binki**](https://github.com/binki))\n- [#5122](https://github.com/mochajs/mocha/pull/5122) test: fix xunit integration test ([**@voxpelli**](https://github.com/voxpelli))\n- [#5123](https://github.com/mochajs/mocha/pull/5123) chore: activate dependabot for workflows ([**@voxpelli**](https://github.com/voxpelli))\n- [#5125](https://github.com/mochajs/mocha/pull/5125) build(deps): bump the github-actions group with 2 updates ([**@dependabot**](https://github.com/dependabot))\n\n## 10.3.0 / 2024-02-08\n\nThis is a stable release equivalent to [10.30.0-prerelease](#1030-prerelease--2024-01-18).\n\n## 10.3.0-prerelease / 2024-01-18\n\nThis is a prerelease version to test our ability to release.\nOther than removing or updating dependencies, it contains no intended user-facing changes.\n\n### :nut\\_and\\_bolt: Other\n\n- [#5069](https://github.com/mochajs/mocha/pull/5069): chore: remove unnecessary canvas dependency ([**@JoshuaKGoldberg**](https://github.com/JoshuaKGoldberg))\n- [#5068](https://github.com/mochajs/mocha/pull/5068): fix: add alt text to Built with Netlify badge ([**@JoshuaKGoldberg**](https://github.com/JoshuaKGoldberg))\n- [#5056](https://github.com/mochajs/mocha/pull/5056): chore: inline nyan reporter's write function ([**@JoshuaKGoldberg**](https://github.com/JoshuaKGoldberg))\n- [#5050](https://github.com/mochajs/mocha/pull/5050): docs: touchups to labels and a template title post-revamp ([**@JoshuaKGoldberg**](https://github.com/JoshuaKGoldberg))\n- [#5038](https://github.com/mochajs/mocha/pull/5038): docs: overhaul contributing and maintenance docs for end-of-year 2023 ([**@JoshuaKGoldberg**](https://github.com/JoshuaKGoldberg))\n- [#5029](https://github.com/mochajs/mocha/pull/5029): chore: remove stale workflow ([**@JoshuaKGoldberg**](https://github.com/JoshuaKGoldberg))\n- [#5024](https://github.com/mochajs/mocha/pull/5024): chore: remove nanoid as dependency ([**@Uzlopak**](https://github.com/Uzlopak))\n- [#5023](https://github.com/mochajs/mocha/pull/5023): chore: remove touch as dev dependency ([**@Uzlopak**](https://github.com/Uzlopak))\n- [#5022](https://github.com/mochajs/mocha/pull/5022): chore: remove uuid dev dependency ([**@Uzlopak**](https://github.com/Uzlopak))\n- [#5021](https://github.com/mochajs/mocha/pull/5021): update can-i-use ([**@Uzlopak**](https://github.com/Uzlopak))\n- [#5020](https://github.com/mochajs/mocha/pull/5020): chore: fix the ci ([**@Uzlopak**](https://github.com/Uzlopak))\n- [#4974](https://github.com/mochajs/mocha/pull/4974): Add Node v19 to test matrix ([**@juergba**](https://github.com/juergba))\n- [#4970](https://github.com/mochajs/mocha/pull/4970): fix [#4837](https://github.com/mochajs/mocha/issues/4837) Update glob due to vulnerability in dep ([**@jb2311**](https://github.com/jb2311))\n- [#4962](https://github.com/mochajs/mocha/pull/4962): Fix deprecated warn gh actions ([**@outsideris**](https://github.com/outsideris))\n- [#4927](https://github.com/mochajs/mocha/pull/4927): docs: use mocha.js instead of mocha in the example run ([**@nikolas**](https://github.com/nikolas))\n- [#4918](https://github.com/mochajs/mocha/pull/4918): docs: fix fragment ID for yargs' \"extends\" documentation ([**@Spencer-Doak**](https://github.com/Spencer-Doak))\n- [#4886](https://github.com/mochajs/mocha/pull/4886): docs: fix jsdoc return type of titlePath method ([**@F3n67u**](https://github.com/F3n67u))\n\n## 10.2.0 / 2022-12-11\n\n### :tada: Enhancements\n\n- [#4945](https://github.com/mochajs/mocha/issues/4945): API: add possibility to decorate ESM name before import ([**@j0tunn**](https://github.com/j0tunn))\n\n### :bug: Fixes\n\n- [#4946](https://github.com/mochajs/mocha/issues/4946): Browser: color of failed test icon ([**@kleisauke**](https://github.com/kleisauke))\n\n### :book: Documentation\n\n- [#4944](https://github.com/mochajs/mocha/issues/4944): Remove duplicated header ([**@PauloGoncalvesBH**](https://github.com/PauloGoncalvesBH))\n\n## 10.1.0 / 2022-10-16\n\n### :tada: Enhancements\n\n- [#4896](https://github.com/mochajs/mocha/issues/4896): Browser: add support for `prefers-color-scheme: dark` ([**@greggman**](https://github.com/greggman))\n\n### :nut\\_and\\_bolt: Other\n\n- [#4912](https://github.com/mochajs/mocha/issues/4912): Browser: increase contrast for replay buttons ([**@JoshuaKGoldberg**](https://github.com/JoshuaKGoldberg))\n- [#4905](https://github.com/mochajs/mocha/issues/4905): Use standard `Promise.allSettled` instead of polyfill ([**@outsideris**](https://github.com/outsideris))\n- [#4899](https://github.com/mochajs/mocha/issues/4899): Upgrade official GitHub actions to latest ([**@ddzz**](https://github.com/ddzz))\n- [#4770](https://github.com/mochajs/mocha/issues/4770): Fix regex in function `clean`([**@yetingli**](https://github.com/yetingli))\n\n## 10.0.0 / 2022-05-01\n\n### :boom: Breaking Changes\n\n- [#4845](https://github.com/mochajs/mocha/issues/4845): **Drop Node.js v12.x support** ([**@juergba**](https://github.com/juergba))\n\n- [#4848](https://github.com/mochajs/mocha/issues/4848): Drop Internet-Explorer-11 support ([**@juergba**](https://github.com/juergba))\n\n- [#4857](https://github.com/mochajs/mocha/issues/4857): Drop AMD/RequireJS support ([**@juergba**](https://github.com/juergba))\n\n- [#4866](https://github.com/mochajs/mocha/issues/4866): Drop Growl notification support ([**@juergba**](https://github.com/juergba))\n\n- [#4863](https://github.com/mochajs/mocha/issues/4863): Rename executable `bin/mocha` to `bin/mocha.js` ([**@juergba**](https://github.com/juergba))\n\n- [#4865](https://github.com/mochajs/mocha/issues/4865): `--ignore` option in Windows: upgrade Minimatch ([**@juergba**](https://github.com/juergba))\n\n- [#4861](https://github.com/mochajs/mocha/issues/4861): Remove deprecated `Runner` signature ([**@juergba**](https://github.com/juergba))\n\n### :nut\\_and\\_bolt: Other\n\n- [#4878](https://github.com/mochajs/mocha/issues/4878): Update production dependencies ([**@juergba**](https://github.com/juergba))\n\n- [#4876](https://github.com/mochajs/mocha/issues/4876): Add Node.js v18 to CI test matrix ([**@outsideris**](https://github.com/outsideris))\n\n- [#4852](https://github.com/mochajs/mocha/issues/4852): Replace deprecated `String.prototype.substr()` ([**@CommanderRoot**](https://github.com/CommanderRoot))\n\nAlso thanks to [**@ea2305**](https://github.com/ea2305) and [**@SukkaW**](https://github.com/SukkaW) for improvements to our documentation.\n\n## 9.2.2 / 2022-03-11\n\n### :bug: Fixes\n\n- [#4842](https://github.com/mochajs/mocha/issues/4842): Loading of reporter throws wrong error ([**@juergba**](https://github.com/juergba))\n\n- [#4839](https://github.com/mochajs/mocha/issues/4839): `dry-run`: prevent potential call-stack crash ([**@juergba**](https://github.com/juergba))\n\n### :nut\\_and\\_bolt: Other\n\n- [#4843](https://github.com/mochajs/mocha/issues/4843): Update production dependencies ([**@juergba**](https://github.com/juergba))\n\n## 9.2.1 / 2022-02-19\n\n### :bug: Fixes\n\n- [#4832](https://github.com/mochajs/mocha/issues/4832): Loading of config files throws wrong error ([**@juergba**](https://github.com/juergba))\n\n- [#4799](https://github.com/mochajs/mocha/issues/4799): Reporter: configurable `maxDiffSize` reporter-option ([**@norla**](https://github.com/norla))\n\n## 9.2.0 / 2022-01-24\n\n### :tada: Enhancements\n\n- [#4813](https://github.com/mochajs/mocha/issues/4813): Parallel: assign each worker a worker-id ([**@forty**](https://github.com/forty))\n\n### :nut\\_and\\_bolt: Other\n\n- [#4818](https://github.com/mochajs/mocha/issues/4818): Update production dependencies ([**@juergba**](https://github.com/juergba))\n\n## 9.1.4 / 2022-01-14\n\n### :bug: Fixes\n\n- [#4807](https://github.com/mochajs/mocha/issues/4807): `import` throws wrong error if loader is used ([**@giltayar**](https://github.com/giltayar))\n\n### :nut\\_and\\_bolt: Other\n\n- [#4777](https://github.com/mochajs/mocha/issues/4777): Add Node v17 to CI test matrix ([**@outsideris**](https://github.com/outsideris))\n\n## 9.1.3 / 2021-10-15\n\n### :bug: Fixes\n\n- [#4769](https://github.com/mochajs/mocha/issues/4769): Browser: re-enable `bdd` ES6 style import ([**@juergba**](https://github.com/juergba))\n\n### :nut\\_and\\_bolt: Other\n\n- [#4764](https://github.com/mochajs/mocha/issues/4764): Revert deprecation of `EVENT_SUITE_ADD_*` events ([**@beatfactor**](https://github.com/beatfactor))\n\n## 9.1.2 / 2021-09-25\n\n### :bug: Fixes\n\n- [#4746](https://github.com/mochajs/mocha/issues/4746): Browser: stop using all global vars in `browser-entry.js` ([**@PaperStrike**](https://github.com/PaperStrike))\n\n### :nut\\_and\\_bolt: Other\n\n- [#4754](https://github.com/mochajs/mocha/issues/4754): Remove dependency wide-align ([**@juergba**](https://github.com/juergba))\n- [#4736](https://github.com/mochajs/mocha/issues/4736): ESM: remove code for Node versions <10 ([**@juergba**](https://github.com/juergba))\n\n## 9.1.1 / 2021-08-28\n\n### :bug: Fixes\n\n- [#4623](https://github.com/mochajs/mocha/issues/4623): `XUNIT` and `JSON` reporter crash in `parallel` mode ([**@curtisman**](https://github.com/curtisman))\n\n## 9.1.0 / 2021-08-20\n\n### :tada: Enhancements\n\n- [#4716](https://github.com/mochajs/mocha/issues/4716): Add new option `--fail-zero` ([**@juergba**](https://github.com/juergba))\n- [#4691](https://github.com/mochajs/mocha/issues/4691): Add new option `--node-option` ([**@juergba**](https://github.com/juergba))\n- [#4607](https://github.com/mochajs/mocha/issues/4607): Add output option to `JSON` reporter ([**@dorny**](https://github.com/dorny))\n\n## 9.0.3 / 2021-07-25\n\n### :bug: Fixes\n\n- [#4702](https://github.com/mochajs/mocha/issues/4702): Error rethrow from cwd-relative path while loading `.mocharc.js` ([**@kirill-golovan**](https://github.com/kirill-golovan))\n\n- [#4688](https://github.com/mochajs/mocha/issues/4688): Usage of custom interface in parallel mode ([**@juergba**](https://github.com/juergba))\n\n- [#4687](https://github.com/mochajs/mocha/issues/4687): ESM: don't swallow `MODULE_NOT_FOUND` errors in case of `type:module` ([**@giltayar**](https://github.com/giltayar))\n\n## 9.0.2 / 2021-07-03\n\n### :bug: Fixes\n\n- [#4668](https://github.com/mochajs/mocha/issues/4668): ESM: make `--require ` work with new `import`-first loading ([**@giltayar**](https://github.com/giltayar))\n\n### :nut\\_and\\_bolt: Other\n\n- [#4674](https://github.com/mochajs/mocha/issues/4674): Update production dependencies ([**@juergba**](https://github.com/juergba))\n\n## 9.0.1 / 2021-06-18\n\n### :nut\\_and\\_bolt: Other\n\n- [#4657](https://github.com/mochajs/mocha/issues/4657): Browser: add separate bundle for modern browsers ([**@juergba**](https://github.com/juergba))\n\nWe added a separate browser bundle `mocha-es2018.js` in javascript ES2018, as we skipped the transpilation down to ES5. This is an **experimental step towards freezing Mocha's support of IE11**.\n\n- [#4653](https://github.com/mochajs/mocha/issues/4653): ESM: proper version check in `hasStableEsmImplementation` ([**@alexander-fenster**](https://github.com/alexander-fenster))\n\n## 9.0.0 / 2021-06-07\n\n### :boom: Breaking Changes\n\n- [#4633](https://github.com/mochajs/mocha/issues/4633): **Drop Node.js v10.x support** ([**@juergba**](https://github.com/juergba))\n\n- [#4635](https://github.com/mochajs/mocha/issues/4635): `import`-first loading of test files ([**@giltayar**](https://github.com/giltayar))\n\n**Mocha is going ESM-first!** This means that it will now use ESM `import(test_file)` to load the test files, instead of the CommonJS `require(test_file)`. This is not a problem, as `import` can also load most files that `require` does. In the rare cases where this fails, it will fallback to `require(...)`. This ESM-first approach is the next step in Mocha's ESM migration, and allows ESM loaders to load and transform the test file.\n\n- [#4636](https://github.com/mochajs/mocha/issues/4636): Remove deprecated `utils.lookupFiles()` ([**@juergba**](https://github.com/juergba))\n\n- [#4638](https://github.com/mochajs/mocha/issues/4638): Limit the size of `actual`/`expected` for `diff` generation ([**@juergba**](https://github.com/juergba))\n\n- [#4389](https://github.com/mochajs/mocha/issues/4389): Refactoring: Consuming log-symbols alternate to code for win32 in reporters/base ([**@MoonSupport**](https://github.com/MoonSupport))\n\n### :tada: Enhancements\n\n- [#4640](https://github.com/mochajs/mocha/issues/4640): Add new option `--dry-run` ([**@juergba**](https://github.com/juergba))\n\n### :bug: Fixes\n\n- [#4128](https://github.com/mochajs/mocha/issues/4128): Fix: control stringification of error message ([**@syeutyu**](https://github.com/syeutyu))\n\n### :nut\\_and\\_bolt: Other\n\n- [#4646](https://github.com/mochajs/mocha/issues/4646): Deprecate `Runner(suite: Suite, delay: boolean)` signature ([**@juergba**](https://github.com/juergba))\n- [#4643](https://github.com/mochajs/mocha/issues/4643): Update production dependencies ([**@juergba**](https://github.com/juergba))\n\n## 8.4.0 / 2021-05-07\n\n### :tada: Enhancements\n\n- [#4502](https://github.com/mochajs/mocha/issues/4502): CLI file parsing errors now have error codes ([**@evaline-ju**](https://github.com/evaline-ju))\n\n### :bug: Fixes\n\n- [#4614](https://github.com/mochajs/mocha/issues/4614): Watch: fix crash when reloading files ([**@outsideris**](https://github.com/outsideris))\n\n### :book: Documentation\n\n- [#4630](https://github.com/mochajs/mocha/issues/4630): Add `options.require` to Mocha constructor for `root hook` plugins on parallel runs ([**@juergba**](https://github.com/juergba))\n- [#4617](https://github.com/mochajs/mocha/issues/4617): Dynamically generating tests with `top-level await` and ESM test files ([**@juergba**](https://github.com/juergba))\n- [#4608](https://github.com/mochajs/mocha/issues/4608): Update default file extensions ([**@outsideris**](https://github.com/outsideris))\n\nAlso thanks to [**@outsideris**](https://github.com/outsideris) for various improvements on our GH actions workflows.\n\n## 8.3.2 / 2021-03-12\n\n### :bug: Fixes\n\n- [#4599](https://github.com/mochajs/mocha/issues/4599): Fix regression in `require` interface ([**@alexander-fenster**](https://github.com/alexander-fenster))\n\n### :book: Documentation\n\n- [#4601](https://github.com/mochajs/mocha/issues/4601): Add build to GH actions run ([**@christian-bromann**](https://github.com/christian-bromann))\n- [#4596](https://github.com/mochajs/mocha/issues/4596): Filter active sponsors/backers ([**@juergba**](https://github.com/juergba))\n- [#4225](https://github.com/mochajs/mocha/issues/4225): Update config file examples ([**@pkuczynski**](https://github.com/pkuczynski))\n\n## 8.3.1 / 2021-03-06\n\n### :bug: Fixes\n\n- [#4577](https://github.com/mochajs/mocha/issues/4577): Browser: fix `EvalError` caused by regenerator-runtime ([**@snoack**](https://github.com/snoack))\n- [#4574](https://github.com/mochajs/mocha/issues/4574): ESM: allow `import` from mocha in parallel mode ([**@nicojs**](https://github.com/nicojs))\n\n## 8.3.0 / 2021-02-11\n\n### :tada: Enhancements\n\n- [#4506](https://github.com/mochajs/mocha/issues/4506): Add error code for test timeout errors ([**@boneskull**](https://github.com/boneskull))\n- [#4112](https://github.com/mochajs/mocha/issues/4112): Add BigInt support to stringify util function ([**@JosejeSinohui**](https://github.com/JosejeSinohui))\n\n### :bug: Fixes\n\n- [#4557](https://github.com/mochajs/mocha/issues/4557): Add file location when SyntaxError happens in ESM ([**@giltayar**](https://github.com/giltayar))\n- [#4521](https://github.com/mochajs/mocha/issues/4521): Fix `require` error when bundling Mocha with Webpack ([**@devhazem**](https://github.com/devhazem))\n\n### :book: Documentation\n\n- [#4507](https://github.com/mochajs/mocha/issues/4507): Add support for typescript-style docstrings ([**@boneskull**](https://github.com/boneskull))\n- [#4503](https://github.com/mochajs/mocha/issues/4503): Add GH Actions workflow status badge ([**@outsideris**](https://github.com/outsideris))\n- [#4494](https://github.com/mochajs/mocha/issues/4494): Add example of generating tests dynamically with a closure ([**@maxwellgerber**](https://github.com/maxwellgerber))\n\n### :nut\\_and\\_bolt: Other\n\n- [#4556](https://github.com/mochajs/mocha/issues/4556): Upgrade all dependencies to latest stable ([**@AviVahl**](https://github.com/AviVahl))\n- [#4543](https://github.com/mochajs/mocha/issues/4543): Update dependencies yargs and yargs-parser ([**@juergba**](https://github.com/juergba))\n\nAlso thanks to [**@outsideris**](https://github.com/outsideris) and [**@HyunSangHan**](https://github.com/HyunSangHan) for various fixes to our website and documentation.\n\n## 8.2.1 / 2020-11-02\n\nFixed stuff.\n\n### :bug: Fixes\n\n- [#4489](https://github.com/mochajs/mocha/issues/4489): Fix problematic handling of otherwise-unhandled `Promise` rejections and erroneous \"`done()` called twice\" errors ([**@boneskull**](https://github.com/boneskull))\n- [#4496](https://github.com/mochajs/mocha/issues/4496): Avoid `MaxListenersExceededWarning` in watch mode ([**@boneskull**](https://github.com/boneskull))\n\nAlso thanks to [**@akeating**](https://github.com/akeating) for a documentation fix!\n\n## 8.2.0 / 2020-10-16\n\nThe major feature added in v8.2.0 is addition of support for [*global fixtures*](https://mochajs.org/#global-fixtures).\n\nWhile Mocha has always had the ability to run setup and teardown via a hook (e.g., a `before()` at the top level of a test file) when running tests in serial, Mocha v8.0.0 added support for parallel runs. Parallel runs are *incompatible* with this strategy; e.g., a top-level `before()` would only run for the file in which it was defined.\n\nWith [global fixtures](https://mochajs.org/#global-fixtures), Mocha can now perform user-defined setup and teardown *regardless* of mode, and these fixtures are guaranteed to run *once and only once*. This holds for parallel mode, serial mode, and even \"watch\" mode (the teardown will run once you hit Ctrl-C, just before Mocha finally exits). Tasks such as starting and stopping servers are well-suited to global fixtures, but not sharing resources--global fixtures do *not* share context with your test files (but they do share context with each other).\n\nHere's a short example of usage:\n\n```js\n// fixtures.js\n\n// can be async or not\nexports.mochaGlobalSetup = async function () {\n this.server = await startSomeServer({port: process.env.TEST_PORT});\n console.log(`server running on port ${this.server.port}`);\n};\n\nexports.mochaGlobalTeardown = async function () {\n // the context (`this`) is shared, but not with the test files\n await this.server.stop();\n console.log(`server on port ${this.server.port} stopped`);\n};\n\n// this file can contain root hook plugins as well!\n// exports.mochaHooks = { ... }\n```\n\nFixtures are loaded with `--require`, e.g., `mocha --require fixtures.js`.\n\nFor detailed information, please see the [documentation](https://mochajs.org/#global-fixtures) and this handy-dandy [flowchart](https://mochajs.org/#test-fixture-decision-tree-wizard-thing) to help understand the differences between hooks, root hook plugins, and global fixtures (and when you should use each).\n\n### :tada: Enhancements\n\n- [#4308](https://github.com/mochajs/mocha/issues/4308): Support run-once [global setup & teardown fixtures](https://mochajs.org/#global-fixtures) ([**@boneskull**](https://github.com/boneskull))\n- [#4442](https://github.com/mochajs/mocha/issues/4442): Multi-part extensions (e.g., `test.js`) now usable with `--extension` option ([**@jordanstephens**](https://github.com/jordanstephens))\n- [#4472](https://github.com/mochajs/mocha/issues/4472): Leading dots (e.g., `.js`, `.test.js`) now usable with `--extension` option ([**@boneskull**](https://github.com/boneskull))\n- [#4434](https://github.com/mochajs/mocha/issues/4434): Output of `json` reporter now contains `speed` (\"fast\"/\"medium\"/\"slow\") property ([**@wwhurin**](https://github.com/wwhurin))\n- [#4464](https://github.com/mochajs/mocha/issues/4464): Errors thrown by serializer in parallel mode now have error codes ([**@evaline-ju**](https://github.com/evaline-ju))\n\n*For implementors of custom reporters:*\n\n- [#4409](https://github.com/mochajs/mocha/issues/4409): Parallel mode and custom reporter improvements ([**@boneskull**](https://github.com/boneskull)):\n - Support custom worker-process-only reporters (`Runner.prototype.workerReporter()`); reporters should subclass `ParallelBufferedReporter` in `mocha/lib/nodejs/reporters/parallel-buffered`\n - Allow opt-in of object reference matching for \"sufficiently advanced\" custom reporters (`Runner.prototype.linkPartialObjects()`); use if strict object equality is needed when consuming `Runner` event data\n - Enable detection of parallel mode (`Runner.prototype.isParallelMode()`)\n\n### :bug: Fixes\n\n- [#4476](https://github.com/mochajs/mocha/issues/4476): Workaround for profoundly bizarre issue affecting `npm` v6.x causing some of Mocha's deps to be installed when `mocha` is present in a package's `devDependencies` and `npm install --production` is run the package's working copy ([**@boneskull**](https://github.com/boneskull))\n- [#4465](https://github.com/mochajs/mocha/issues/4465): Worker processes guaranteed (as opposed to \"very likely\") to exit before Mocha does; fixes a problem when using `nyc` with Mocha in parallel mode ([**@boneskull**](https://github.com/boneskull))\n- [#4419](https://github.com/mochajs/mocha/issues/4419): Restore `lookupFiles()` in `mocha/lib/utils`, which was broken/missing in Mocha v8.1.0; it now prints a deprecation warning (use `const {lookupFiles} = require('mocha/lib/cli')` instead) ([**@boneskull**](https://github.com/boneskull))\n\nThanks to [**@AviVahl**](https://github.com/AviVahl), [**@donghoon-song**](https://github.com/donghoon-song), [**@ValeriaVG**](https://github.com/ValeriaVG), [**@znarf**](https://github.com/znarf), [**@sujin-park**](https://github.com/sujin-park), and [**@majecty**](https://github.com/majecty) for other helpful contributions!\n\n## 8.1.3 / 2020-08-28\n\n### :bug: Fixes\n\n- [#4425](https://github.com/mochajs/mocha/issues/4425): Restore `Mocha.utils.lookupFiles()` and Webpack compatibility (both broken since v8.1.0); `Mocha.utils.lookupFiles()` is now **deprecated** and will be removed in the next major revision of Mocha; use `require('mocha/lib/cli').lookupFiles` instead ([**@boneskull**](https://github.com/boneskull))\n\n## 8.1.2 / 2020-08-25\n\n### :bug: Fixes\n\n- [#4418](https://github.com/mochajs/mocha/issues/4418): Fix command-line flag incompatibility in forthcoming Node.js v14.9.0 ([**@boneskull**](https://github.com/boneskull))\n- [#4401](https://github.com/mochajs/mocha/issues/4401): Fix missing global variable in browser ([**@irrationnelle**](https://github.com/irrationnelle))\n\n### :lock: Security Fixes\n\n- [#4396](https://github.com/mochajs/mocha/issues/4396): Update many dependencies ([**@GChuf**](https://github.com/GChuf))\n\n### :book: Documentation\n\n- Various fixes by [**@sujin-park**](https://github.com/sujin-park), [**@wwhurin**](https://github.com/wwhurin) & [**@Donghoon759**](https://github.com/Donghoon759)\n\n## 8.1.1 / 2020-08-04\n\n### :bug: Fixes\n\n- [#4394](https://github.com/mochajs/mocha/issues/4394): Fix regression wherein certain reporters did not correctly detect terminal width ([**@boneskull**](https://github.com/boneskull))\n\n## 8.1.0 / 2020-07-30\n\nIn this release, Mocha now builds its browser bundle with Rollup and Babel, which will provide the project's codebase more flexibility and consistency.\n\nWhile we've been diligent about backwards compatibility, it's *possible* consumers of the browser bundle will encounter differences (other than an increase in the bundle size). If you *do* encounter an issue with the build, please [report it here](https://github.com/mochajs/mocha/issues/new?labels=unconfirmed-bug\\&template=bug_report.md\\&title=).\n\nThis release **does not** drop support for IE11.\n\nOther community contributions came from [**@Devjeel**](https://github.com/Devjeel), [**@Harsha509**](https://github.com/Harsha509) and [**@sharath2106**](https://github.com/sharath2106). *Thank you* to everyone who contributed to this release!\n\n> Do you read Korean? See [this guide to running parallel tests in Mocha](https://blog.outsider.ne.kr/1489), translated by our maintainer, [**@outsideris**](https://github.com/outsideris).\n\n### :tada: Enhancements\n\n- [#4287](https://github.com/mochajs/mocha/issues/4287): Use background colors with inline diffs for better visual distinction ([**@michael-brade**](https://github.com/michael-brade))\n\n### :bug: Fixes\n\n- [#4328](https://github.com/mochajs/mocha/issues/4328): Fix \"watch\" mode when Mocha run in parallel ([**@boneskull**](https://github.com/boneskull))\n- [#4382](https://github.com/mochajs/mocha/issues/4382): Fix root hook execution in \"watch\" mode ([**@indieisaconcept**](https://github.com/indieisaconcept))\n- [#4383](https://github.com/mochajs/mocha/issues/4383): Consistent auto-generated hook titles ([**@cspotcode**](https://github.com/cspotcode))\n- [#4359](https://github.com/mochajs/mocha/issues/4359): Better errors when running `mocha init` ([**@boneskull**](https://github.com/boneskull))\n- [#4341](https://github.com/mochajs/mocha/issues/4341): Fix weirdness when using `delay` option in browser ([**@craigtaub**](https://github.com/craigtaub))\n\n### :lock: Security Fixes\n\n- [#4378](https://github.com/mochajs/mocha/issues/4378), [#4333](https://github.com/mochajs/mocha/issues/4333): Update [javascript-serialize](https://npm.im/javascript-serialize) ([**@martinoppitz**](https://github.com/martinoppitz), [**@wnghdcjfe**](https://github.com/wnghdcjfe))\n- [#4354](https://github.com/mochajs/mocha/issues/4354): Update [yargs-unparser](https://npm.im/yargs-unparser) ([**@martinoppitz**](https://github.com/martinoppitz))\n\n### :book: Documentation & Website\n\n- [#4173](https://github.com/mochajs/mocha/issues/4173): Document how to use `--enable-source-maps` with Mocha ([**@bcoe**](https://github.com/bcoe))\n- [#4343](https://github.com/mochajs/mocha/issues/4343): Clean up some API docs ([**@craigtaub**](https://github.com/craigtaub))\n- [#4318](https://github.com/mochajs/mocha/issues/4318): Sponsor images are now self-hosted ([**@Munter**](https://github.com/Munter))\n\n### :nut\\_and\\_bolt: Other\n\n- [#4293](https://github.com/mochajs/mocha/issues/4293): Use Rollup and Babel in build pipeline; add source map to published files ([**@Munter**](https://github.com/Munter))\n\n## 8.0.1 / 2020-06-10\n\nThe obligatory patch after a major.\n\n### :bug: Fixes\n\n- [#4328](https://github.com/mochajs/mocha/issues/4328): Fix `--parallel` when combined with `--watch` ([**@boneskull**](https://github.com/boneskull))\n\n## 8.0.0 / 2020-06-10\n\nIn this major release, Mocha adds the ability to *run tests in parallel*. Better late than never! Please note the **breaking changes** detailed below.\n\nLet's welcome [**@giltayar**](https://github.com/giltayar) and [**@nicojs**](https://github.com/nicojs) to the maintenance team!\n\n### :boom: Breaking Changes\n\n- [#4164](https://github.com/mochajs/mocha/issues/4164): **Mocha v8.0.0 now requires Node.js v10.12.0 or newer.** Mocha no longer supports the Node.js v8.x line (\"Carbon\"), which entered End-of-Life at the end of 2019 ([**@UlisesGascon**](https://github.com/UlisesGascon))\n\n- [#4175](https://github.com/mochajs/mocha/issues/4175): Having been deprecated with a warning since v7.0.0, **`mocha.opts` is no longer supported** ([**@juergba**](https://github.com/juergba))\n\n :sparkles: **WORKAROUND:** Replace `mocha.opts` with a [configuration file](https://mochajs.org/#configuring-mocha-nodejs).\n\n- [#4260](https://github.com/mochajs/mocha/issues/4260): Remove `enableTimeout()` (`this.enableTimeout()`) from the context object ([**@craigtaub**](https://github.com/craigtaub))\n\n :sparkles: **WORKAROUND:** Replace usage of `this.enableTimeout(false)` in your tests with `this.timeout(0)`.\n\n- [#4315](https://github.com/mochajs/mocha/issues/4315): The `spec` option no longer supports a comma-delimited list of files ([**@juergba**](https://github.com/juergba))\n\n :sparkles: **WORKAROUND**: Use an array instead (e.g., `\"spec\": \"foo.js,bar.js\"` becomes `\"spec\": [\"foo.js\", \"bar.js\"]`).\n\n- [#4309](https://github.com/mochajs/mocha/issues/4309): Drop support for Node.js v13.x line, which is now End-of-Life ([**@juergba**](https://github.com/juergba))\n\n- [#4282](https://github.com/mochajs/mocha/issues/4282): `--forbid-only` will throw an error even if exclusive tests are avoided via `--grep` or other means ([**@arvidOtt**](https://github.com/arvidOtt))\n\n- [#4223](https://github.com/mochajs/mocha/issues/4223): The context object's `skip()` (`this.skip()`) in a \"before all\" (`before()`) hook will no longer execute subsequent sibling hooks, in addition to hooks in child suites ([**@juergba**](https://github.com/juergba))\n\n- [#4178](https://github.com/mochajs/mocha/issues/4178): Remove previously soft-deprecated APIs ([**@wnghdcjfe**](https://github.com/wnghdcjfe)):\n\n - `Mocha.prototype.ignoreLeaks()`\n - `Mocha.prototype.useColors()`\n - `Mocha.prototype.useInlineDiffs()`\n - `Mocha.prototype.hideDiff()`\n\n### :tada: Enhancements\n\n- [#4245](https://github.com/mochajs/mocha/issues/4245): Add ability to run tests in parallel for Node.js (see [docs](https://mochajs.org/#parallel-tests)) ([**@boneskull**](https://github.com/boneskull))\n\n :exclamation: See also [#4244](https://github.com/mochajs/mocha/issues/4244); [Root Hook Plugins (docs)](https://mochajs.org/#root-hook-plugins) -- *root hooks must be defined via Root Hook Plugins to work in parallel mode*\n\n- [#4304](https://github.com/mochajs/mocha/issues/4304): `--require` now works with ES modules ([**@JacobLey**](https://github.com/JacobLey))\n\n- [#4299](https://github.com/mochajs/mocha/issues/4299): In some circumstances, Mocha can run ES modules under Node.js v10 -- *use at your own risk!* ([**@giltayar**](https://github.com/giltayar))\n\n### :book: Documentation\n\n- [#4246](https://github.com/mochajs/mocha/issues/4246): Add documentation for parallel mode and Root Hook plugins ([**@boneskull**](https://github.com/boneskull))\n\n### :nut\\_and\\_bolt: Other\n\n- [#4200](https://github.com/mochajs/mocha/issues/4200): Drop mkdirp and replace it with fs.mkdirSync ([**@HyunSangHan**](https://github.com/HyunSangHan))\n\n### :bug: Fixes\n\n(All bug fixes in Mocha v8.0.0 are also breaking changes, and are listed above)\n\n## 7.2.0 / 2020-05-22\n\n### :tada: Enhancements\n\n- [#4234](https://github.com/mochajs/mocha/issues/4234): Add ability to run tests in a mocha instance multiple times ([**@nicojs**](https://github.com/nicojs))\n- [#4219](https://github.com/mochajs/mocha/issues/4219): Exposing filename in JSON, doc, and json-stream reporters ([**@Daniel0113**](https://github.com/Daniel0113))\n- [#4244](https://github.com/mochajs/mocha/issues/4244): Add Root Hook Plugins ([**@boneskull**](https://github.com/boneskull))\n\n### :bug: Fixes\n\n- [#4258](https://github.com/mochajs/mocha/issues/4258): Fix missing dot in name of configuration file ([**@sonicdoe**](https://github.com/sonicdoe))\n- [#4194](https://github.com/mochajs/mocha/issues/4194): Check if module.paths really exists ([**@ematipico**](https://github.com/ematipico))\n- [#4256](https://github.com/mochajs/mocha/issues/4256): `--forbid-only` does not recognize `it.only` when `before` crashes ([**@arvidOtt**](https://github.com/arvidOtt))\n- [#4152](https://github.com/mochajs/mocha/issues/4152): Bug with multiple async done() calls ([**@boneskull**](https://github.com/boneskull))\n- [#4275](https://github.com/mochajs/mocha/issues/4275): Improper warnings for invalid reporters ([**@boneskull**](https://github.com/boneskull))\n- [#4288](https://github.com/mochajs/mocha/issues/4288): Broken hook.spec.js test for IE11 ([**@boneskull**](https://github.com/boneskull))\n\n### :book: Documentation\n\n- [#4081](https://github.com/mochajs/mocha/issues/4081): Insufficient white space for API docs in view on mobile ([**@HyunSangHan**](https://github.com/HyunSangHan))\n- [#4255](https://github.com/mochajs/mocha/issues/4255): Update mocha-docdash for UI fixes on API docs ([**@craigtaub**](https://github.com/craigtaub))\n- [#4235](https://github.com/mochajs/mocha/issues/4235): Enable emoji on website; enable normal ul elements ([**@boneskull**](https://github.com/boneskull))\n- [#4272](https://github.com/mochajs/mocha/issues/4272): Fetch sponsors at build time, show ALL non-skeevy sponsors ([**@boneskull**](https://github.com/boneskull))\n\n### :nut\\_and\\_bolt: Other\n\n- [#4249](https://github.com/mochajs/mocha/issues/4249): Refactoring improving encapsulation ([**@arvidOtt**](https://github.com/arvidOtt))\n- [#4242](https://github.com/mochajs/mocha/issues/4242): CI add job names, add Node.js v14 to matrix ([**@boneskull**](https://github.com/boneskull))\n- [#4237](https://github.com/mochajs/mocha/issues/4237): Refactor validatePlugins to throw coded errors ([**@boneskull**](https://github.com/boneskull))\n- [#4236](https://github.com/mochajs/mocha/issues/4236): Better debug output ([**@boneskull**](https://github.com/boneskull))\n\n## 7.1.2 / 2020-04-26\n\n### :nut\\_and\\_bolt: Other\n\n- [#4251](https://github.com/mochajs/mocha/issues/4251): Prevent karma-mocha from stalling ([**@juergba**](https://github.com/juergba))\n- [#4222](https://github.com/mochajs/mocha/issues/4222): Update dependency mkdirp to v0.5.5 ([**@outsideris**](https://github.com/outsideris))\n\n### :book: Documentation\n\n- [#4208](https://github.com/mochajs/mocha/issues/4208): Add Wallaby logo to site ([**@boneskull**](https://github.com/boneskull))\n\n## 7.1.1 / 2020-03-18\n\n### :lock: Security Fixes\n\n- [#4204](https://github.com/mochajs/mocha/issues/4204): Update dependencies mkdirp, yargs-parser and yargs ([**@juergba**](https://github.com/juergba))\n\n### :bug: Fixes\n\n- [#3660](https://github.com/mochajs/mocha/issues/3660): Fix `runner` listening to `start` and `end` events ([**@juergba**](https://github.com/juergba))\n\n### :book: Documentation\n\n- [#4190](https://github.com/mochajs/mocha/issues/4190): Show Netlify badge on footer ([**@outsideris**](https://github.com/outsideris))\n\n## 7.1.0 / 2020-02-26\n\n### :tada: Enhancements\n\n[#4038](https://github.com/mochajs/mocha/issues/4038): Add Node.js native ESM support ([**@giltayar**](https://github.com/giltayar))\n\nMocha supports writing your test files as ES modules:\n\n- Node.js only v12.11.0 and above\n- Node.js below v13.2.0, you must set `--experimental-modules` option\n- current limitations: please check our [documentation](https://mochajs.org/#nodejs-native-esm-support)\n- for programmatic usage: see [API: loadFilesAsync()](https://mochajs.org/api/mocha#loadFilesAsync)\n\n**Note:** Node.JS native [ECMAScript Modules](https://nodejs.org/api/esm.html) implementation has status: **Stability: 1 - Experimental**\n\n### :bug: Fixes\n\n- [#4181](https://github.com/mochajs/mocha/issues/4181): Programmatic API cannot access retried test objects ([**@juergba**](https://github.com/juergba))\n- [#4174](https://github.com/mochajs/mocha/issues/4174): Browser: fix `allowUncaught` option ([**@juergba**](https://github.com/juergba))\n\n### :book: Documentation\n\n- [#4058](https://github.com/mochajs/mocha/issues/4058): Manage author list in AUTHORS instead of `package.json` ([**@outsideris**](https://github.com/outsideris))\n\n### :nut\\_and\\_bolt: Other\n\n- [#4138](https://github.com/mochajs/mocha/issues/4138): Upgrade ESLint v6.8 ([**@kaicataldo**](https://github.com/kaicataldo))\n\n## 7.0.1 / 2020-01-25\n\n### :bug: Fixes\n\n- [#4165](https://github.com/mochajs/mocha/issues/4165): Fix exception when skipping tests programmatically ([**@juergba**](https://github.com/juergba))\n- [#4153](https://github.com/mochajs/mocha/issues/4153): Restore backwards compatibility for `reporterOptions` ([**@holm**](https://github.com/holm))\n- [#4150](https://github.com/mochajs/mocha/issues/4150): Fix recovery of an open test upon uncaught exception ([**@juergba**](https://github.com/juergba))\n- [#4147](https://github.com/mochajs/mocha/issues/4147): Fix regression of leaking uncaught exception handler ([**@juergba**](https://github.com/juergba))\n\n### :book: Documentation\n\n- [#4146](https://github.com/mochajs/mocha/issues/4146): Update copyright & trademark notices per OJSF ([**@boneskull**](https://github.com/boneskull))\n- [#4140](https://github.com/mochajs/mocha/issues/4140): Fix broken links ([**@KyoungWan**](https://github.com/KyoungWan))\n\n### :nut\\_and\\_bolt: Other\n\n- [#4133](https://github.com/mochajs/mocha/issues/4133): Print more descriptive error message ([**@Zirak**](https://github.com/Zirak))\n\n## 7.0.0 / 2020-01-05\n\n### :boom: Breaking Changes\n\n- [#3885](https://github.com/mochajs/mocha/issues/3885): **Drop Node.js v6.x support** ([**@mojosoeun**](https://github.com/mojosoeun))\n- [#3890](https://github.com/mochajs/mocha/issues/3890): Remove Node.js debug-related flags `--debug`/`--debug-brk` and deprecate `debug` argument ([**@juergba**](https://github.com/juergba))\n- [#3962](https://github.com/mochajs/mocha/issues/3962): Changes to command-line options ([**@ParkSB**](https://github.com/ParkSB)):\n - `--list-interfaces` replaces `--interfaces`\n - `--list-reporters` replaces `--reporters`\n- Hook pattern of `this.skip()` ([**@juergba**](https://github.com/juergba)):\n - [#3859](https://github.com/mochajs/mocha/issues/3859): When conditionally skipping in a `it` test, related `afterEach` hooks are now executed\n - [#3741](https://github.com/mochajs/mocha/issues/3741): When conditionally skipping in a `beforeEach` hook, subsequent inner `beforeEach` hooks are now skipped and related `afterEach` hooks are executed\n - [#4136](https://github.com/mochajs/mocha/issues/4136): Disallow `this.skip()` within `after` hooks\n- [#3967](https://github.com/mochajs/mocha/issues/3967): Remove deprecated `getOptions()` and `lib/cli/options.js` ([**@juergba**](https://github.com/juergba))\n- [#4083](https://github.com/mochajs/mocha/issues/4083): Uncaught exception in `pending` test: don't swallow, but retrospectively fail the test for correct exit code ([**@juergba**](https://github.com/juergba))\n- [#4004](https://github.com/mochajs/mocha/issues/4004): Align `Mocha` constructor's option names with command-line options ([**@juergba**](https://github.com/juergba))\n\n### :tada: Enhancements\n\n- [#3980](https://github.com/mochajs/mocha/issues/3980): Refactor and improve `--watch` mode with chokidar ([**@geigerzaehler**](https://github.com/geigerzaehler)):\n - adds command-line options `--watch-files` and `--watch-ignore`\n - removes `--watch-extensions`\n- [#3979](https://github.com/mochajs/mocha/issues/3979): Type \"rs\\n\" to restart tests ([**@broofa**](https://github.com/broofa))\n\n### :fax: Deprecations\n\nThese are *soft*-deprecated, and will emit a warning upon use. Support will be removed in (likely) the next major version of Mocha:\n\n- [#3968](https://github.com/mochajs/mocha/issues/3968): Deprecate legacy configuration via `mocha.opts` ([**@juergba**](https://github.com/juergba))\n\n### :bug: Fixes\n\n- [#4125](https://github.com/mochajs/mocha/issues/4125): Fix timeout handling with `--inspect-brk`/`--inspect` ([**@juergba**](https://github.com/juergba))\n- [#4070](https://github.com/mochajs/mocha/issues/4070): `Mocha` constructor: improve browser setup ([**@juergba**](https://github.com/juergba))\n- [#4068](https://github.com/mochajs/mocha/issues/4068): XUnit reporter should handle exceptions during diff generation ([**@rgroothuijsen**](https://github.com/rgroothuijsen))\n- [#4030](https://github.com/mochajs/mocha/issues/4030): Fix `--allow-uncaught` with `this.skip()` ([**@juergba**](https://github.com/juergba))\n\n### :mag: Coverage\n\n- [#4109](https://github.com/mochajs/mocha/issues/4109): Add Node.js v13.x to CI test matrix ([**@juergba**](https://github.com/juergba))\n\n### :book: Documentation\n\n- [#4129](https://github.com/mochajs/mocha/issues/4129): Fix broken links ([**@SaeromB**](https://github.com/SaeromB))\n- [#4127](https://github.com/mochajs/mocha/issues/4127): Add reporter alias names to docs ([**@khg0712**](https://github.com/khg0712))\n- [#4101](https://github.com/mochajs/mocha/issues/4101): Clarify invalid usage of `done()` ([**@jgehrcke**](https://github.com/jgehrcke))\n- [#4092](https://github.com/mochajs/mocha/issues/4092): Replace `:coffee:` with emoji ☕️ ([**@pzrq**](https://github.com/pzrq))\n- [#4088](https://github.com/mochajs/mocha/issues/4088): Initial draft of project charter ([**@boneskull**](https://github.com/boneskull))\n- [#4066](https://github.com/mochajs/mocha/issues/4066): Change `sh` to `bash` for code block in docs/index.md ([**@HyunSangHan**](https://github.com/HyunSangHan))\n- [#4045](https://github.com/mochajs/mocha/issues/4045): Update README.md concerning GraphicsMagick installation ([**@HyunSangHan**](https://github.com/HyunSangHan))\n- [#3988](https://github.com/mochajs/mocha/issues/3988): Fix sponsors background color for readability ([**@outsideris**](https://github.com/outsideris))\n\n### :nut\\_and\\_bolt: Other\n\n- [#4118](https://github.com/mochajs/mocha/issues/4118): Update node-environment-flags to 1.0.6 ([**@kylef**](https://github.com/kylef))\n- [#4097](https://github.com/mochajs/mocha/issues/4097): Add GH Funding Metadata ([**@SheetJSDev**](https://github.com/SheetJSDev))\n- [#4089](https://github.com/mochajs/mocha/issues/4089): Add funding information to `package.json` ([**@Munter**](https://github.com/Munter))\n- [#4077](https://github.com/mochajs/mocha/issues/4077): Improve integration tests ([**@soobing**](https://github.com/soobing))\n\n## 6.2.3 / 2020-03-25\n\n### :lock: Security Fixes\n\n- [848d6fb8](https://github.com/mochajs/mocha/commit/848d6fb8feef659564b296db457312d38176910d): Update dependencies mkdirp, yargs-parser and yargs ([**@juergba**](https://github.com/juergba))\n\n## 6.2.2 / 2019-10-18\n\n### :bug: Fixes\n\n- [#4025](https://github.com/mochajs/mocha/issues/4025): Fix duplicate `EVENT_RUN_END` events upon uncaught exception ([**@juergba**](https://github.com/juergba))\n- [#4051](https://github.com/mochajs/mocha/issues/4051): Fix \"unhide\" function in `html` reporter (browser) ([**@pec9399**](https://github.com/pec9399))\n- [#4063](https://github.com/mochajs/mocha/issues/4063): Fix use of [esm](https://npm.im/esm) in Node.js v8.x ([**@boneskull**](https://github.com/boneskull))\n- [#4033](https://github.com/mochajs/mocha/issues/4033): Fix output when multiple async exceptions are thrown ([**@juergba**](https://github.com/juergba))\n\n### :book: Documentation\n\n- [#4046](https://github.com/mochajs/mocha/issues/4046): Site accessibility fixes ([**@Mia-jeong**](https://github.com/Mia-jeong))\n- [#4026](https://github.com/mochajs/mocha/issues/4026): Update docs for custom reporters in browser ([**@Lindsay-Needs-Sleep**](https://github.com/Lindsay-Needs-Sleep))\n- [#3971](https://github.com/mochajs/mocha/issues/3971): Adopt new OpenJS Foundation Code of Conduct ([**@craigtaub**](https://github.com/craigtaub))\n\n## 6.2.1 / 2019-09-29\n\n### :bug: Fixes\n\n- [#3955](https://github.com/mochajs/mocha/issues/3955): tty.getWindowSize is not a function inside a \"worker\\_threads\" worker ([**@1999**](https://github.com/1999))\n- [#3970](https://github.com/mochajs/mocha/issues/3970): remove extraGlobals() ([**@juergba**](https://github.com/juergba))\n- [#3984](https://github.com/mochajs/mocha/issues/3984): Update yargs-unparser to v1.6.0 ([**@juergba**](https://github.com/juergba))\n- [#3983](https://github.com/mochajs/mocha/issues/3983): Package 'esm': spawn child-process for correct loading ([**@juergba**](https://github.com/juergba))\n- [#3986](https://github.com/mochajs/mocha/issues/3986): Update yargs to v13.3.0 and yargs-parser to v13.1.1 ([**@juergba**](https://github.com/juergba))\n\n### :book: Documentation\n\n- [#3886](https://github.com/mochajs/mocha/issues/3886): fix styles on mochajs.org ([**@outsideris**](https://github.com/outsideris))\n- [#3966](https://github.com/mochajs/mocha/issues/3966): Remove jsdoc index.html placeholder from eleventy file structure and fix broken link in jsdoc tutorial ([**@Munter**](https://github.com/Munter))\n- [#3765](https://github.com/mochajs/mocha/issues/3765): Add Matomo to website ([**@MarioDiaz98**](https://github.com/MarioDiaz98))\n- [#3947](https://github.com/mochajs/mocha/issues/3947): Clarify effect of .skip() ([**@oliversalzburg**](https://github.com/oliversalzburg))\n\n## 6.2.0 / 2019-07-18\n\n### :tada: Enhancements\n\n- [#3827](https://github.com/mochajs/mocha/issues/3827): Do not fork child-process if no Node flags are present ([**@boneskull**](https://github.com/boneskull))\n- [#3725](https://github.com/mochajs/mocha/issues/3725): Base reporter store ref to console.log, see [mocha/wiki](https://github.com/mochajs/mocha/wiki/HOW-TO:-Correctly-stub-stdout) ([**@craigtaub**](https://github.com/craigtaub))\n\n### :bug: Fixes\n\n- [#3942](https://github.com/mochajs/mocha/issues/3942): Fix \"No test files found\" Error when file is passed via `--file` ([**@gabegorelick**](https://github.com/gabegorelick))\n- [#3914](https://github.com/mochajs/mocha/issues/3914): Modify Mocha constructor to accept options `global` or `globals` ([**@pascalpp**](https://github.com/pascalpp))\n- [#3894](https://github.com/mochajs/mocha/issues/3894): Fix parsing of config files with `_mocha` binary ([**@juergba**](https://github.com/juergba))\n- [#3834](https://github.com/mochajs/mocha/issues/3834): Fix CLI parsing with default values ([**@boneskull**](https://github.com/boneskull), [**@juergba**](https://github.com/juergba))\n- [#3831](https://github.com/mochajs/mocha/issues/3831): Fix `--timeout`/`--slow` string values and duplicate arguments ([**@boneskull**](https://github.com/boneskull), [**@juergba**](https://github.com/juergba))\n\n### :book: Documentation\n\n- [#3906](https://github.com/mochajs/mocha/issues/3906): Document option to define custom report name for XUnit reporter ([**@pkuczynski**](https://github.com/pkuczynski))\n- [#3889](https://github.com/mochajs/mocha/issues/3889): Adds doc links for mocha-examples ([**@craigtaub**](https://github.com/craigtaub))\n- [#3887](https://github.com/mochajs/mocha/issues/3887): Fix broken links ([**@toyjhlee**](https://github.com/toyjhlee))\n- [#3841](https://github.com/mochajs/mocha/issues/3841): Fix anchors to configuration section ([**@trescube**](https://github.com/trescube))\n\n### :mag: Coverage\n\n- [#3915](https://github.com/mochajs/mocha/issues/3915), [#3929](https://github.com/mochajs/mocha/issues/3929): Increase tests coverage for `--watch` options ([**@geigerzaehler**](https://github.com/geigerzaehler))\n\n### :nut\\_and\\_bolt: Other\n\n- [#3953](https://github.com/mochajs/mocha/issues/3953): Collect test files later, prepares improvements to the `--watch` mode behavior ([**@geigerzaehler**](https://github.com/geigerzaehler))\n- [#3939](https://github.com/mochajs/mocha/issues/3939): Upgrade for npm audit ([**@boneskull**](https://github.com/boneskull))\n- [#3930](https://github.com/mochajs/mocha/issues/3930): Extract `runWatch` into separate module ([**@geigerzaehler**](https://github.com/geigerzaehler))\n- [#3922](https://github.com/mochajs/mocha/issues/3922): Add `mocha.min.js` file to stacktrace filter ([**@brian-lagerman**](https://github.com/brian-lagerman))\n- [#3919](https://github.com/mochajs/mocha/issues/3919): Update CI config files to use Node-12.x ([**@plroebuck**](https://github.com/plroebuck))\n- [#3892](https://github.com/mochajs/mocha/issues/3892): Rework reporter tests ([**@plroebuck**](https://github.com/plroebuck))\n- [#3872](https://github.com/mochajs/mocha/issues/3872): Rename `--exclude` to `--ignore` and create alias ([**@boneskull**](https://github.com/boneskull))\n- [#3963](https://github.com/mochajs/mocha/issues/3963): Hide stacktrace when cli args are missing ([**@outsideris**](https://github.com/outsideris))\n- [#3956](https://github.com/mochajs/mocha/issues/3956): Do not redeclare variable in docs array example ([**@DanielRuf**](https://github.com/DanielRuf))\n- [#3957](https://github.com/mochajs/mocha/issues/3957): Remove duplicate line-height property in `mocha.css` ([**@DanielRuf**](https://github.com/DanielRuf))\n- [#3960](https://github.com/mochajs/mocha/issues/3960): Don't re-initialize grep option on watch re-run ([**@geigerzaehler**](https://github.com/geigerzaehler))\n\n## 6.1.4 / 2019-04-18\n\n### :lock: Security Fixes\n\n- [#3877](https://github.com/mochajs/mocha/issues/3877): Upgrade [js-yaml](https://npm.im/js-yaml), addressing [code injection vulnerability](https://www.npmjs.com/advisories/813) ([**@bjornstar**](https://github.com/bjornstar))\n\n## 6.1.3 / 2019-04-11\n\n### :bug: Fixes\n\n- [#3863](https://github.com/mochajs/mocha/issues/3863): Fix `yargs`-related global scope pollution ([**@inukshuk**](https://github.com/inukshuk))\n- [#3869](https://github.com/mochajs/mocha/issues/3869): Fix failure when installed w/ `pnpm` ([**@boneskull**](https://github.com/boneskull))\n\n## 6.1.2 / 2019-04-08\n\n### :bug: Fixes\n\n- [#3867](https://github.com/mochajs/mocha/issues/3867): Re-publish v6.1.1 from POSIX OS to avoid dropped executable flags ([**@boneskull**](https://github.com/boneskull))\n\n## 6.1.1 / 2019-04-07\n\n### :bug: Fixes\n\n- [#3866](https://github.com/mochajs/mocha/issues/3866): Fix Windows End-of-Line publishing issue ([**@juergba**](https://github.com/juergba) & [**@cspotcode**](https://github.com/cspotcode))\n\n## 6.1.0 / 2019-04-07\n\n### :lock: Security Fixes\n\n- [#3845](https://github.com/mochajs/mocha/issues/3845): Update dependency \"js-yaml\" to v3.13.0 per npm security advisory ([**@plroebuck**](https://github.com/plroebuck))\n\n### :tada: Enhancements\n\n- [#3766](https://github.com/mochajs/mocha/issues/3766): Make reporter constructor support optional `options` parameter ([**@plroebuck**](https://github.com/plroebuck))\n- [#3760](https://github.com/mochajs/mocha/issues/3760): Add support for config files with `.jsonc` extension ([**@sstephant**](https://github.com/sstephant))\n\n### :fax: Deprecations\n\nThese are *soft*-deprecated, and will emit a warning upon use. Support will be removed in (likely) the next major version of Mocha:\n\n- [#3719](https://github.com/mochajs/mocha/issues/3719): Deprecate `this.skip()` for \"after all\" hooks ([**@juergba**](https://github.com/juergba))\n\n### :bug: Fixes\n\n- [#3829](https://github.com/mochajs/mocha/issues/3829): Use cwd-relative pathname to load config file ([**@plroebuck**](https://github.com/plroebuck))\n- [#3745](https://github.com/mochajs/mocha/issues/3745): Fix async calls of `this.skip()` in \"before each\" hooks ([**@juergba**](https://github.com/juergba))\n- [#3669](https://github.com/mochajs/mocha/issues/3669): Enable `--allow-uncaught` for uncaught exceptions thrown inside hooks ([**@givanse**](https://github.com/givanse))\n\nand some regressions:\n\n- [#3848](https://github.com/mochajs/mocha/issues/3848): Fix `Suite` cloning by copying `root` property ([**@fatso83**](https://github.com/fatso83))\n- [#3816](https://github.com/mochajs/mocha/issues/3816): Guard against undefined timeout option ([**@boneskull**](https://github.com/boneskull))\n- [#3814](https://github.com/mochajs/mocha/issues/3814): Update \"yargs\" in order to avoid deprecation message ([**@boneskull**](https://github.com/boneskull))\n- [#3788](https://github.com/mochajs/mocha/issues/3788): Fix support for multiple node flags ([**@aginzberg**](https://github.com/aginzberg))\n\n### :book: Documentation\n\n- [mochajs/mocha-examples](https://github.com/mochajs/mocha-examples): New repository of working examples of common configurations using mocha ([**@craigtaub**](https://github.com/craigtaub))\n- [#3850](https://github.com/mochajs/mocha/issues/3850): Remove pound icon showing on header hover on docs ([**@jd2rogers2**](https://github.com/jd2rogers2))\n- [#3812](https://github.com/mochajs/mocha/issues/3812): Add autoprefixer to documentation page CSS ([**@Munter**](https://github.com/Munter))\n- [#3811](https://github.com/mochajs/mocha/issues/3811): Update doc examples \"tests.html\" ([**@DavidLi119**](https://github.com/DavidLi119))\n- [#3807](https://github.com/mochajs/mocha/issues/3807): Mocha website HTML tweaks ([**@plroebuck**](https://github.com/plroebuck))\n- [#3793](https://github.com/mochajs/mocha/issues/3793): Update config file example \".mocharc.yml\" ([**@cspotcode**](https://github.com/cspotcode))\n\n### :nut\\_and\\_bolt: Other\n\n- [#3830](https://github.com/mochajs/mocha/issues/3830): Replace dependency \"findup-sync\" with \"find-up\" for faster startup ([**@cspotcode**](https://github.com/cspotcode))\n- [#3799](https://github.com/mochajs/mocha/issues/3799): Update devDependencies to fix many npm vulnerabilities ([**@XhmikosR**](https://github.com/XhmikosR))\n\n## 6.0.2 / 2019-02-25\n\n### :bug: Fixes\n\nTwo more regressions fixed:\n\n- [#3768](https://github.com/mochajs/mocha/issues/3768): Test file paths no longer dropped from `mocha.opts` ([**@boneskull**](https://github.com/boneskull))\n- [#3767](https://github.com/mochajs/mocha/issues/3767): `--require` does not break on module names that look like certain `node` flags ([**@boneskull**](https://github.com/boneskull))\n\n## 6.0.1 / 2019-02-21\n\nThe obligatory round of post-major-release bugfixes.\n\n### :bug: Fixes\n\nThese issues were regressions.\n\n- [#3754](https://github.com/mochajs/mocha/issues/3754): Mocha again finds `test.js` when run without arguments ([**@plroebuck**](https://github.com/plroebuck))\n- [#3756](https://github.com/mochajs/mocha/issues/3756): Mocha again supports third-party interfaces via `--ui` ([**@boneskull**](https://github.com/boneskull))\n- [#3755](https://github.com/mochajs/mocha/issues/3755): Fix broken `--watch` ([**@boneskull**](https://github.com/boneskull))\n- [#3759](https://github.com/mochajs/mocha/issues/3759): Fix unwelcome deprecation notice when Mocha run against languages (CoffeeScript) with implicit return statements; *returning a non-`undefined` value from a `describe` callback is no longer considered deprecated* ([**@boneskull**](https://github.com/boneskull))\n\n### :book: Documentation\n\n- [#3738](https://github.com/mochajs/mocha/issues/3738): Upgrade to `@mocha/docdash@2` ([**@tendonstrength**](https://github.com/tendonstrength))\n- [#3751](https://github.com/mochajs/mocha/issues/3751): Use preferred names for example config files ([**@Szauka**](https://github.com/Szauka))\n\n## 6.0.0 / 2019-02-18\n\n### :tada: Enhancements\n\n- [#3726](https://github.com/mochajs/mocha/issues/3726): Add ability to unload files from `require` cache ([**@plroebuck**](https://github.com/plroebuck))\n\n### :bug: Fixes\n\n- [#3737](https://github.com/mochajs/mocha/issues/3737): Fix falsy values from options globals ([**@plroebuck**](https://github.com/plroebuck))\n- [#3707](https://github.com/mochajs/mocha/issues/3707): Fix encapsulation issues for `Suite#_onlyTests` and `Suite#_onlySuites` ([**@vkarpov15**](https://github.com/vkarpov15))\n- [#3711](https://github.com/mochajs/mocha/issues/3711): Fix diagnostic messages dealing with plurality and markup of output ([**@plroebuck**](https://github.com/plroebuck))\n- [#3723](https://github.com/mochajs/mocha/issues/3723): Fix \"reporter-option\" to allow comma-separated options ([**@boneskull**](https://github.com/boneskull))\n- [#3722](https://github.com/mochajs/mocha/issues/3722): Fix code quality and performance of `lookupFiles` and `files` ([**@plroebuck**](https://github.com/plroebuck))\n- [#3650](https://github.com/mochajs/mocha/issues/3650), [#3654](https://github.com/mochajs/mocha/issues/3654): Fix noisy error message when no files found ([**@craigtaub**](https://github.com/craigtaub))\n- [#3632](https://github.com/mochajs/mocha/issues/3632): Tests having an empty title are no longer confused with the \"root\" suite ([**@juergba**](https://github.com/juergba))\n- [#3666](https://github.com/mochajs/mocha/issues/3666): Fix missing error codes ([**@vkarpov15**](https://github.com/vkarpov15))\n- [#3684](https://github.com/mochajs/mocha/issues/3684): Fix exiting problem in Node.js v11.7.0+ ([**@addaleax**](https://github.com/addaleax))\n- [#3691](https://github.com/mochajs/mocha/issues/3691): Fix `--delay` (and other boolean options) not working in all cases ([**@boneskull**](https://github.com/boneskull))\n- [#3692](https://github.com/mochajs/mocha/issues/3692): Fix invalid command-line argument usage not causing actual errors ([**@boneskull**](https://github.com/boneskull))\n- [#3698](https://github.com/mochajs/mocha/issues/3698), [#3699](https://github.com/mochajs/mocha/issues/3699): Fix debug-related Node.js options not working in all cases ([**@boneskull**](https://github.com/boneskull))\n- [#3700](https://github.com/mochajs/mocha/issues/3700): Growl notifications now show the correct number of tests run ([**@outsideris**](https://github.com/outsideris))\n- [#3686](https://github.com/mochajs/mocha/issues/3686): Avoid potential ReDoS when diffing large objects ([**@cyjake**](https://github.com/cyjake))\n- [#3715](https://github.com/mochajs/mocha/issues/3715): Fix incorrect order of emitted events when used programmatically ([**@boneskull**](https://github.com/boneskull))\n- [#3706](https://github.com/mochajs/mocha/issues/3706): Fix regression wherein `--reporter-option`/`--reporter-options` did not support comma-separated key/value pairs ([**@boneskull**](https://github.com/boneskull))\n\n### :book: Documentation\n\n- [#3652](https://github.com/mochajs/mocha/issues/3652): Switch from Jekyll to Eleventy ([**@Munter**](https://github.com/Munter))\n\n### :nut\\_and\\_bolt: Other\n\n- [#3677](https://github.com/mochajs/mocha/issues/3677): Add error objects for createUnsupportedError and createInvalidExceptionError ([**@boneskull**](https://github.com/boneskull))\n- [#3733](https://github.com/mochajs/mocha/issues/3733): Removed unnecessary processing in post-processing hook ([**@wanseob**](https://github.com/wanseob))\n- [#3730](https://github.com/mochajs/mocha/issues/3730): Update nyc to latest version ([**@coreyfarrell**](https://github.com/coreyfarrell))\n- [#3648](https://github.com/mochajs/mocha/issues/3648), [#3680](https://github.com/mochajs/mocha/issues/3680): Fixes to support latest versions of [unexpected](https://npm.im/unexpected) and [unexpected-sinon](https://npm.im/unexpected-sinon) ([**@sunesimonsen**](https://github.com/sunesimonsen))\n- [#3638](https://github.com/mochajs/mocha/issues/3638): Add meta tag to site ([**@MartijnCuppens**](https://github.com/MartijnCuppens))\n- [#3653](https://github.com/mochajs/mocha/issues/3653): Fix parts of test suite failing to run on Windows ([**@boneskull**](https://github.com/boneskull))\n\n## 6.0.0-1 / 2019-01-02\n\n### :bug: Fixes\n\n- Fix missing `mocharc.json` in published package ([**@boneskull**](https://github.com/boneskull))\n\n## 6.0.0-0 / 2019-01-01\n\n**Documentation for this release can be found at [next.mochajs.org](https://next.mochajs.org)**!\n\nWelcome [**@plroebuck**](https://github.com/plroebuck), [**@craigtaub**](https://github.com/craigtaub), & [**@markowsiak**](https://github.com/markowsiak) to the team!\n\n### :boom: Breaking Changes\n\n- [#3149](https://github.com/mochajs/mocha/issues/3149): **Drop Node.js v4.x support** ([**@outsideris**](https://github.com/outsideris))\n- [#3556](https://github.com/mochajs/mocha/issues/3556): Changes to command-line options ([**@boneskull**](https://github.com/boneskull)):\n - `--grep` and `--fgrep` are now mutually exclusive; attempting to use both will cause Mocha to fail instead of simply ignoring `--grep`\n - `--compilers` is no longer supported; attempting to use will cause Mocha to fail with a link to more information\n - `-d` is no longer an alias for `--debug`; `-d` is currently ignored\n - [#3275](https://github.com/mochajs/mocha/issues/3275): `--watch-extensions` no longer implies `js`; it must be explicitly added ([**@TheDancingCode**](https://github.com/TheDancingCode))\n- [#2908](https://github.com/mochajs/mocha/issues/2908): `tap` reporter emits error messages ([**@chrmod**](https://github.com/chrmod))\n- [#2819](https://github.com/mochajs/mocha/issues/2819): When conditionally skipping in a `before` hook, subsequent `before` hooks *and* tests in nested suites are now skipped ([**@bannmoore**](https://github.com/bannmoore))\n- [#627](https://github.com/mochajs/mocha/issues/627): Emit filepath in \"timeout exceeded\" exceptions where applicable ([**@boneskull**](https://github.com/boneskull))\n- [#3556](https://github.com/mochajs/mocha/issues/3556): `lib/template.html` has moved to `lib/browser/template.html` ([**@boneskull**](https://github.com/boneskull))\n- [#2576](https://github.com/mochajs/mocha/issues/2576): An exception is now thrown if Mocha fails to parse or find a `mocha.opts` at a user-specified path ([**@plroebuck**](https://github.com/plroebuck))\n- [#3458](https://github.com/mochajs/mocha/issues/3458): Instantiating a `Base`-extending reporter without a `Runner` parameter will throw an exception ([**@craigtaub**](https://github.com/craigtaub))\n- [#3125](https://github.com/mochajs/mocha/issues/3125): For consumers of Mocha's programmatic API, all exceptions thrown from Mocha now have a `code` property (and some will have additional metadata). Some `Error` messages have changed. **Please use the `code` property to check `Error` types instead of the `message` property**; these descriptions will be localized in the future. ([**@craigtaub**](https://github.com/craigtaub))\n\n### :fax: Deprecations\n\nThese are *soft*-deprecated, and will emit a warning upon use. Support will be removed in (likely) the next major version of Mocha:\n\n- `-gc` users should use `--gc-global` instead\n- Consumers of the function exported by `bin/options` should now use the `loadMochaOpts` or `loadOptions` (preferred) functions exported by the `lib/cli/options` module\n\nRegarding the `Mocha` class constructor (from `lib/mocha`):\n\n- Use property `color: false` instead of `useColors: false`\n- Use property `timeout: false` instead of `enableTimeouts: false`\n\nAll of the above deprecations were introduced by [#3556](https://github.com/mochajs/mocha/issues/3556).\n\n`mocha.opts` is now considered \"legacy\"; please prefer RC file or `package.json` over `mocha.opts`.\n\n### :tada: Enhancements\n\nEnhancements introduced in [#3556](https://github.com/mochajs/mocha/issues/3556):\n\n- Mocha now supports \"RC\" files in JS, JSON, YAML, or `package.json`-based (using `mocha` property) format\n\n - `.mocharc.js`, `.mocharc.json`, `.mocharc.yaml` or `.mocharc.yml` are valid \"rc\" file names and will be automatically loaded\n - Use `--config /path/to/rc/file` to specify an explicit path\n - Use `--package /path/to/package.json` to specify an explicit `package.json` to read the `mocha` prop from\n - Use `--no-config` or `--no-package` to completely disable loading of configuration via RC file and `package.json`, respectively\n - Configurations are merged as applicable using the priority list:\n 1. Command-line arguments\n 1. RC file\n 1. `package.json`\n 1. `mocha.opts`\n 1. Mocha's own defaults\n - Check out these [example config files](https://github.com/mochajs/mocha/tree/master/example/config)\n\n- Node/V8 flag support in `mocha` executable:\n\n - Support all allowed `node` flags as supported by the running version of `node` (also thanks to [**@demurgos**](https://github.com/demurgos))\n - Support any V8 flag by prepending `--v8-` to the flag name\n - All flags are also supported via config files, `package.json` properties, or `mocha.opts`\n - Debug-related flags (e.g., `--inspect`) now *imply* `--no-timeouts`\n - Use of e.g., `--debug` will automatically invoke `--inspect` if supported by running version of `node`\n\n- Support negation of any Mocha-specific command-line flag by prepending `--no-` to the flag name\n\n- Interfaces now have descriptions when listed using `--interfaces` flag\n\n- `Mocha` constructor supports all options\n\n- `--extension` is now an alias for `--watch-extensions` and affects *non-watch-mode* test runs as well. For example, to run *only* `test/*.coffee` (not `test/*.js`), you can do `mocha --require coffee-script/register --extensions coffee`.\n\n- [#3552](https://github.com/mochajs/mocha/issues/3552): `tap` reporter is now TAP13-capable ([**@plroebuck**](https://github.com/plroebuck) & [**@mollstam**](https://github.com/mollstam))\n\n- [#3535](https://github.com/mochajs/mocha/issues/3535): Mocha's version can now be queried programmatically via public property `Mocha.prototype.version` ([**@plroebuck**](https://github.com/plroebuck))\n\n- [#3428](https://github.com/mochajs/mocha/issues/3428): `xunit` reporter shows diffs ([**@mlucool**](https://github.com/mlucool))\n\n- [#2529](https://github.com/mochajs/mocha/issues/2529): `Runner` now emits a `retry` event when tests are retried (reporters can listen for this) ([**@catdad**](https://github.com/catdad))\n\n- [#2962](https://github.com/mochajs/mocha/issues/2962), [#3111](https://github.com/mochajs/mocha/issues/3111): In-browser notification support; warn about missing prereqs when `--growl` supplied ([**@plroebuck**](https://github.com/plroebuck))\n\n### :bug: Fixes\n\n- [#3356](https://github.com/mochajs/mocha/issues/3356): `--no-timeouts` and `--timeout 0` now does what you'd expect ([**@boneskull**](https://github.com/boneskull))\n- [#3475](https://github.com/mochajs/mocha/issues/3475): Restore `--no-exit` option ([**@boneskull**](https://github.com/boneskull))\n- [#3570](https://github.com/mochajs/mocha/issues/3570): Long-running tests now respect `SIGINT` ([**@boneskull**](https://github.com/boneskull))\n- [#2944](https://github.com/mochajs/mocha/issues/2944): `--forbid-only` and `--forbid-pending` now \"fail fast\" when encountered on a suite ([**@outsideris**](https://github.com/outsideris))\n- [#1652](https://github.com/mochajs/mocha/issues/1652), [#2951](https://github.com/mochajs/mocha/issues/2951): Fix broken clamping of timeout values ([**@plroebuck**](https://github.com/plroebuck))\n- [#2095](https://github.com/mochajs/mocha/issues/2095), [#3521](https://github.com/mochajs/mocha/issues/3521): Do not log `stdout:` prefix in browser console ([**@Bamieh**](https://github.com/Bamieh))\n- [#3595](https://github.com/mochajs/mocha/issues/3595): Fix mochajs.org deployment problems ([**@papandreou**](https://github.com/papandreou))\n- [#3518](https://github.com/mochajs/mocha/issues/3518): Improve `utils.isPromise()` ([**@fabiosantoscode**](https://github.com/fabiosantoscode))\n- [#3320](https://github.com/mochajs/mocha/issues/3320): Fail gracefully when non-extensible objects are thrown in async tests ([**@fargies**](https://github.com/fargies))\n- [#2475](https://github.com/mochajs/mocha/issues/2475): XUnit does not duplicate test result numbers in \"errors\" and \"failures\"; \"failures\" will **always** be zero ([**@mlucool**](https://github.com/mlucool))\n- [#3398](https://github.com/mochajs/mocha/issues/3398), [#3598](https://github.com/mochajs/mocha/issues/3598), [#3457](https://github.com/mochajs/mocha/issues/3457), [#3617](https://github.com/mochajs/mocha/issues/3617): Fix regression wherein `--bail` would not execute \"after\" nor \"after each\" hooks ([**@juergba**](https://github.com/juergba))\n- [#3580](https://github.com/mochajs/mocha/issues/3580): Fix potential exception when using XUnit reporter programmatically ([**@Lana-Light**](https://github.com/Lana-Light))\n- [#1304](https://github.com/mochajs/mocha/issues/1304): Do not output color to `TERM=dumb` ([**@plroebuck**](https://github.com/plroebuck))\n\n### :book: Documentation\n\n- [#3525](https://github.com/mochajs/mocha/issues/3525): Improvements to `.github/CONTRIBUTING.md` ([**@markowsiak**](https://github.com/markowsiak))\n- [#3466](https://github.com/mochajs/mocha/issues/3466): Update description of `slow` option ([**@finfin**](https://github.com/finfin))\n- [#3405](https://github.com/mochajs/mocha/issues/3405): Remove references to bower installations ([**@goteamtim**](https://github.com/goteamtim))\n- [#3361](https://github.com/mochajs/mocha/issues/3361): Improvements to `--watch` docs ([**@benglass**](https://github.com/benglass))\n- [#3136](https://github.com/mochajs/mocha/issues/3136): Improve docs around globbing and shell expansion ([**@akrawchyk**](https://github.com/akrawchyk))\n- [#2819](https://github.com/mochajs/mocha/issues/2819): Update docs around skips and hooks ([**@bannmoore**](https://github.com/bannmoore))\n- Many improvements by [**@outsideris**](https://github.com/outsideris)\n\n### :nut\\_and\\_bolt: Other\n\n- [#3557](https://github.com/mochajs/mocha/issues/3557): Use `ms` userland module instead of hand-rolled solution ([**@gizemkeser**](https://github.com/gizemkeser))\n- Many CI fixes and other refactors by [**@plroebuck**](https://github.com/plroebuck)\n- Test refactors by [**@outsideris**](https://github.com/outsideris)\n\n## 5.2.0 / 2018-05-18\n\n### :tada: Enhancements\n\n- [#3375](https://github.com/mochajs/mocha/pull/3375): Add support for comments in `mocha.opts` ([@plroebuck](https://github.com/plroebuck))\n\n### :bug: Fixes\n\n- [#3346](https://github.com/mochajs/mocha/pull/3346): Exit correctly from `before` hooks when using `--bail` ([@outsideris](https://github.com/outsideris))\n\n### :book: Documentation\n\n- [#3328](https://github.com/mochajs/mocha/pull/3328): Mocha-flavored [API docs](https://mochajs.org/api/)! ([@Munter](https://github.com/munter))\n\n### :nut\\_and\\_bolt: Other\n\n- [#3330](https://github.com/mochajs/mocha/pull/3330): Use `Buffer.from()` ([@harrysarson](https://github.com/harrysarson))\n- [#3295](https://github.com/mochajs/mocha/pull/3295): Remove redundant folder ([@DavNej](https://github.com/DajNev))\n- [#3356](https://github.com/mochajs/mocha/pull/3356): Refactoring ([@plroebuck](https://github.com/plroebuck))\n\n## 5.1.1 / 2018-04-18\n\n### :bug: Fixes\n\n- [#3325](https://github.com/mochajs/mocha/issues/3325): Revert change which broke `--watch` ([@boneskull](https://github.com/boneskull))\n\n## 5.1.0 / 2018-04-12\n\n### :tada: Enhancements\n\n- [#3210](https://github.com/mochajs/mocha/pull/3210): Add `--exclude` option ([@metalex9](https://github.com/metalex9))\n\n### :bug: Fixes\n\n- [#3318](https://github.com/mochajs/mocha/pull/3318): Fix failures in circular objects in JSON reporter ([@jeversmann](https://github.com/jeversmann), [@boneskull](https://github.com/boneskull))\n\n### :book: Documentation\n\n- [#3323](https://github.com/mochajs/mocha/pull/3323): Publish actual [API documentation](https://mochajs.org/api/)! ([@dfberry](https://github.com/dfberry), [@Munter](https://github.com/munter))\n- [#3299](https://github.com/mochajs/mocha/pull/3299): Improve docs around exclusive tests ([@nicgirault](https://github.com/nicgirault))\n\n### :nut\\_and\\_bolt: Other\n\n- [#3302](https://github.com/mochajs/mocha/pull/3302), [#3308](https://github.com/mochajs/mocha/pull/3308), [#3310](https://github.com/mochajs/mocha/pull/3310), [#3315](https://github.com/mochajs/mocha/pull/3315), [#3316](https://github.com/mochajs/mocha/pull/3316): Build matrix improvements ([more info](https://boneskull.com/mocha-and-travis-ci-build-stages/)) ([@outsideris](https://github.com/outsideris), [@boneskull](https://github.com/boneskull))\n- [#3272](https://github.com/mochajs/mocha/pull/3272): Refactor reporter tests ([@jMuzsik](https://github.com/jMuzsik))\n\n## 5.0.5 / 2018-03-22\n\nWelcome [@outsideris](https://github.com/outsideris) to the team!\n\n### :bug: Fixes\n\n- [#3096](https://github.com/mochajs/mocha/issues/3096): Fix `--bail` failing to bail within hooks ([@outsideris](https://github.com/outsideris))\n- [#3184](https://github.com/mochajs/mocha/issues/3184): Don't skip too many suites (using `describe.skip()`) ([@outsideris](https://github.com/outsideris))\n\n### :book: Documentation\n\n- [#3133](https://github.com/mochajs/mocha/issues/3133): Improve docs regarding \"pending\" behavior ([@ematicipo](https://github.com/ematicipo))\n- [#3276](https://github.com/mochajs/mocha/pull/3276), [#3274](https://github.com/mochajs/mocha/pull/3274): Fix broken stuff in `CHANGELOG.md` ([@tagoro9](https://github.com/tagoro9), [@honzajavorek](https://github.com/honzajavorek))\n\n### :nut\\_and\\_bolt: Other\n\n- [#3208](https://github.com/mochajs/mocha/issues/3208): Improve test coverage for AMD users ([@outsideris](https://github.com/outsideris))\n- [#3267](https://github.com/mochajs/mocha/pull/3267): Remove vestiges of PhantomJS from CI ([@anishkny](https://github.com/anishkny))\n- [#2952](https://github.com/mochajs/mocha/issues/2952): Fix a debug message ([@boneskull](https://github.com/boneskull))\n\n## 5.0.4 / 2018-03-07\n\n### :bug: Fixes\n\n- [#3265](https://github.com/mochajs/mocha/issues/3265): Fixes regression in \"watch\" functionality introduced in v5.0.2 ([@outsideris](https://github.com/outsideris))\n\n## 5.0.3 / 2018-03-06\n\nThis patch features a fix to address a potential \"low severity\" [ReDoS vulnerability](https://snyk.io/vuln/npm:diff:20180305) in the [diff](https://npm.im/diff) package (a dependency of Mocha).\n\n### :lock: Security Fixes\n\n- [#3266](https://github.com/mochajs/mocha/pull/3266): Bump `diff` to v3.5.0 ([@anishkny](https://github.com/anishkny))\n\n### :nut\\_and\\_bolt: Other\n\n- [#3011](https://github.com/mochajs/mocha/issues/3011): Expose `generateDiff()` in `Base` reporter ([@harrysarson](https://github.com/harrysarson))\n\n## 5.0.2 / 2018-03-05\n\nThis release fixes a class of tests which report as *false positives*. **Certain tests will now break**, though they would have previously been reported as passing. Details below. Sorry for the inconvenience!\n\n### :bug: Fixes\n\n- [#3226](https://github.com/mochajs/mocha/issues/3226): Do not swallow errors that are thrown asynchronously from passing tests ([@boneskull](https://github.com/boneskull)). Example:\n\n \\`\\`\\`js\n it('should actually fail, sorry!', function (done) {\n // passing assertion\n assert(true === true);\n\n // test complete & is marked as passing\n done();\n\n // ...but something evil lurks within\n setTimeout(() => {\n throw new Error('chaos!');\n }, 100);\n });\n \\`\\`\\`\n\n Previously to this version, Mocha would have *silently swallowed* the `chaos!` exception, and you wouldn't know. Well, *now you know*. Mocha cannot recover from this gracefully, so it will exit with a nonzero code.\n\n **Maintainers of external reporters**: *If* a test of this class is encountered, the `Runner` instance will emit the `end` event *twice*; you *may* need to change your reporter to use `runner.once('end')` intead of `runner.on('end')`.\n\n- [#3093](https://github.com/mochajs/mocha/issues/3093): Fix stack trace reformatting problem ([@outsideris](https://github.com/outsideris))\n\n### :nut\\_and\\_bolt: Other\n\n- [#3248](https://github.com/mochajs/mocha/issues/3248): Update `browser-stdout` to v1.3.1 ([@honzajavorek](https://github.com/honzajavorek))\n\n## 5.0.1 / 2018-02-07\n\n...your garden-variety patch release.\n\nSpecial thanks to [Wallaby.js](https://wallabyjs.com) for their continued support! :heart:\n\n### :bug: Fixes\n\n- [#1838](https://github.com/mochajs/mocha/issues/1838): `--delay` now works with `.only()` ([@silviom](https://github.com/silviom))\n- [#3119](https://github.com/mochajs/mocha/issues/3119): Plug memory leak present in v8 ([@boneskull](https://github.com/boneskull))\n\n### :book: Documentation\n\n- [#3132](https://github.com/mochajs/mocha/issues/3132), [#3098](https://github.com/mochajs/mocha/issues/3098): Update `--glob` docs ([@outsideris](https://github.com/outsideris))\n- [#3212](https://github.com/mochajs/mocha/pull/3212): Update [Wallaby.js](https://wallabyjs.com)-related docs ([@ArtemGovorov](https://github.com/ArtemGovorov))\n- [#3205](https://github.com/mochajs/mocha/pull/3205): Remove outdated cruft ([@boneskull](https://github.com/boneskull))\n\n### :nut\\_and\\_bolt: Other\n\n- [#3224](https://github.com/mochajs/mocha/pull/3224): Add proper Wallaby.js config ([@ArtemGovorov](https://github.com/ArtemGovorov))\n- [#3230](https://github.com/mochajs/mocha/pull/3230): Update copyright year ([@josephlin55555](https://github.com/josephlin55555))\n\n## 5.0.0 / 2018-01-17\n\nMocha starts off 2018 right by again dropping support for *unmaintained rubbish*.\n\nWelcome [@vkarpov15](https://github.com/vkarpov15) to the team!\n\n### :boom: Breaking Changes\n\n- **[#3148](https://github.com/mochajs/mocha/issues/3148): Drop support for IE9 and IE10** ([@Bamieh](https://github.com/Bamieh))\n Practically speaking, only code which consumes (through bundling or otherwise) the userland [buffer](https://npm.im/buffer) module should be affected. However, Mocha will no longer test against these browsers, nor apply fixes for them.\n\n### :tada: Enhancements\n\n- [#3181](https://github.com/mochajs/mocha/issues/3181): Add useful new `--file` command line argument ([documentation](https://mochajs.org/#--file-file)) ([@hswolff](https://github.com/hswolff))\n\n### :bug: Fixes\n\n- [#3187](https://github.com/mochajs/mocha/issues/3187): Fix inaccurate test duration reporting ([@FND](https://github.com/FND))\n- [#3202](https://github.com/mochajs/mocha/pull/3202): Fix bad markup in HTML reporter ([@DanielRuf](https://github.com/DanielRuf))\n\n### :sunglasses: Developer Experience\n\n- [#2352](https://github.com/mochajs/mocha/issues/2352): Ditch GNU Make for [nps](https://npm.im/nps) to manage scripts ([@TedYav](https://github.com/TedYav))\n\n### :book: Documentation\n\n- [#3137](https://github.com/mochajs/mocha/issues/3137): Add missing `--no-timeouts` docs ([@dfberry](https://github.com/dfberry))\n- [#3134](https://github.com/mochajs/mocha/issues/3134): Improve `done()` callback docs ([@maraisr](https://github.com/maraisr))\n- [#3135](https://github.com/mochajs/mocha/issues/3135): Fix cross-references ([@vkarpov15](https://github.com/vkarpov15))\n- [#3163](https://github.com/mochajs/mocha/pull/3163): Fix tpyos ([@tbroadley](https://github.com/tbroadley))\n- [#3177](https://github.com/mochajs/mocha/pull/3177): Tweak `README.md` organization ([@xxczaki](https://github.com/xxczaki))\n- Misc updates ([@boneskull](https://github.com/boneskull))\n\n### :nut\\_and\\_bolt: Other\n\n- [#3118](https://github.com/mochajs/mocha/issues/3118): Move TextMate Integration to [its own repo](https://github.com/mochajs/mocha.tmbundle) ([@Bamieh](https://github.com/Bamieh))\n- [#3185](https://github.com/mochajs/mocha/issues/3185): Add Node.js v9 to build matrix; remove v7 ([@xxczaki](https://github.com/xxczaki))\n- [#3172](https://github.com/mochajs/mocha/issues/3172): Markdown linting ([@boneskull](https://github.com/boneskull))\n- Test & Netlify updates ([@Munter](https://github.com/munter), [@boneskull](https://github.com/boneskull))\n" }, { "path": "FUNDING.md", "content": "# Fund Usage Guidelines\n\nThis project follows [Collective Funds Guidelines 0.1](https://github.com/collective-funds/guidelines) with the below customizations.\n\n## Rates\n\n- TSC Members: $75.00 USD/hour\n- Project Contributors: $50.00 USD/hour\n\n## Additional notes\n\nThe project funds are collected in the [Mocha collective](https://opencollective.com/mochajs) on [Open Collective](https://opencollective.com/) which is hosted by the [Open Source Collective](https://oscollective.org/).\n\nIn additions to the [Collective Funds Guidelines](https://github.com/collective-funds/guidelines) this project abides by the [Open Source Collective](https://oscollective.org/)'s [Terms of Fiscal Sponsorship](https://docs.oscollective.org/getting-started/terms-of-fiscal-sponsorship).\n\nWhen/if the two are in conflict, the Terms of Fiscal Sponsorship is the one that will be followed.\n" }, { "path": "LICENSE", "content": "(The MIT License)\n\nCopyright (c) 2011-2024 OpenJS Foundation and contributors, https://openjsf.org\n\nPermission is hereby granted, free of charge, to any person obtaining\na copy of this software and associated documentation files (the\n'Software'), to deal in the Software without restriction, including\nwithout limitation the rights to use, copy, modify, merge, publish,\ndistribute, sublicense, and/or sell copies of the Software, and to\npermit persons to whom the Software is furnished to do so, subject to\nthe following conditions:\n\nThe above copyright notice and this permission notice shall be\nincluded in all copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,\nEXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF\nMERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.\nIN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY\nCLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,\nTORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE\nSOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n" }, { "path": "MAINTAINERS.md", "content": "# Mocha Maintainer's Handbook\n\n## Introduction\n\nHi stranger! We've written this document for:\n\n1. Active maintainers of Mocha\n1. Prospective maintainers of Mocha\n1. Anyone curious about how Mocha's maintainers maintain Mocha\n\nThe purpose of this document is to _describe our processes_.\nWe want to avoid conflicts and confusion around \"unwritten rules\".\nIn our opinion, the most straightforward way to address this is to _write them down_.\nThis _also_ happens to be the most straightforward way to change them!\n\nTo assist in eliminating ambiguity, we will define some terms.\n\n## Terminology\n\nAnyone involved with Mocha will fall into one of these buckets: **user**, **contributor**, and **maintainer**.\n\n### User\n\nA \"user\" for the purpose of this document is any _individual developer_ who consumes Mocha to write and/or execute tests.\nA user interacts with contributors.\nA user interacts with the software, web site, documentation, etc., which these contributors provide.\n\nAs a user, you're expected to follow the [code of conduct](https://github.com/mochajs/mocha/blob/main/.github/CODE_OF_CONDUCT.md) when interacting in Mocha's \"official\" social spaces.\nThis includes:\n\n- Any channel under the `mochajs` Discord\n- Any project under the `mochajs` organization on GitHub\n- Any future social, in-person, or online events which Mocha might organize\n\n### Contributor\n\nThis is the most important thing:\n\n**You don't have to write code to be a contributor!**\n\nA \"contributor\" is any individual who has _given back_ in some way to the project and its community.\nContributions include (but are not limited to):\n\n1. Reporting bugs which follow the reporting guidelines\n1. Suggesting and debating enhancements that have wide applicability\n1. Helping others with Mocha-related questions on [our Discord](https://discord.gg/KeDn2uXhER), [StackOverflow](https://stackoverflow.com), or other sites\n1. Sending pull requests which fix bugs, improve documentation, improve developer experience, improve code quality, and/or implement requested enhancements\n1. Reviewing code on pull requests\n1. Providing design assets\n1. Posting a tutorial on a personal blog or blogging site\n1. Suggesting usages for project funds\n1. Organizing a \"Mocha-branded\" event or workshop\n1. Recruiting more contributors! Don't spam.\n1. Researching the user base, getting feedback, etc. Don't spam.\n\nA contributor is _usually_ a user as well, but this isn't a hard-and-fast rule.\nA contributor is also expected to adhere to the [code of conduct](https://github.com/mochajs/mocha/blob/main/.github/CODE_OF_CONDUCT.md) as a user would.\n\nAs you can see, it's wide open! Think of it another way: if you are _adding value to Mocha_, then you are a contributor.\n\n> Due to the nature of GitHub, it's a challenge to recognize those who've made contributions _elsewhere_ on the web, or even contributions of the \"non-code\" variety.\n> If you know of any great contributions which have gone unnoticed, please bring them to the maintainers' attention!\n\n#### A Note About Donations\n\nA [donation](https://opencollective.com/mochajs) is also a great way to help Mocha if you want to help sustain OSS, but can't find time to contribute in other ways, or just want to say \"thanks!\"\n\nWe love our backers and sponsors! 💕\n\n### Maintainer\n\nA maintainer has certain \"rights\" (or \"permissions\") to the Mocha project and other projects under the `mochajs` organization.\nThere's no way to dance around this: with these rights come increased responsibilities.\n\nHowever, **there is no expectation of a standard of technical ability** to be a maintainer of Mocha.\nThis doesn't imply a lack of technical oversight--every pull request will eventually be reviewed.\n\n**If you think you aren't experienced enough to maintain a project like Mocha, you are incorrect.** The only requirements are the above responsibilities and a desire to help the project.\nIt bears repeating:\n\n**You don't have to write code to be a maintainer!**\n\n> Maintainer is synonymous with \"Collaborator\" and/or \"Owner\" in GitHub parlance.\n\n#### The Responsibilities of a Maintainer\n\nAs a maintainer, you are expected to _not just_ \"follow\" the code of conduct, but embody its values.\nYour public behavior, whether in the physical or virtual world, reflects upon the project and other maintainers.\n\n> If you don't understand the code of conduct, or why it exists, it is _your responsibility_ to educate yourself.\n> This does not imply the CoC is immutable.\n\nFurthermore, a maintainer is a contributor who **contributes regularly**. That can be daily, weekly, or even just a few times a month -- as long as it's regular.\nWe are all people with Real Lives, and for many of us, contributing to OSS is just an occasional hobby!\n\nFinally, a maintainer must help define what makes Mocha \"Mocha\".\nAt minimum, a maintainer must _understand_ the current definition (if a maintainer is not interested in decision-making).\nSome of these questions include:\n\n- What's the scope of Mocha?\n- Where should we focus efforts?\n- What's urgent, what can wait?\n- What can we break? What's off-limits?\n- What user feedback is valuable? What isn't?\n\nAs maintainers, _we work together_ to learn about the nature of these questions. If we try hard enough, we even come to some answers!\n\nA maintainer _must_ also have 2FA enabled on their GitHub account.\n\n> If you think that you aren't familiar with mocha's internals enough to contribute, please watch [this walkthrough video](https://youtu.be/zLayCLcIno0)!\n\n#### The Rights of a Maintainer\n\nYou may choose to do zero or more of these _at their discretion_:\n\n- Merge pull requests\n- Modify issues (closing, adding labels, assigning them other maintainers, etc.)\n- Modify GitHub [Projects](https://github.com/mochajs/mocha/projects)\n- Cancel builds, restart jobs, or otherwise interact with our CI server(s)\n- CRUD operations on GitHub integrations\n- Participate in the decision-making process\n- Add new maintainers to the team\n- Tag releases and publish Mocha to npm\n\n> While maintainers have the ability to commit directly to the `main` branch, _this is to be avoided_ if any other maintainer could reasonably take issue with the change, or the change affects Mocha's API or output.\n> For example, a spelling correction in `CHANGELOG.md` may not require a pull request.\n> A change to a reporter's output most certainly would! Maintainers are trusted to use their best judgement; if unsure, err on the side of caution.\n\n#### Expected Activity Levels\n\nWe generally expect maintainers to average at least:\n\n- Multiple contributions of any kind in a week\n- One meaningful, non-trivial contribution per month\n\nThese are rough averages, not strict minimums!\nIt's totally fine to skip a week or two here and there, as long as you do a little more before or after.\nMeaningful, non-trivial contributions can be a well-thought-out comment, sending a non-straightforward pull request, or anything else that adds real value to the project.\n\nIf you have to step away longer than a couple of weeks, that's totally fine too.\nJust let the other maintainers know ahead of time.\n\n- If you need to step away for up to a month or two, don't sweat it.\n- If we don't hear from you for a month without prior notice, we'll check in with you to see if you want to remain a maintainer.\n- After three months of inactivity, or two without prior notice, we'll likely remove you as a maintainer.\n\nAgain, don't stress about this if you can't always be available.\nYour boss doesn't work here; contribute as often as you reasonably can.\nEven if you step down or are removed, if you can come back and be regularly active we'll happily reinstate you.\n\n#### About \"Owners\"\n\nSome maintainers will have full admin rights to the [mochajs GitHub org](https://github.com/mochajs) and/or will have access to publish to npm.\n\n- Those with publish access must use npm's 2FA.\n- This level of access will be granted by the current owners to those maintainers who have earned the project's trust.\n\n## Mocha's Decision-Making Process\n\nMocha follows a [consensus-seeking decision-making](https://en.wikipedia.org/wiki/Consensus-seeking_decision-making) process.\nIn other words, all maintainers attempt to come to agreement.\nIf that fails, we decide by a simple vote.\n\nActive maintainers will make an effort to solicit feedback from others before making important or potentially controversial decisions.\nGiven the varying geographical distribution and availability of the maintenance team, we resolve to do the best we can to solicit feedback.\nWe will wait at least two weeks for consensus votes in most cases, and a month for especially important decisions.\n\nIn other words, to have your opinion heard, participate regularly.\nThe rest of the team won't wait on feedback that isn't necessarily forthcoming!\n\n## Communication\n\nMaintainers will mainly gather in the [Mocha Discord](https://discord.gg/KeDn2uXhER).\nThis is a _public_ Discord, and _anyone_ can join.\nVideoconference (or audio) calls may happen on a regular or irregular basis, as schedules allow.\nThis is mainly because we have Real Lives and time zones suck.\n\n## Working with Issues & Pull Requests\n\nAll new issues will need to be triaged, and pull requests must be examined.\nMaintainers must understand [Semantic Versioning](http://semver.org) (\"SemVer\"), as Mocha follows it strictly.\n\n> If you see an issue or PR that could use some labels, please add them!\n\n### Semantic Versioning\n\nThe TL;DR of Semantic Versioning is:\n\n- MAJOR version when you make incompatible API changes,\n- MINOR version when you add functionality in a backwards-compatible manner, and\n- PATCH version when you make backwards-compatible bug fixes.\n\nPull requests _must_ have one of these three (3) labels:\n\n- `semver-patch` for backwards-compatible bug fixes, documentation, or anything which does not affect a \"production\" (`npm install mocha`) installation of Mocha\n- `semver-minor` for backwards-compatible new features or usability/interface enhancements\n- `semver-major` for backwards-incompatible (\"breaking\") changes to the API\n\nA PR which introduces a breaking change is considered to be `semver-major`, _regardless_ of whether it's a bug fix, feature, or whatever.\n\nFor the purposes of the above definitions, Mocha has some unique considerations, and includes the following in its definition of \"API\":\n\n1. Mocha's _documented_, programmatic interface which _is not explicitly tagged with `@private`_\n1. Mocha's machine-readable reporter output\n1. Mocha's default settings\n1. Mocha's command-line options\n1. The environments which Mocha supports; this includes:\n 1. Browser versions\n 1. Node.js versions\n 1. Compatibility with popular module loaders (e.g., AMD)\n\n**Err on the side of the user; breaking changes to private APIs will be `semver-major`, if and only if they are known to be consumed by actively developed project(s).**\n\nExamples of a breaking changes might be:\n\n- Throwing an `Error` where one wasn't thrown before\n- Removing a command-line option or alias\n- Removing an environment from the CI configuration\n- Changing the default reporter!\n- Changing defaults in a way which would cause tests which were previously successful to start failing, or a failing test to start passing\n - The exception is fixing likely false-positives\n - A good example would be changing the default `timeout` value\n\n## Issue Triage\n\nIssues should be filed according to one of our [GitHub Issue forms](https://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-issue-forms).\nIf any required information is missing, add the `status: waiting for author` label and politely ask for the missing information.\n\n### Issue Meta\n\nFor all issues, apply the following labels based on which area(s) the issue pertains to:\n\n- `area: async`: Issues around Mocha's asynchronous usage\n- `area: browser`: Issues unique to a browser environment\n- `area: parallel`: Issues around Mocha's parallel mode\n- `area: reporter`: Usually concerning Mocha's output\n- `area: repository tooling`: Issues around Mocha's CI, own test suite, or other internal tooling\n- `area: security`: Involving vulnerabilities, actual or potential\n- `area: windows`: Windows-specific issues, particularly around path discrepancies\n\nAdditionally:\n\n- `good first issue`: If the implementation is likely doable by someone who's never contributed to Mocha (or potentially any other open source project) before\n- `status: duplicate`: If an equivalent issue was already filed, add this label, close as not planned, and comment with something like `duplicate of #`\n- `status: in discussion`: Add this whenever the issue is blocked on community input and/or deeper discussions\n- `status: in triage`: Added on new issues; re-add this whenever the issue is awaiting maintainer attention\n- `status: waiting for author`: Add this whenever the issue is blocked on something from the author\n\n### 🐛 Bugs\n\nBug reports should include a way to reproduce the issue that someone who is not deeply familiar with Mocha can work with locally.\n\nDepending on that reproduction, remove `status: in triage` and add the following label(s) in addition to the auto-added `type: bug`:\n\n- If the bug is valid and reproduction works: add `status: accepting prs`\n- If the bug might be valid but the reproduction isn't workable:\n - Add `status: waiting for author`\n - Politely comment explaining why the reproduction isn't workable\n- If the bug might be valid but it's not clear whether it's worth it:\n - Add `status: in discussion`\n - Explain that it _might_ be worth it and that more community input is needed\n- If the bug is clearly not worth it or valid, explain why, close the issue as not planned, and:\n - If it isn't a bug at all: add the `invalid` label\n - If it is roughly a bug but isn't something that can or should be fixed: add the `status: wontfix` label\n\n### 📝 Documentation\n\nDocumentation reports should clearly indicate a gap or problem that should be addressed in documentation.\nTriage documentation issues similar to bugs and/or feature requests - documentation is its own form of product area.\nRemove `status: in triage` and keep the auto-added `area: documentation` label.\n\n### 🚀 Features\n\nFeature requests should include a compelling reason why we should spend the maintenance time on the feature.\nGiven that Mocha is prioritizing stability over growth, this can be a high bar.\n\nDepending on the reasoning, remove `status: in triage` and add the following label(s) in addition to the auto-added `type: feature`:\n\n- If the reasoning is valid and seems worth the maintenance cost: add `status: accepting prs`\n- If the reasoning is unclear:\n - Add `status: waiting for author`\n - Politely comment explaining what's missing\n- If the feature might be valid but it's not clear whether it's worth it:\n - Add `status: in discussion`\n - Explain that it _might_ be worth it and that more community input is needed\n- If the feature is not valid, explain why, close the issue as not planned, and:\n - If it isn't a feature request at all: add the `invalid` label\n - If it is roughly a feature request but isn't something that can or should be implemented: add the `status: wontfix` label\n\n### 🛠 Tooling\n\nIssues filed about improvements to Mocha's internal development processes.\nThese can be more informally discussed by maintainers.\nRemove `status: in triage` and keep the auto-added `area: repository tooling`.\n\n### ❓ Questions\n\nOur issue tracker is not the right place to ask questions.\nIf an issue is filed that seems like it's more of a question, remove `status: in triage`, add the `type: question` label, politely direct the user to the [❓ Got a Question?](./.github/CONTRIBUTING.md#❓-got-a-question) section, and close the issue as not planned.\n\nIf it's _not_ a Mocha problem (people tend not to believe this), you may want to show a counter-example.\nIt's often helpful to direct the issue author to the responsible project, if you can determine what that is.\n\nIf this issue seems to be _repeatedly_ asked, add the `faq` label.\nThis may also apply to questions which receive a lot of 👍 reactions.\n\n### Closing Issues\n\nWrite \"closes #000\" (where 000 is the issue number) or \"resolves #000\" in a commit or PR to have the original issue closed automatically once the PR is merged.\n\nFor any issue which is a duplicate, write \"duplicate of #000\" in a new comment, and close the issue.\n[Read more about marking issues as duplicates](https://help.github.com/articles/about-duplicate-issues-and-pull-requests/).\n\nIf the issue is a support question, and you believe it has been answered, close the issue.\n\nIf the issue is not Mocha-related, and/or a bug cannot be confirmed, label it `invalid` and close.\n\n## Commenting on Issues and Reviewing Pull Requests\n\n**All maintainers should be courteous and kind.** Thank the external contributor for the pull request, even if it is not merged.\nIf the pull request has been opened (and subsequently closed) without discussion in a corresponding issue, let them know that by creating an issue first, they could have saved wasted effort.\n_Clearly and objectively_ explain the reasoning for rejecting any PR.\n\nIf you need more information in an issue, nicely ask the user to provide it.\nRemind them to use the issue/PR templates if they have not.\n\n### Reviewing Code\n\nUse GitHub's code review features.\nRequesting a review from another maintainer _may or may not_ actually result in a review; don't wait on it.\nIf the PR cannot move forward without input from a certain maintainer, _assign them to the PR_.\n\n### The Part About Jerks\n\nThere will be jerks.\n\n#### Rude or Entitled People\n\nThese are users who feel the Mocha project and its maintainers _owe them_ time or support.\nThis is incorrect.\n\nHowever, this behavior is often indicative of someone who is \"new\" to open source.\nMany just don't know better.\nIt is not your _responsibility_ to educate them (again, you owe them nothing).\n\nHere are some suggestions:\n\n1. If u mad, wait 20 minutes before writing a comment.\n1. \"Kill them with kindness\".\n Explain how they are presenting themselves; maybe link to a good article or two about it.\n1. Don't make it about \"users vs.\n maintainers\".\n Treat them like a potential future maintainer.\n1. Avoid adding to the drama.\n You could try to reach out privately; email may be in their GitHub profile.\n You will likely never hear from that individual again (problem solved)\n1. If an issue is getting out of control, lock it.\n1. If someone is _repeatedly_ rude and does not correct their mistakes, you may ban them from participating in the `mochajs` org.\n If you do not have permission to do so, contact one which does (an \"owner\").\n\n#### Code of Conduct Violations\n\n**This section is theoretical, as it's yet to happen**.\n\n1. Inform the individual of the violation; link to the CoC\n1. Follow up with OpenJS Foundation for further guidance\n1. Repeated violators will be banned inasmuch as that is technically possible\n1. No maintainer nor contributor is exempt from the CoC\n\n## Branches\n\n`main` is the only maintained branch in `mochajs/mocha` or any of the other repos.\n**`main` is the only branch to which force-pushing is disallowed.**\n\nMaintainers may push new branches to a repo, as long as they remove them when finished (merging a PR will prompt to do so).\n\nPlease _please_ **_please_** delete old or unused branches.\n\n## Merging PRs\n\nWe prefer to [squash merge](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/about-pull-request-merges#squash-and-merge-your-commits) PRs.\nRequiring users to keep clean histories for rebasing would be a large ask that we don't feel justifies the benefits.\n\n**Upon acceptance of a PR, you must assign it a milestone.**\n\n### Using Milestones\n\nIf you know that the PR is breaking, assign it to a new or existing milestone correlating with the next major release.\nFor example, if Mocha's current version is v6.5.2, then this milestone would be named `v7.0.0`.\n\nLikewise, if the PR is `semver-minor`, create or use a new milestone correlating to the next _minor_ release, e.g., `v6.6.0`.\n\nIf it's unclear what the next milestone will be, use or create a milestone named `next`.\nThis milestone will be renamed to the new version at release time.\n\nBy using milestones, we can cherry-pick non-breaking changes into minor or patch releases, and keep `main` as the latest version.\n\n**This is subject to change, hopefully.**\n\n## Mocha's Release Process\n\nReleases are managed by [Release Please](https://github.com/googleapis/release-please) and require manual approval after tests pass.\nTo create a new release after merging changes, merge the _`chore(main): release...`_ pull request that its automation has created.\nDoing so will:\n\n1. Create a new GitHub release\n2. Cause a CI job to run on `main` that will publish the package to npm\n\nYou'll then need to go to the `chore(main): release ...` commit _Publish to npm_ job run logs and click the _Review pending deployments_ link.\n\n### Major releases\n\nFor major releases, we follow an even-odd pattern:\n\n- Even versions only update dependencies and avoid breaking functional changes\n- Odd versions can update dependencies and add breaking functional changes\n\nThis results in even versions being quite small but easy to migrate to, and odd versions can usually focus on the functional changes.\n\nFor large releases, we recommend betas, then release candidates (RCs), then a full release.\nBetas are when most features are available, but more will likely be added before full release.\nRCs are almost ready for release, but would benefit from user testing before a full release.\n\nTo start a new major version beta, add `Release-As: 12.0.0-beta.1` to the additional details of your PR commit message.\nThis must be part the last line of the commit message, not the PR description.\nRelease Please respects this property and will update accordingly.\nYou can also set Release Please to prelease mode to increment the beta number.\n\n> **Important:** Always use a dot (`.`) as the separator between the pre-release label and the number (e.g. `beta.1`, not `beta-1`).\n> The `semver` library (used by npm) treats dot-separated numeric identifiers numerically, so `beta.10 > beta.9`.\n> With a dash separator, `beta-10` is a single string identifier and sorts before `beta-9` alphabetically.\n\nTo transition to an RC, add `Release-As: 12.0.0-rc.1` at the end of the PR commit message.\n\nTo transition from betas or RCs to a full release, just change Release Please back to `prerelease: false`.\n\n## About The OpenJS Foundation\n\nThe [OpenJS Foundation](https://js.foundation) retains copyright of all projects underneath the [mochajs org](https://github.com/mochajs).\nThe Foundation does not influence technical decisions nor the project roadmap.\nIt is, however, charged with ensuring the continued vitality and sustainability of projects under its banner.\n\nAs a maintainer, you have access to the resources the OpenJS Foundation provides.\n\n## About OpenCollective\n\nMocha collects donations [via OpenCollective](https://opencollective.com/mochajs). As a maintainer, you may help decide how the funds are used. These decisions are made via a consensus-seeking process, much like any other decision.\n\nExpense transparency is built in to OpenCollective.\n\n---\n\nQuestions? Ask in the [Mocha Discord](https://discord.gg/KeDn2uXhER)!\n" }, { "path": "PROJECT_CHARTER.md", "content": "# Mocha Charter\n\nThis project charter serves as a statement of scope and objectives for the **Mocha** project.\n\n## §1: Guiding Principles\n\nThe **Mocha** project is part of the [OpenJS Foundation], which operates transparently, openly, collaboratively, and ethically. Project proposals, timelines, and status must not merely be open, but also easily visible to outsiders.\n\n## §2: Scope\n\n**Mocha** is a unopinionated, _general-purpose testing framework_ for the JavaScript community. **Mocha** favors flexibility over rigidity, stability over disruption, and deliberation over agility. **Mocha** aims to do one thing, and do it well. **Mocha** will strive to evolve with the needs of the community, but will make every effort not to abandon its current users in doing so.\n\n### §2.1: In-Scope\n\n- APIs (\"interfaces\") to write and organize tests written in JavaScript or compile-to-JavaScript languages\n- Command-line executable to run tests in a Node.js-based terminal environment\n- API to run tests in a browser environment\n- Output test results and errors (provide \"reporters\") to:\n - Terminal\n - File\n - Browser\n - Memory\n- APIs to extend functionality\n- File-based and code-based configuration\n- Internal test coverage for all of the above\n- Documentation including (but not limited to):\n - Website ([https://mochajs.org](https://mochajs.org)) contents and design\n - Test-writing and test-organizing APIs\n - Reporters\n - [Extensible APIs](https://mochajs.org/api)\n - Tutorials and [code samples](https://github.com/mochajs/mocha-examples)\n - Command-line execution and options\n - Browser-based execution and options\n - [Project administration](https://github.com/mochajs/admin)\n - [Contribution guide](https://github.com/mochajs/mocha/blob/main/.github/CONTRIBUTING.md)\n- General support for multiple levels of tests, including (but not limited to):\n - Unit tests\n - Integration tests\n - Functional/end-to-end tests\n - Operational readiness tests\n- Tool configuration for project tests, build, documentation or website deployment\n- Bespoke tools, if needed\n- LTS (long-term support) policies, processes, and release cadence\n- Third-party service integrations (e.g., bots, CI servers, SCM)\n- Project-endorsed spaces for collaboration (chat rooms, mailing lists, forums, etc.)\n- Project-maintained social media, if any\n\n### §2.2: Out-of-Scope\n\n- [Test assertions](https://wikipedia.org/wiki/Test_assertion) and [mocks](https://en.wikipedia.org/wiki/Mock_object) or related\n- Compatibility with other 3rd-party libraries not hosted under GitHub's [mochajs organization](https://github.com/mochajs) unless explicitly stated in [§2: Scope](#2-scope)\n - Note: _existence of \"official\" code samples does not imply explicit support_\n - Efforts must be made to retain compatibility with popular libraries, frameworks and tools, but not at the expense of Mocha itself\n- Use within _unmaintained_ versions of Node.js\n- Use within browsers not meeting a threshold decided upon by maintainers\n- Use within non-Node.js or non-browser environments, unless otherwise explicitly stated in [§2: Scope](#2-scope)\n- \"Unofficial\" collaboration or Q&A spaces (including Stack Overflow and Quora)\n- Certain classes of contributions:\n - Bug fixes or enhancements without associated test coverage\n - Features having limited general-purpose use (as determined by maintainers)\n - Bug fixes which \"break\" more users than are affected by the bug itself, _regardless_ of \"correctness\"\n - Breaking changes to API without demonstrated need, especially those which would cause correct, currently-passing tests to fail\n - Changes that significantly negatively impact performance without demonstrated need\n - Code reviews, issue comments or pull requests which are dogmatic, demanding, or excessively critical as to discourage contributions by others\n - Those which violate Mocha's [Code of Conduct]\n\n## §3: Relationship with OpenJS Foundation CPC\n\nTechnical leadership for the projects within the [OpenJS Foundation] is delegated to the projects through their project charters by the [OpenJS Foundation Cross-Project Council](https://openjsf.org/about/governance/) (CPC). In the case of the Mocha project, it is delegated exclusively to the maintainers of Mocha. The OpenJS Foundation's business leadership is the Board of Directors.\n\nChanges to the following **cannot** unilaterally be applied by project leadership, and must be ratified by the CPC:\n\n- Mocha's Project Charter (this document)\n- Mocha's [Code of Conduct]\n- Mocha's licenses: [MIT](https://github.com/mochajs/mocha/blob/main/LICENSE) (for code) and [CC-BY-4.0](https://github.com/mochajs/mocha/blob/main/docs/LICENSE-CC-BY-4.0) (for documentation/website)\n\n### §3.1: Other Formal Project Relationships\n\nSection Intentionally Left Blank\n\n## §4: Mocha's Governing Body\n\nMocha is governed by its maintainers. See [MAINTAINERS.md] for more information.\n\n## §5: Roles & Responsibilities\n\nThe roles and responsibilities of Mocha's maintainers are described in [MAINTAINERS.md].\n\n### §5.1: Project Operations & Management\n\nProject operations and processes are described in [MAINTAINERS.md].\n\n### §5.2: Decision-making, Voting, and/or Elections\n\nMocha uses a loose consensus-seeking process, described in [MAINTAINERS.md].\n\n### §5.3: Other Project Roles\n\nSection Intentionally Left Blank\n\n## §6: Definitions\n\nSection Intentionally Left Blank\n\n[openjs foundation]: https://openjsf.org\n[maintainers.md]: https://github.com/mochajs/mocha/blob/main/MAINTAINERS.md\n[code of conduct]: https://github.com/mochajs/mocha/blob/main/.github/CODE_OF_CONDUCT.md\n" }, { "path": "README.md", "content": "

\n \"Mocha\n

\n\n

☕️ Classic, reliable, trusted test framework for Node.js and the browser ☕️

\n\n
\n\n\"NPM\n\"Node\n[![GitHub Actions Build Status](https://github.com/mochajs/mocha/actions/workflows/mocha.yml/badge.svg)](https://github.com/mochajs/mocha/actions/workflows/mocha.yml)\n\"Codecov\n\n
\n\n
\n\n\"Chat\n\"OpenCollective\n\"OpenCollective\n[![Collective Funds Guidelines v0.1](https://img.shields.io/badge/collective_funds_guidelines-v0.1-D8E8D4?style=flat&labelColor=3A6457)](https://github.com/collective-funds/guidelines)\n\n
\n\n## Links\n\n- **[Documentation](https://mochajs.org)**\n- **[Release Notes / History / Changes](https://github.com/mochajs/mocha/blob/main/CHANGELOG.md)**\n- [Code of Conduct](https://github.com/mochajs/mocha/blob/main/.github/CODE_OF_CONDUCT.md)\n- [Contributing](https://github.com/mochajs/mocha/blob/main/.github/CONTRIBUTING.md)\n- [Development](https://github.com/mochajs/mocha/blob/main/.github/DEVELOPMENT.md)\n- [Discord](https://discord.gg/KeDn2uXhER) (ask questions here!)\n- [Issue Tracker](https://github.com/mochajs/mocha/issues)\n\n## Backers\n\n[Become a backer](https://opencollective.com/mochajs) and show your support to our open source project on [our site](https://mochajs.org/#backers).\n\n\"Mocha's\n\n## Sponsors\n\nDoes your company use Mocha? Ask your manager or marketing team if your company would be interested in supporting our project.\nSupport will allow the maintainers to dedicate more time for maintenance and new features for everyone.\nAlso, your company's logo will show [on GitHub](https://github.com/mochajs/mocha#readme) and on [our site](https://mochajs.org#sponsors) - who doesn't want a little extra exposure?\n[Here's the info](https://opencollective.com/mochajs).\n\n[![MochaJS Sponsor](https://opencollective.com/mochajs/tiers/sponsors/0/avatar)](https://opencollective.com/mochajs/tiers/sponsors/0/website)\n[![MochaJS Sponsor](https://opencollective.com/mochajs/tiers/sponsors/1/avatar)](https://opencollective.com/mochajs/tiers/sponsors/1/website)\n[![MochaJS Sponsor](https://opencollective.com/mochajs/tiers/sponsors/2/avatar)](https://opencollective.com/mochajs/tiers/sponsors/2/website)\n[![MochaJS Sponsor](https://opencollective.com/mochajs/tiers/sponsors/3/avatar)](https://opencollective.com/mochajs/tiers/sponsors/3/website)\n\n## Development\n\nYou might want to know that:\n\n- Mocha is one of the _most-depended-upon_ modules on npm (source: [libraries.io](https://libraries.io/search?order=desc&platforms=NPM&sort=dependents_count)), and\n- Mocha is an _independent_ open-source project, maintained exclusively by volunteers.\n\nYou might want to help:\n\n- New to contributing to Mocha? Check out this list of [good first issues](https://github.com/mochajs/mocha/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22)\n- Mocha could use a hand with [these issues](https://github.com/mochajs/mocha/issues?q=is%3Aopen+is%3Aissue+label%3A%22status%3A+accepting+prs%22)\n- The [maintainer's handbook](https://github.com/mochajs/mocha/blob/main/MAINTAINERS.md) explains how things get done\n\nFinally, come [chat with the maintainers on Discord](https://discord.gg/KeDn2uXhER) if you want to help with:\n\n- Triaging issues, answering questions\n- Review, merging, and closing pull requests\n- Other project-maintenance-y things\n\n## License\n\nCopyright 2011-2024 OpenJS Foundation and contributors. Licensed [MIT](https://github.com/mochajs/mocha/blob/main/LICENSE).\n" }, { "path": "SECURITY.md", "content": "# Security Policy\n\n## Security contact information\n\nTo report a security vulnerability, please use the\n[Tidelift security contact](https://tidelift.com/security).\nTidelift will coordinate the fix and disclosure.\n\n## Escalation\n\nIf you do not receive an acknowledgement of your report\nwithin 6 business days, or if you cannot find a private\nsecurity contact for the project, you may escalate to the\nOpenJS Foundation CNA at `security@lists.openjsf.org`.\n\nIf the project acknowledges your report but does not\nprovide any further response or engagement within 14 days,\nescalation is also appropriate.\n" }, { "path": "bin/_mocha", "content": "#!/usr/bin/env node\n\"use strict\";\n\n/**\n * This file remains for backwards compatibility only.\n * Don't put stuff in this file.\n * @see module:lib/cli\n */\n\nrequire(\"../lib/cli\").main();\n" }, { "path": "bin/mocha.js", "content": "#!/usr/bin/env node\n\n\"use strict\";\n\n/**\n * This wrapper executable checks for known node flags and appends them when found,\n * before invoking the \"real\" executable (`lib/cli/cli.js`)\n *\n * @module bin/mocha\n * @private\n */\n\nconst os = require(\"node:os\");\nconst { loadOptions } = require(\"../lib/cli/options\");\nconst {\n unparseNodeFlags,\n isNodeFlag,\n impliesNoTimeouts,\n} = require(\"../lib/cli/node-flags\");\nconst unparse = require(\"yargs-unparser\");\nconst debug = require(\"debug\")(\"mocha:cli:mocha\");\nconst { aliases } = require(\"../lib/cli/run-option-metadata\");\n\nconst mochaArgs = {};\nconst nodeArgs = {};\nconst SIGNAL_OFFSET = 128;\nlet hasInspect = false;\n\nconst opts = loadOptions(process.argv.slice(2));\ndebug(\"loaded opts\", opts);\n\n/**\n * Given option/command `value`, disable timeouts if applicable\n * @param {string} [value] - Value to check\n * @ignore\n */\nconst disableTimeouts = (value) => {\n if (impliesNoTimeouts(value)) {\n debug(\"option %s disabled timeouts\", value);\n mochaArgs.timeout = 0;\n }\n};\n\n/**\n * If `value` begins with `v8-` and is not explicitly `v8-options`, remove prefix\n * @param {string} [value] - Value to check\n * @returns {string} `value` with prefix (maybe) removed\n * @ignore\n */\nconst trimV8Option = (value) =>\n value !== \"v8-options\" && /^v8-/.test(value) ? value.slice(3) : value;\n\n// sort options into \"node\" and \"mocha\" buckets\nObject.keys(opts).forEach((opt) => {\n if (isNodeFlag(opt)) {\n nodeArgs[trimV8Option(opt)] = opts[opt];\n } else {\n mochaArgs[opt] = opts[opt];\n }\n});\n\n// disable 'timeout' for debugFlags\nObject.keys(nodeArgs).forEach((opt) => disableTimeouts(opt));\nmochaArgs[\"node-option\"] &&\n mochaArgs[\"node-option\"].forEach((opt) => disableTimeouts(opt));\n\n// Native debugger handling\n// see https://nodejs.org/api/debugger.html#debugger_debugger\n// look for 'inspect' that would launch this debugger,\n// remove it from Mocha's opts and prepend it to Node's opts.\n// A deprecation warning will be printed by node, if applicable.\n// (mochaArgs._ are \"positional\" arguments, not prefixed with - or --)\nif (mochaArgs._) {\n const i = mochaArgs._.findIndex((val) => val === \"inspect\");\n if (i > -1) {\n mochaArgs._.splice(i, 1);\n disableTimeouts(\"inspect\");\n hasInspect = true;\n }\n}\n\nif (mochaArgs[\"node-option\"] || Object.keys(nodeArgs).length || hasInspect) {\n const { spawn } = require(\"node:child_process\");\n const mochaPath = require.resolve(\"../lib/cli/cli.js\");\n\n const nodeArgv =\n (mochaArgs[\"node-option\"] &&\n mochaArgs[\"node-option\"].map((v) => \"--\" + v)) ||\n unparseNodeFlags(nodeArgs);\n\n if (hasInspect) nodeArgv.unshift(\"inspect\");\n delete mochaArgs[\"node-option\"];\n\n debug(\"final node argv\", nodeArgv);\n\n const args = [].concat(\n nodeArgv,\n mochaPath,\n unparse(mochaArgs, { alias: aliases }),\n );\n\n debug(\n \"forking child process via command: %s %s\",\n process.execPath,\n args.join(\" \"),\n );\n\n const proc = spawn(process.execPath, args, {\n stdio: \"inherit\",\n });\n\n proc.on(\"exit\", (code, signal) => {\n process.on(\"exit\", () => {\n if (signal) {\n signal =\n typeof signal === \"string\" ? os.constants.signals[signal] : signal;\n if (mochaArgs[\"posix-exit-codes\"] === true) {\n process.exitCode = SIGNAL_OFFSET + signal;\n }\n process.kill(process.pid, signal);\n } else {\n process.exit(Math.min(code, mochaArgs[\"posix-exit-codes\"] ? 1 : 255));\n }\n });\n });\n\n // terminate children.\n process.on(\"SIGINT\", () => {\n // XXX: a previous comment said this would abort the runner, but I can't see that it does\n // anything with the default runner.\n debug(\"main process caught SIGINT\");\n proc.kill(\"SIGINT\");\n // if running in parallel mode, we will have a proper SIGINT handler, so the below won't\n // be needed.\n if (!args.parallel || args.jobs < 2) {\n // win32 does not support SIGTERM, so use next best thing.\n if (os.platform() === \"win32\") {\n proc.kill(\"SIGKILL\");\n } else {\n // using SIGKILL won't cleanly close the output streams, which can result\n // in cut-off text or a befouled terminal.\n debug(\"sending SIGTERM to child process\");\n proc.kill(\"SIGTERM\");\n }\n }\n });\n} else {\n debug(\"running Mocha in-process\");\n require(\"../lib/cli/cli\").main([], mochaArgs);\n}\n" }, { "path": "browser-entry.js", "content": "\"use strict\";\n\n/* eslint no-unused-vars: off */\n\n/**\n * Shim process.stdout.\n */\n\nprocess.stdout = require(\"browser-stdout\")({ label: false });\n\nvar parseQuery = require(\"./lib/browser/parse-query\");\nvar highlightTags = require(\"./lib/browser/highlight-tags\");\nvar Mocha = require(\"./lib/mocha\");\n\n/**\n * Create a Mocha instance.\n *\n * @return {undefined}\n */\n\nvar mocha = new Mocha({ reporter: \"html\" });\n\n/**\n * Save timer references to avoid Sinon interfering (see GH-237).\n */\n\nvar Date = global.Date;\nvar setTimeout = global.setTimeout;\nvar setInterval = global.setInterval;\nvar clearTimeout = global.clearTimeout;\nvar clearInterval = global.clearInterval;\n\nvar uncaughtExceptionHandlers = [];\n\nvar originalOnerrorHandler = global.onerror;\n\n/**\n * Remove uncaughtException listener.\n * Revert to original onerror handler if previously defined.\n */\n\nprocess.removeListener = function (e, fn) {\n if (e === \"uncaughtException\") {\n if (originalOnerrorHandler) {\n global.onerror = originalOnerrorHandler;\n } else {\n global.onerror = function () {};\n }\n var i = uncaughtExceptionHandlers.indexOf(fn);\n if (i !== -1) {\n uncaughtExceptionHandlers.splice(i, 1);\n }\n }\n};\n\n/**\n * Implements listenerCount for 'uncaughtException'.\n */\n\nprocess.listenerCount = function (name) {\n if (name === \"uncaughtException\") {\n return uncaughtExceptionHandlers.length;\n }\n return 0;\n};\n\n/**\n * Implements uncaughtException listener.\n */\n\nprocess.on = function (e, fn) {\n if (e === \"uncaughtException\") {\n global.onerror = function (msg, url, line, col, err) {\n fn(err || new Error(msg + \" (\" + url + \":\" + line + \":\" + col + \")\"));\n return !mocha.options.allowUncaught;\n };\n uncaughtExceptionHandlers.push(fn);\n }\n};\n\nprocess.listeners = function (err) {\n if (err === \"uncaughtException\") {\n return uncaughtExceptionHandlers;\n }\n return [];\n};\n\n// The BDD UI is registered by default, but no UI will be functional in the\n// browser without an explicit call to the overridden `mocha.ui` (see below).\n// Ensure that this default UI does not expose its methods to the global scope.\nmocha.suite.removeAllListeners(\"pre-require\");\n\nvar immediateQueue = [];\nvar immediateTimeout;\n\nfunction timeslice() {\n var immediateStart = new Date().getTime();\n while (immediateQueue.length && new Date().getTime() - immediateStart < 100) {\n immediateQueue.shift()();\n }\n if (immediateQueue.length) {\n immediateTimeout = setTimeout(timeslice, 0);\n } else {\n immediateTimeout = null;\n }\n}\n\n/**\n * High-performance override of Runner.immediately.\n */\n\nMocha.Runner.immediately = function (callback) {\n immediateQueue.push(callback);\n if (!immediateTimeout) {\n immediateTimeout = setTimeout(timeslice, 0);\n }\n};\n\n/**\n * Function to allow assertion libraries to throw errors directly into mocha.\n * This is useful when running tests in a browser because window.onerror will\n * only receive the 'message' attribute of the Error.\n */\nmocha.throwError = function (err) {\n uncaughtExceptionHandlers.forEach(function (fn) {\n fn(err);\n });\n throw err;\n};\n\n/**\n * Override ui to ensure that the ui functions are initialized.\n * Normally this would happen in Mocha.prototype.loadFiles.\n */\n\nmocha.ui = function (ui) {\n Mocha.prototype.ui.call(this, ui);\n this.suite.emit(\"pre-require\", global, null, this);\n return this;\n};\n\n/**\n * Setup mocha with the given setting options.\n */\n\nmocha.setup = function (opts) {\n if (typeof opts === \"string\") {\n opts = { ui: opts };\n }\n if (opts.delay === true) {\n this.delay();\n }\n var self = this;\n Object.keys(opts)\n .filter(function (opt) {\n return opt !== \"delay\";\n })\n .forEach(function (opt) {\n if (Object.prototype.hasOwnProperty.call(opts, opt)) {\n self[opt](opts[opt]);\n }\n });\n return this;\n};\n\n/**\n * Run mocha, returning the Runner.\n */\n\nmocha.run = function (fn) {\n var options = mocha.options;\n mocha.globals(\"location\");\n\n var query = parseQuery(global.location.search || \"\");\n if (query.grep) {\n mocha.grep(query.grep);\n }\n if (query.fgrep) {\n mocha.fgrep(query.fgrep);\n }\n if (query.invert) {\n mocha.invert();\n }\n\n return Mocha.prototype.run.call(mocha, function (err) {\n // The DOM Document is not available in Web Workers.\n var document = global.document;\n if (\n document &&\n document.getElementById(\"mocha\") &&\n options.noHighlighting !== true\n ) {\n highlightTags(\"code\");\n }\n if (fn) {\n fn(err);\n }\n });\n};\n\n/**\n * Expose the process shim.\n * https://github.com/mochajs/mocha/pull/916\n */\n\nMocha.process = process;\n\n/**\n * Expose mocha.\n */\nglobal.Mocha = Mocha;\nglobal.mocha = mocha;\n\n// for bundlers: enable `import {describe, it} from 'mocha'`\n// `bdd` interface only\n// prettier-ignore\n[ \n 'describe', 'context', 'it', 'specify',\n 'xdescribe', 'xcontext', 'xit', 'xspecify',\n 'before', 'beforeEach', 'afterEach', 'after'\n].forEach(function(key) {\n mocha[key] = global[key];\n});\n\nmodule.exports = mocha;\n" }, { "path": "docs/.gitignore", "content": ".astro/\ndist/\nnode_modules/\nsrc/content/data/supporters.json\n" }, { "path": "docs/.knip.jsonc", "content": "{\n \"$schema\": \"https://unpkg.com/knip@5/schema-jsonc.json\",\n // Entry points marked with ! are analyzed but not reported as unused\n \"entry\": [\"src/content/**/*.mdx!\"],\n \"project\": [\"src/**/*.{ts,js,mjs,cjs,astro}\"],\n \"astro\": {\n \"config\": \"astro.config.ts\",\n },\n \"rules\": {\n \"exports\": \"off\",\n },\n}\n" }, { "path": "docs/.prettierrc.json", "content": "{\n \"bracketSpacing\": true\n}\n" }, { "path": "docs/README.md", "content": "# Mocha Docs: Built on Astro Starlight\n\nThis is the current Mocha documentation website, hosted at [mochajs.org](https://mochajs.org) and built with [Astro Starlight](https://starlight.astro.build).\n\n> For details on the legacy site, see [https://github.com/mochajs/docs-legacy](mochajs/docs-legacy).\n\n## Preview the new site\n\nTo run this site:\n\n```shell\ncd docs\nnpm i\nnpm run generate\nnpm run dev\n```\n" }, { "path": "docs/_data/blocklist.json", "content": "[\n \"cheap-writing-service\",\n \"coin-master-free-spins\",\n \"cyberflix-tv\",\n \"device-tricks1\",\n \"domywriting\",\n \"emailmarketingservices-io\",\n \"hurtiglaan-nu\",\n \"igor-noskov\",\n \"mochajs\",\n \"my-true-media\",\n \"open-apk-file\",\n \"thetoy\",\n \"trust-my-paper\",\n \"writemypaper4me\",\n \"writerseperhour\",\n \"yiannakis-ttafounas-ttafounas\"\n]\n" }, { "path": "docs/_data/supporters.cjs", "content": "/**\n * This script gathers metadata for active supporters of Mocha from OpenCollective's\n * API by aggregating order (\"donation\") information.\n *\n * It's intended to be used with 11ty, but can be run directly. Running directly\n * enables debug output.\n *\n * - gathers logo/avatar images (they are always pngs)\n * - gathers links\n * - sorts by tier and total contributions\n * - validates images\n * - writes images to a temp dir\n * @see https://docs.opencollective.com/help/contributing/development/api\n */\n\n\"use strict\";\n\nconst { writeFile, mkdir, rm } = require(\"node:fs\").promises;\nconst { resolve } = require(\"node:path\");\nconst debug = require(\"debug\")(\"mocha:docs:data:supporters\");\nconst blocklist = new Set(require(\"./blocklist.json\"));\n\n/**\n * In addition to the blocklist, any account slug matching this regex will not\n * be displayed on the website.\n */\nconst BLOCKED_STRINGS =\n /(?:[ck]a[sz]ino|seo|slot|gambl(?:e|ing)|crypto|follow|buy|cheap|instagram|hacks|tiktok|likes|youtube|subscriber|boost|deposit|mushroom|bingo|broker|promotion|bathroom|landscaping|lawn care|groundskeeping|remediation|esports|links|coupon|review|refer|promocode|rabattkod|jämför|betting|reddit|hire|fortune|equity|download|marketing|comment|rank|scrapcar|lawyer|celeb|concrete|firestick|playground|betking)/i;\n\n/**\n * Add a few Categories exposed by Open Collective to help moderation\n */\nconst BLOCKED_CATEGORIES = [\n \"adult\",\n \"casino\",\n \"credit\",\n \"gambling\",\n \"seo\",\n \"writer\",\n \"review\",\n];\n\n/**\n * The OC API endpoint\n\n */\nconst API_ENDPOINT = \"https://api.opencollective.com/graphql/v2\";\n\nconst SPONSOR_TIER = \"sponsors\";\nconst BACKER_TIER = \"backers\";\n\n// if this percent of fetches completes, the build will pass\nconst PRODUCTION_SUCCESS_THRESHOLD = 0.9;\n\nconst SUPPORTER_IMAGE_PATH = resolve(__dirname, \"../images/supporters\");\n\nconst SUPPORTER_QUERY = `query account($limit: Int, $offset: Int, $slug: String) {\n account(slug: $slug) {\n orders(limit: $limit, offset: $offset, status: ACTIVE, filter: INCOMING) {\n limit\n offset\n totalCount\n nodes {\n fromAccount {\n id\n name\n slug\n website\n imgUrlMed: imageUrl(height:64)\n imgUrlSmall: imageUrl(height:32)\n type\n categories\n }\n tier { slug }\n totalDonations { value }\n createdAt\n }\n }\n }\n}`;\n\nconst GRAPHQL_PAGE_SIZE = 1000;\n\nconst invalidSupporters = [];\n\nconst nodeToSupporter = (node) => ({\n id: node.fromAccount.id,\n name: node.fromAccount.name,\n slug: node.fromAccount.slug,\n website: node.fromAccount.website,\n imgUrlMed: node.fromAccount.imgUrlMed,\n imgUrlSmall: node.fromAccount.imgUrlSmall,\n type: node.fromAccount.type,\n categories: node.fromAccount.categories,\n tier: (node.tier && node.tier.slug) || BACKER_TIER,\n totalDonations: node.totalDonations.value * 100,\n firstDonation: node.createdAt,\n});\n\nconst fetchImage = process.env.MOCHA_DOCS_SKIP_IMAGE_DOWNLOAD\n ? async (supporter) => {\n invalidSupporters.push(supporter);\n }\n : async (supporter) => {\n try {\n const { avatar: url } = supporter;\n const response = await fetch(url, {\n signal: AbortSignal.timeout(30000),\n });\n if (response.headers.get(\"content-type\")?.startsWith(\"text/html\")) {\n throw new TypeError(\n \"received html and expected a png; outage likely\",\n );\n }\n const imageBuf = Buffer.from(await response.arrayBuffer());\n debug(\"fetched %s\", url);\n const filePath = resolve(SUPPORTER_IMAGE_PATH, supporter.id + \".png\");\n await writeFile(filePath, imageBuf);\n debug(\"wrote %s\", filePath);\n } catch (err) {\n console.error(\n `failed to load ${supporter.avatar}; will discard ${supporter.tier} \"${supporter.name} (${supporter.slug}). reason:\\n`,\n err,\n );\n invalidSupporters.push(supporter);\n }\n };\n\n/**\n * Retrieves donation data from OC\n *\n * Handles pagination\n * @param {string} slug - Collective slug to get donation data from\n * @returns {Promise} Array of raw donation data\n */\nconst getAllOrders = async (slug = \"mochajs\") => {\n let allOrders = [];\n const variables = { limit: GRAPHQL_PAGE_SIZE, offset: 0, slug };\n\n // Handling pagination if necessary (2 pages for ~1400 results in May 2019)\n while (true) {\n const response = await fetch(API_ENDPOINT, {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/json\" },\n body: JSON.stringify({\n query: SUPPORTER_QUERY,\n variables: variables,\n }),\n });\n const result = await response.json();\n const orders = result.data.account.orders.nodes;\n allOrders = [...allOrders, ...orders];\n variables.offset += GRAPHQL_PAGE_SIZE;\n if (orders.length < GRAPHQL_PAGE_SIZE) {\n debug(\"retrieved %d orders\", allOrders.length);\n return allOrders;\n } else {\n debug(\n \"loading page %d of orders...\",\n Math.floor(variables.offset / GRAPHQL_PAGE_SIZE),\n );\n }\n }\n};\n\nconst isAllowed = ({ name, slug, website, categories }) => {\n const allowed =\n !blocklist.has(slug) &&\n !BLOCKED_STRINGS.test(name) &&\n !BLOCKED_STRINGS.test(slug) &&\n !BLOCKED_STRINGS.test(website) &&\n !categories.some((category) => BLOCKED_CATEGORIES.includes(category));\n\n if (!allowed) {\n debug(\"filtering %o\", { categories, name, slug, website });\n } else {\n // debug('keeping %o', {categories, name, slug, website}, BLOCKED_STRINGS.test(website));\n }\n\n return allowed;\n};\n\nconst getSupporters = async () => {\n const orders = await getAllOrders();\n // Deduplicating supporters with multiple orders\n const uniqueSupporters = new Map();\n\n const supporters = orders\n // turn raw query result into a better data structure\n .map(nodeToSupporter)\n // aggregate total $ donated by unique supporter (using slug)\n .reduce((supporters, supporter) => {\n if (uniqueSupporters.has(supporter.slug)) {\n uniqueSupporters.get(supporter.slug).totalDonations +=\n supporter.totalDonations;\n return supporters;\n }\n uniqueSupporters.set(supporter.slug, supporter);\n return [...supporters, supporter];\n }, [])\n // discard spammy supporters\n .filter(isAllowed)\n // sort by total $ donated, descending\n .sort((a, b) => b.totalDonations - a.totalDonations)\n // determine which url to use depending on tier\n .reduce(\n (supporters, supporter) => {\n if (supporter.tier === BACKER_TIER) {\n if (supporter.name !== \"anonymous\") {\n supporters[BACKER_TIER] = [\n ...supporters[BACKER_TIER],\n {\n ...supporter,\n avatar: encodeURI(supporter.imgUrlSmall),\n },\n ];\n }\n } else {\n supporters[SPONSOR_TIER] = [\n ...supporters[SPONSOR_TIER],\n {\n ...supporter,\n avatar: encodeURI(supporter.imgUrlMed),\n },\n ];\n }\n return supporters;\n },\n {\n [SPONSOR_TIER]: [],\n [BACKER_TIER]: [],\n },\n );\n\n await rm(SUPPORTER_IMAGE_PATH, { recursive: true, force: true });\n debug(\"blasted %s\", SUPPORTER_IMAGE_PATH);\n await mkdir(SUPPORTER_IMAGE_PATH, { recursive: true });\n debug(\"created %s\", SUPPORTER_IMAGE_PATH);\n\n // Fetch images for sponsors and save their image dimensions\n await Promise.all([\n ...supporters[SPONSOR_TIER].map(fetchImage),\n ...supporters[BACKER_TIER].map(fetchImage),\n ]);\n debug(\"fetched images\");\n\n invalidSupporters.forEach((supporter) => {\n supporters[supporter.tier].splice(\n supporters[supporter.tier].indexOf(supporter),\n 1,\n );\n });\n debug(\"tossed out invalid supporters\");\n\n const backerCount = supporters[BACKER_TIER].length;\n const sponsorCount = supporters[SPONSOR_TIER].length;\n const totalSupportersCount = backerCount + sponsorCount;\n const successRate = 1 - invalidSupporters.length / totalSupportersCount;\n\n debug(\n \"found %d valid backers and %d valid sponsors (%d total; %d invalid; %d blocked)\",\n backerCount,\n sponsorCount,\n totalSupportersCount,\n invalidSupporters.length,\n uniqueSupporters.size - totalSupportersCount,\n );\n\n if (successRate < PRODUCTION_SUCCESS_THRESHOLD) {\n if (process.env.NETLIFY && process.env.CONTEXT !== \"deploy-preview\") {\n throw new Error(\n `Failed to meet success threshold ${\n PRODUCTION_SUCCESS_THRESHOLD * 100\n }% (was ${\n successRate * 100\n }%) for a production deployment; refusing to deploy`,\n );\n } else {\n console.warn(\n `WARNING: Success rate of ${\n successRate * 100\n }% fails to meet production threshold of ${\n PRODUCTION_SUCCESS_THRESHOLD * 100\n }%; would fail a production deployment!`,\n );\n }\n }\n debug(\"supporter image pull completed\");\n\n // TODO: we'll sunset the classic docs and only have docs.\n // At that point we'll have supporters.js only used for writing files.\n if (process.argv.includes(\"--write-supporters-json\")) {\n await mkdir(\"src/content/data\", { recursive: true });\n await writeFile(\n \"src/content/data/supporters.json\",\n JSON.stringify(supporters, null, 4),\n );\n }\n return supporters;\n};\n\nmodule.exports = getSupporters;\n\nif (require.main === module) {\n require(\"debug\").enable(\"mocha:docs:data:supporters\");\n process.on(\"unhandledRejection\", (err) => {\n throw err;\n });\n getSupporters();\n}\n" }, { "path": "docs/_redirects", "content": "/api/* https://legacy.mochajs.org/api/:splat 301\n/next/* https://mochajs.org/:splat 301\n" }, { "path": "docs/astro.config.ts", "content": "import { defineConfig } from \"astro/config\";\nimport starlight from \"@astrojs/starlight\";\n\nexport default defineConfig({\n integrations: [\n starlight({\n components: {\n Footer: \"./src/components/Footer.astro\",\n Head: \"./src/components/Head.astro\",\n PageTitle: \"./src/components/PageTitle.astro\",\n },\n customCss: [\"./src/style/custom.css\"],\n logo: {\n dark: \"./src/components/icon-dark.svg\",\n light: \"./src/components/icon-light.svg\",\n },\n sidebar: [\n { label: \"Getting Started\", slug: \"getting-started\" },\n {\n items: [\n { label: \"Browsers\", slug: \"running/browsers\" },\n { label: \"CLI\", slug: \"running/cli\" },\n { label: \"Configuring\", slug: \"running/configuring\" },\n { label: \"Editor plugins\", slug: \"running/editor-plugins\" },\n { label: \"Test globs\", slug: \"running/test-globs\" },\n ],\n label: \"Running Mocha\",\n },\n {\n items: [\n { label: \"Dynamic tests\", slug: \"declaring/dynamic-tests\" },\n { label: \"Exclusive tests\", slug: \"declaring/exclusive-tests\" },\n { label: \"Inclusive tests\", slug: \"declaring/inclusive-tests\" },\n { label: \"Pending tests\", slug: \"declaring/pending-tests\" },\n { label: \"Retrying tests\", slug: \"declaring/retrying-tests\" },\n ],\n label: \"Declaring Tests\",\n },\n {\n items: [\n { label: \"Arrow functions\", slug: \"features/arrow-functions\" },\n { label: \"Assertions\", slug: \"features/assertions\" },\n { label: \"Asynchronous code\", slug: \"features/asynchronous-code\" },\n { label: \"Diffs\", slug: \"features/diffs\" },\n { label: \"Error codes\", slug: \"features/error-codes\" },\n { label: \"Global fixtures\", slug: \"features/global-fixtures\" },\n { label: \"Hooks\", slug: \"features/hooks\" },\n { label: \"Parallel mode\", slug: \"features/parallel-mode\" },\n { label: \"Root hook plugins\", slug: \"features/root-hook-plugins\" },\n { label: \"Timeouts\", slug: \"features/timeouts\" },\n ],\n label: \"Features\",\n },\n {\n collapsed: true,\n items: [\n { label: \"About\", slug: \"interfaces/about\" },\n { label: \"BDD (default)\", slug: \"interfaces/bdd\" },\n { label: \"Exports\", slug: \"interfaces/exports\" },\n { label: \"QUnit\", slug: \"interfaces/qunit\" },\n { label: \"Require\", slug: \"interfaces/require\" },\n { label: \"TDD\", slug: \"interfaces/tdd\" },\n { label: \"Third-Party\", slug: \"interfaces/third-party\" },\n ],\n label: \"Interfaces\",\n },\n {\n collapsed: true,\n items: [\n { label: \"About\", slug: \"reporters/about\" },\n { label: \"Doc\", slug: \"reporters/doc\" },\n { label: \"Dot\", slug: \"reporters/dot\" },\n { label: \"HTML\", slug: \"reporters/html\" },\n { label: \"JSON Stream\", slug: \"reporters/json-stream\" },\n { label: \"JSON\", slug: \"reporters/json\" },\n { label: \"Landing\", slug: \"reporters/landing\" },\n { label: \"List\", slug: \"reporters/list\" },\n { label: \"Markdown\", slug: \"reporters/markdown\" },\n { label: \"Min\", slug: \"reporters/min\" },\n { label: \"Nyan\", slug: \"reporters/nyan\" },\n { label: \"Progress\", slug: \"reporters/progress\" },\n { label: \"Spec (default)\", slug: \"reporters/spec\" },\n { label: \"Tap\", slug: \"reporters/tap\" },\n { label: \"Third-Party\", slug: \"reporters/third-party\" },\n { label: \"XUnit\", slug: \"reporters/xunit\" },\n ],\n label: \"Reporters\",\n },\n {\n collapsed: true,\n items: [\n {\n label: \"Compilers deprecation\",\n slug: \"explainers/compilers-deprecation\",\n },\n {\n label: \"Counting assertions\",\n slug: \"explainers/count-assertions\",\n },\n {\n label: \"Detecting multiple calls to done()\",\n slug: \"explainers/detecting-multiple-calls-to-done\",\n },\n {\n label: \"Environment variables\",\n slug: \"explainers/environment-variables\",\n },\n {\n label: \"Find global leaks\",\n slug: \"explainers/find-global-leaks\",\n },\n {\n label: \"Global variables\",\n slug: \"explainers/global-variables\",\n },\n {\n label: \"Node.js native ESM support\",\n slug: \"explainers/nodejs-native-esm-support\",\n },\n {\n label: \"Programmatic usage\",\n slug: \"explainers/programmatic-usage\",\n },\n {\n label: \"Related tools\",\n slug: \"explainers/related-tools\",\n },\n {\n label: \"Run cycle overview\",\n slug: \"explainers/run-cycle-overview\",\n },\n {\n label: \"Security vulnerability reports\",\n slug: \"explainers/security-vulnerability-reports\",\n },\n {\n label: \"Shared behaviours\",\n slug: \"explainers/shared-behaviours\",\n },\n {\n label: \"Spies\",\n slug: \"explainers/spies\",\n },\n {\n label: \"Stub stdout\",\n slug: \"explainers/stub-stdout\",\n },\n {\n label: \"Tagging with --grep\",\n slug: \"explainers/tagging\",\n },\n { label: \"Test duration\", slug: \"explainers/test-duration\" },\n {\n label: \"Test fixture decision tree\",\n slug: \"explainers/test-fixture-decision-tree\",\n },\n {\n label: \"Third party reporters\",\n slug: \"explainers/third-party-reporters\",\n },\n {\n label: \"Third party UIs\",\n slug: \"explainers/third-party-uis\",\n },\n ],\n label: \"Explainers\",\n },\n {\n label: \"API\",\n link: \"https://mochajs.org/api\",\n },\n ],\n social: [\n {\n icon: \"discord\",\n label: \"Discord\",\n href: \"https://discord.gg/KeDn2uXhER\",\n },\n {\n icon: \"github\",\n label: \"GitHub\",\n href: \"https://github.com/mochajs/mocha\",\n },\n ],\n title: \"Mocha\",\n }),\n ],\n});\n" }, { "path": "docs/netlify.toml", "content": "[build]\n command = \"npm run docs\"\n publish = \"docs/dist/\"\n\n[build.environment]\n DEBUG = \"mocha:docs*\"\n NODE_VERSION = \"24\"\n\n[context.deploy-preview]\n command = \"npm run docs\"\n publish = \"docs/dist/\"\n" }, { "path": "docs/package.json", "content": "{\n \"name\": \"docs\",\n \"type\": \"module\",\n \"version\": \"0.0.1\",\n \"scripts\": {\n \"astro\": \"astro\",\n \"build\": \"astro check && astro build\",\n \"dev\": \"astro dev\",\n \"docs\": \"cd .. && npm i && cd docs && npm i && npm run generate && npm run build && cp _redirects dist/_redirects\",\n \"generate\": \"node _data/supporters.cjs --write-supporters-json\",\n \"prelint:knip\": \"npm install\",\n \"lint:knip\": \"knip --cache\",\n \"preview\": \"astro preview\",\n \"start\": \"astro dev\"\n },\n \"dependencies\": {\n \"@astrojs/check\": \"^0.9.6\",\n \"@astrojs/starlight\": \"^0.37.1\",\n \"astro\": \"^5.16.6\",\n \"starlight-package-managers\": \"^0.12.0\",\n \"typescript\": \"^5.9.3\"\n },\n \"devDependencies\": {\n \"debug\": \"^4.4.3\",\n \"knip\": \"^5.83.1\"\n }\n}\n" }, { "path": "docs/public/example/Array.js", "content": "\"use strict\";\n\ndescribe(\"Array\", function () {\n describe(\".push()\", function () {\n it(\"should append a value\", function () {\n var arr = [];\n arr.push(\"foo\");\n arr.push(\"bar\");\n expect(arr[0]).to.equal(\"foo\");\n expect(arr[1]).to.equal(\"bar\");\n });\n\n it(\"should return the length\", function () {\n var arr = [];\n var n = arr.push(\"foo\");\n expect(n).to.equal(1);\n n = arr.push(\"bar\");\n expect(n).to.equal(2);\n });\n\n describe(\"with many arguments\", function () {\n it(\"should add the values\", function () {\n var arr = [];\n arr.push(\"foo\", \"bar\");\n expect(arr[0]).to.equal(\"foo\");\n expect(arr[1]).to.equal(\"bar\");\n });\n });\n });\n\n describe(\".unshift()\", function () {\n it(\"should prepend a value\", function () {\n var arr = [1, 2, 3];\n arr.unshift(\"foo\");\n expect(arr[0]).to.equal(\"foo\");\n expect(arr[1]).to.equal(1);\n });\n\n it(\"should return the length\", function () {\n var arr = [];\n var n = arr.unshift(\"foo\");\n expect(n).to.equal(1);\n n = arr.unshift(\"bar\");\n expect(n).to.equal(2);\n });\n\n describe(\"with many arguments\", function () {\n it(\"should add the values\", function () {\n var arr = [];\n arr.unshift(\"foo\", \"bar\");\n expect(arr[0]).to.equal(\"foo\");\n expect(arr[1]).to.equal(\"bar\");\n });\n });\n });\n\n describe(\".pop()\", function () {\n it(\"should remove and return the last value\", function () {\n var arr = [1, 2, 3];\n expect(arr.pop()).to.equal(3);\n expect(arr.pop()).to.equal(2);\n expect(arr).to.have.length(1);\n });\n });\n\n describe(\".shift()\", function () {\n it(\"should remove and return the first value\", function () {\n var arr = [1, 2, 3];\n expect(arr.shift()).to.equal(1);\n expect(arr.shift()).to.equal(2);\n expect(arr).to.have.length(1);\n });\n });\n});\n" }, { "path": "docs/public/example/tests.html", "content": "\n\n \n \n Mocha\n \n \n \n \n
\n \n \n \n \n \n \n \n\n" }, { "path": "docs/src/components/Badges.astro", "content": "---\nimport { Image } from \"astro:assets\";\nimport Discord from \"./discord.svg\";\n\nconst badges = [\n {\n href: \"http://npmjs.com/package/mocha\",\n alt: \"npm version\",\n src: \"https://img.shields.io/npm/v/mocha\",\n },\n {\n href: \"https://discord.gg/KeDn2uXhER\",\n alt: \"Chat - Discord\",\n src: Discord,\n },\n {\n href: \"#sponsors\",\n alt: \"OpenCollective sponsors\",\n src: \"https://opencollective.com/mochajs/tiers/sponsors/badge.svg\",\n },\n {\n href: \"#backers\",\n alt: \"OpenCollective backers\",\n src: \"https://opencollective.com/mochajs/tiers/backers/badge.svg\",\n },\n];\n---\n\n
\n {\n badges.map((badge) => (\n \n {typeof badge.src === \"string\" ? (\n {badge.alt}\n ) : (\n {badge.alt}\n )}\n \n ))\n }\n
\n\n\n" }, { "path": "docs/src/components/ClientRedirects.astro", "content": "\n" }, { "path": "docs/src/components/FixtureWizard.astro", "content": "
\n \n Mocha Fixture Wizard\n \n \n \n \n My tests \n need setup! \n \n \n \n Setup MUST run \n once and only once \n \n \n \n \n \n Setup MUST share \n state with tests \n \n \n \n \n \n YES \n \n \n \n \n \n \n \n Use Root Hooks and \n Avoid Parallel Mode \n \n \n \n \n \n \n \n \n \n \n \n Use Global Fixtures \n \n \n \n \n \n Should setup affect \n tests across ALL files? \n \n \n \n \n \n \n \n Use Root Hooks \n \n \n \n \n \n \n \n Use Plain Hooks \n \n \n \n \n \n \n \n YES \n \n \n \n \n \n NO \n \n \n \n \n \n NO \n \n \n \n \n \n \n \n \n YES \n \n \n \n \n \n NO \n \n \n \n \n \n
\n" }, { "path": "docs/src/components/Footer.astro", "content": "---\nimport { Image } from \"astro:assets\";\n\nimport openJsfLogo from \"./openjsf-logo.svg\";\n---\n\n\n\n\n" }, { "path": "docs/src/components/Head.astro", "content": "---\nimport type { Props } from '@astrojs/starlight/props'\nimport Default from '@astrojs/starlight/components/Head.astro'\n\nimport thumbnail from \"./mocha-thumbnail.svg\";\n---\n\n\n\n\n\n" }, { "path": "docs/src/components/HomepagePageTitle.astro", "content": "---\nimport { Image } from \"astro:assets\";\n\nimport logo from \"./mocha-logo.svg\";\n---\n\n

\n \"Mocha\"\n classic, reliable, trusted\n

\n\n\n" }, { "path": "docs/src/components/PageTitle.astro", "content": "---\nimport Default from \"@astrojs/starlight/components/PageTitle.astro\";\nimport type { ComponentProps } from \"astro/types\";\n\nimport HomepagePageTitle from \"./HomepagePageTitle.astro\";\n\ntype Props = ComponentProps;\n\nconst isHomepage = Astro.props.slug === \"\";\n---\n\n{isHomepage ? : }\n" }, { "path": "docs/src/components/Supporters.astro", "content": "---\ninterface Supporter {\n imgUrlMed: string;\n imgUrlSmall: string;\n name: string;\n website: string;\n}\n\ninterface Props {\n data: Supporter[];\n size: \"small\" | \"medium\";\n}\n\nconst { size, data } = Astro.props;\n---\n\n
\n {\n data.map((supporter) => (\n \n \n \n ))\n }\n
\n\n\n" }, { "path": "docs/src/content/config.ts", "content": "import { defineCollection } from \"astro:content\";\nimport { docsSchema } from \"@astrojs/starlight/schema\";\n\nexport const collections = {\n docs: defineCollection({ schema: docsSchema() }),\n};\n" }, { "path": "docs/src/content/data/sponsors.json", "content": "[\n {\n \"href\": \"https://localizejs.com\",\n \"image\": \"https://images.opencollective.com/localize/bb2cd4d/logo/256.png\",\n \"title\": \"Localize\"\n },\n {\n \"href\": \"https://route4me.com\",\n \"image\": \"https://images.opencollective.com/route4me/71fb6fa/avatar/256.png\",\n \"title\": \"Route4Me Route Planner\"\n }\n]\n" }, { "path": "docs/src/content/docs/declaring/dynamic-tests.mdx", "content": "---\ndescription: Describing tests cases based on dynamic data.\ntitle: Dynamic Tests\n---\n\nGiven Mocha's use of function expressions to define suites and test cases, it's straightforward to generate your tests dynamically.\nNo special syntax is required--plain old JavaScript can be used to achieve functionality similar to \"parameterized\" tests, which you may have seen in other frameworks.\n\nTake the following example:\n\n```js\nconst assert = require(\"assert\");\n\nfunction add(args) {\n return args.reduce((prev, curr) => prev + curr, 0);\n}\n\ndescribe(\"add()\", function () {\n const tests = [\n { args: [1, 2], expected: 3 },\n { args: [1, 2, 3], expected: 6 },\n { args: [1, 2, 3, 4], expected: 10 },\n ];\n\n tests.forEach(({ args, expected }) => {\n it(`correctly adds ${args.length} args`, function () {\n const res = add(args);\n assert.strictEqual(res, expected);\n });\n });\n});\n```\n\nThe above code will produce a suite with three specs:\n\n```bash\n$ mocha\n\n add()\n ✓ correctly adds 2 args\n ✓ correctly adds 3 args\n ✓ correctly adds 4 args\n```\n\nTests added inside a `.forEach` handler often don't play well with editor plugins, especially with \"right-click run\" features.\nAnother way to parameterize tests is to generate them with a closure.\nThis following example is equivalent to the one above:\n\n```js\ndescribe(\"add()\", function () {\n const testAdd = ({ args, expected }) =>\n function () {\n const res = add(args);\n assert.strictEqual(res, expected);\n };\n\n it(\"correctly adds 2 args\", testAdd({ args: [1, 2], expected: 3 }));\n it(\"correctly adds 3 args\", testAdd({ args: [1, 2, 3], expected: 6 }));\n it(\"correctly adds 4 args\", testAdd({ args: [1, 2, 3, 4], expected: 10 }));\n});\n```\n\nWith `top-level await` you can collect your test data in a dynamic and asynchronous way while the test file is being loaded.\n\nSee also [`--delay`](/features/hooks#delayed-root-suite) for CommonJS modules without `top-level await`.\n\n```js\n// testfile.mjs\nimport assert from \"assert\";\n\n// top-level await: Node >= v14.8.0 with ESM test file\nconst tests = await new Promise((resolve) => {\n setTimeout(resolve, 5000, [\n { args: [1, 2], expected: 3 },\n { args: [1, 2, 3], expected: 6 },\n { args: [1, 2, 3, 4], expected: 10 },\n ]);\n});\n\n// in suites, async callbacks are **not** supported\ndescribe(\"add()\", function () {\n tests.forEach(({ args, expected }) => {\n it(`correctly adds ${args.length} args`, function () {\n const res = args.reduce((sum, curr) => sum + curr, 0);\n assert.strictEqual(res, expected);\n });\n });\n});\n```\n" }, { "path": "docs/src/content/docs/declaring/exclusive-tests.mdx", "content": "---\ndescription: Describing test cases that should be run to the exclusion of other tests.\ntitle: Exclusive Tests\n---\n\n:::caution\nExclusive tests are incompatible with [parallel mode](/features/parallel-mode).\n:::\n\nThe exclusivity feature allows you to run _only_ the specified suite or test-case\nby appending `.only()` to the function.\nHere's an example of executing only a particular suite:\n\n```js\ndescribe(\"Array\", function () {\n describe.only(\"#indexOf()\", function () {\n // ...\n });\n});\n```\n\n_Note_: All nested suites will still be executed.\n\nHere's an example of executing an individual test case:\n\n```js\ndescribe(\"Array\", function () {\n describe(\"#indexOf()\", function () {\n it.only(\"should return -1 unless present\", function () {\n // ...\n });\n\n it(\"should return the index when present\", function () {\n // ...\n });\n });\n});\n```\n\nPrevious to v3.0.0, `.only()` used string matching to decide which tests to execute; this is no longer the case.\nIn v3.0.0 or newer, `.only()` can be used multiple times to define a subset of tests to run:\n\n```js\ndescribe(\"Array\", function () {\n describe(\"#indexOf()\", function () {\n it.only(\"should return -1 unless present\", function () {\n // this test will be run\n });\n\n it.only(\"should return the index when present\", function () {\n // this test will also be run\n });\n\n it(\"should return -1 if called with a non-Array context\", function () {\n // this test will not be run\n });\n });\n});\n```\n\nYou may also choose multiple suites:\n\n```js\ndescribe(\"Array\", function () {\n describe.only(\"#indexOf()\", function () {\n it(\"should return -1 unless present\", function () {\n // this test will be run\n });\n\n it(\"should return the index when present\", function () {\n // this test will also be run\n });\n });\n\n describe.only(\"#concat()\", function () {\n it(\"should return a new Array\", function () {\n // this test will also be run\n });\n });\n\n describe(\"#slice()\", function () {\n it(\"should return a new Array\", function () {\n // this test will not be run\n });\n });\n});\n```\n\nBut _tests will have precedence_:\n\n```js\ndescribe(\"Array\", function () {\n describe.only(\"#indexOf()\", function () {\n it.only(\"should return -1 unless present\", function () {\n // this test will be run\n });\n\n it(\"should return the index when present\", function () {\n // this test will not be run\n });\n });\n});\n```\n\n:::note\nHooks, if present, will still be executed.\n:::\n\n:::tip\nBe mindful not to commit usages of `.only()` to version control, unless you really mean it!\nTo do so one can run mocha with the option `--forbid-only` in the continuous integration test command (or in a git precommit hook).\n:::\n" }, { "path": "docs/src/content/docs/declaring/inclusive-tests.mdx", "content": "---\ndescription: Describing test cases that should not be run yet.\ntitle: Inclusive Tests\n---\n\nThis feature is the inverse of `.only()`.\nBy appending `.skip()`, you may tell Mocha to ignore test case(s).\nAnything skipped will be marked as [pending](/declaring/pending-tests) and reported as such.\nHere's an example of skipping an individual test:\n\n```js\ndescribe(\"Array\", function () {\n describe(\"#indexOf()\", function () {\n it.skip(\"should return -1 unless present\", function () {\n // this test will not be run\n });\n\n it(\"should return the index when present\", function () {\n // this test will be run\n });\n });\n});\n```\n\nYou can also put `.skip()` on an entire suite.\nThis is equivalent to appending `.skip()` onto all tests in the suite.\nHooks in the suite are also skipped.\n\n```js\ndescribe(\"Array\", function () {\n describe.skip(\"#indexOf()\", function () {\n it(\"should return -1 unless present\", function () {\n // this test will not be run\n });\n });\n});\n```\n\n_Note_: Code in skipped suites that is placed outside of hooks or tests is still executed, as Mocha will still invoke the suite function to build up the suite structure for visualization.\n\n:::tip[Best practice]\nUse `.skip()` instead of commenting tests out.\n:::\n\nYou may also skip _at runtime_ using `this.skip()`.\nIf a test needs an environment or configuration which cannot be detected beforehand, a runtime skip is appropriate.\nFor example:\n\n```js\nit('should only test in the correct environment', function() {\n if (/* check test environment */) {\n // make assertions\n } else {\n this.skip();\n }\n});\n```\n\nThe above test will be reported as [pending](/declaring/pending-tests).\nIt's also important to note that calling `this.skip()` will effectively _abort_ the test.\n\n:::tip[Best practice]\nTo avoid confusion, do not execute further instructions in a test or hook after calling `this.skip()`.\n:::\n\nContrast the above test with the following code:\n\n```js\nit('should only test in the correct environment', function() {\n if (/* check test environment */) {\n // make assertions\n } else {\n // do nothing\n }\n});\n```\n\nBecause this test _does nothing_, it will be reported as _passing_.\n\n:::tip[Best practice]\nDon't do nothing!\nA test should make an assertion or use `this.skip()`.\n:::\n\nTo skip _multiple_ tests in this manner, use `this.skip()` in a \"before all\" hook:\n\n```js\nbefore(function() {\n if (/* check test environment */) {\n // setup code\n } else {\n this.skip();\n }\n});\n```\n\nThis will skip all `it`, `beforeEach/afterEach`, and `describe` blocks within the suite.\n`before/after` hooks are skipped unless they are defined at the same level as the hook containing `this.skip()`.\n\n```js\ndescribe(\"outer\", function () {\n before(function () {\n this.skip();\n });\n\n after(function () {\n // will be executed\n });\n\n describe(\"inner\", function () {\n before(function () {\n // will be skipped\n });\n\n after(function () {\n // will be skipped\n });\n });\n});\n```\n\n:::note[Updated in v7.0.0]\nSkipping a test within an \"after all\" hook is disallowed and will throw an exception.\nUse a return statement or other means to abort hook execution.\n:::\n\nBefore Mocha v3.0.0, `this.skip()` was not supported in asynchronous tests and hooks.\n" }, { "path": "docs/src/content/docs/declaring/pending-tests.mdx", "content": "---\ndescription: Describing test cases with names that don't yet have a callback.\ntitle: Pending Tests\n---\n\n\"Pending\" — as in \"someone should write these test cases eventually\" — test-cases are those _without_ a callback:\n\n```js\ndescribe(\"Array\", function () {\n describe(\"#indexOf()\", function () {\n // pending test below\n it(\"should return -1 when the value is not present\");\n });\n});\n```\n\nPending tests will be included in the test results and marked as pending.\nA pending test is not considered a failed test.\n\nRead the [inclusive tests section](/declaring/inclusive-tests) for an example of conditionally marking a test as pending via `this.skip()`.\n" }, { "path": "docs/src/content/docs/declaring/retrying-tests.mdx", "content": "---\ndescription: Describing test cases that should retry on failure.\ntitle: Retry Tests\n---\n\nYou can choose to retry failed tests up to a certain number of times.\nThis feature is designed to handle end-to-end tests (functional tests/Selenium...) where resources cannot be easily mocked/stubbed.\n**It's not recommended to use this feature for unit tests**.\n\nThis feature does re-run a failed test and its corresponding `beforeEach/afterEach` hooks, but not `before/after` hooks.\n`this.retries()` has no effect on failing hooks.\n\n:::note\nThe example below was written using Selenium webdriver (which [overwrites global Mocha hooks](https://github.com/SeleniumHQ/selenium/blob/c10e8a955883f004452cdde18096d70738397788/javascript/node/selenium-webdriver/testing/index.js) for `Promise` chain).\n:::\n\n```js\ndescribe(\"retries\", function () {\n // Retry all tests in this suite up to 4 times\n this.retries(4);\n\n beforeEach(function () {\n browser.get(\"http://www.yahoo.com\");\n });\n\n it(\"should succeed by the 3rd try\", function () {\n // Specify this test to only retry up to 2 times\n this.retries(2);\n expect($(\".foo\").isDisplayed()).to.eventually.be.true;\n });\n});\n```\n" }, { "path": "docs/src/content/docs/explainers/compilers-deprecation.mdx", "content": "---\ndescription: Compilers deprecation notice.\ntitle: Compilers deprecation\n---\n\nIf you're here, you probably hit the deprecation notice. Sorry about that!\n\n## Will it break?\n\nThis is a _soft_ deprecation, which means you get nagged about it, but it won't break (yet).\n\n## Make it go away\n\nTo suppress this warning, execute `mocha` with the `--no-deprecation` flag (though you won't get notice of any _other_ deprecations you may encounter either).\n\n## ... but why?\n\n`--compilers` is redundant; we've yet to encounter a real-world situation in which the solution couldn't be expressed using `--require`.\n\n## What should I use instead then?\n\nLet's say you want to compile using CoffeeScript. Ensure that you have the coffeescript package installed as a dev dependency:\n\n`npm install coffeescript --save-dev`\n\nThen update your package.json with the relevant require statement: `--require coffeescript/register`.\n\nHere's a list of popular compilers/transpilers:\n\n- CoffeeScript: `--compilers coffee:coffee-script/register` becomes `--require coffeescript/register`\n- Babel 6: `--compilers js:babel-core/register` becomes `--require babel-core/register`\n- Babel 7: `--require babel-core/register` used if you are using Babel v6 becomes `--require @babel/register` with Babel v7.\n- TypeScript: `--compilers ts:ts-node/register` becomes `--require ts-node/register`\n- LiveScript: `--compilers ls:livescript` becomes `--require livescript`\n- (feel free to add more examples!)\n\nYou'll have to handle file extensions as well. Mocha, by default, only loads `.js` files when given a directory (and the default directory is `test`). Therefore, to use a _different_ file extension (such as `.coffee` or `.ts`), you will need to supply a _glob_ instead of simply a directory. If this was how you ran Mocha pre-v4:\n\n```bash\n$ mocha --compilers coffee:coffee-script/register --recursive ./test\n```\n\nThen this is how you'd accomplish the same thing (`**` roughly means \"recursive\") in v4:\n\n```bash\n$ mocha --require coffeescript/register \"test/**/*.js\"\n```\n\nWhen you wrap a glob in quotes, file discovery is handed to the [glob](https://npm.im/glob) package.\nIt's _recommended_ to wrap in double-quotes, because the result should be the same regardless of your shell or environment (Windows/Linux/macOS, etc.).\n\n[glob](https://npm.im/glob) is powerful. For instance, if your `test` dir has tests written in _both_ JS _and_ CoffeeScript, you could do this:\n\n```bash\n$ mocha --require coffeescript/register \"test/**/*.{js,coffee}\"\n```\n\n## How do I use this with `--watch`?\n\nWhen using `--watch`, you will also need to specify the extension(s) to watch via `--watch-extensions`, e.g.:\n\n```js\n$ mocha --require coffeescript/register --watch --watch-extensions js,coffee \"test/**/*.{js,coffee}\"\n```\n" }, { "path": "docs/src/content/docs/explainers/count-assertions.mdx", "content": "---\ndescription: How to count assertions.\ntitle: Counting assertions\n---\n\nWhile Mocha itself does not provide an assertion layer and cannot provide assertion counting, it's relatively easy to integrate this behavior using hooks. The following is a simplified version of an assertion counter:\n\n```js\nvar expected = 0;\nvar actual = 0;\n\nfunction assert(expr, msg) {\n if (!expr) throw new Error(msg || \"assertion failed\");\n actual++;\n}\n\nfunction expect(n) {\n expected = n;\n}\n\nfunction reset() {\n expected = 0;\n actual = 0;\n}\n\nfunction check() {\n if (!expected || expected == actual) return;\n var err = new Error(\"expected \" + expected + \" assertions, got \" + actual);\n this.currentTest.emit(\"error\", err);\n}\n\nbeforeEach(reset);\nafterEach(check);\n\ndescribe(\"something\", function () {\n it(\"should work\", function (done) {\n expect(2);\n\n setTimeout(function () {\n assert(\"wahoo\");\n }, 50);\n\n setTimeout(function () {\n assert(\"hey\");\n }, 50);\n\n setTimeout(function () {\n done();\n }, 100);\n });\n});\n```\n" }, { "path": "docs/src/content/docs/explainers/detecting-multiple-calls-to-done.mdx", "content": "---\ndescription: Why Mocha determines if the done() callback in a test was called multiple times.\ntitle: Detecting Multiple Calls to done()\n---\n\nIf you use callback-based async tests, Mocha will throw an error if `done()` is called multiple times.\nThis is handy for catching accidental double callbacks.\n\n```javascript\nit(\"double done\", function (done) {\n // Calling `done()` twice is an error\n setImmediate(done);\n setImmediate(done);\n});\n```\n\nRunning the above test will give you the below error message:\n\n```bash\n$ ./node_modules/.bin/mocha mocha.test.js\n\n\n ✓ double done\n 1) double done\n\n 1 passing (6ms)\n 1 failing\n\n 1) double done:\n Error: done() called multiple times\n at Object. (mocha.test.js:1:63)\n at require (internal/module.js:11:18)\n at Array.forEach ()\n at startup (bootstrap_node.js:187:16)\n at bootstrap_node.js:608:3\n```\n" }, { "path": "docs/src/content/docs/explainers/environment-variables.mdx", "content": "---\ndescription: Learn how to use environment variables in Mocha tests\ntitle: \"Environment variables\"\n---\n\nSometimes you might want your test to make use of variables set on an environment level. Common reasons for this include:\n\n- Flagging a run as CI\n- Setting the domain of an application\n- Pointing to a test database\n- Setting a key which you want to remain secure\n\nThe best way to do this is to use NodeJS's native environment variables.\n\n## Example\n\nIn your `package.json` or directly in a terminal set your variable name and value.\n\n```bash\nenv CI=STAGE mocha\n```\n\nThen in your test or code reference it via `process.env.CI`. e.g.\n\n```javascript\nif (process.env.CI === \"STAGE\") // do something\n```\n\nThe value is available from anywhere in a spec file allowing you to set values from it before the tests run. e.g.\n\n```javascript\nimport { equal } from \"assert\";\nimport { loadPage } from \"your-code\";\nconst URL = `${process.env.APP_HOST}/${process.env.APP_URI}`;\ndescribe('Test the page loads', () {\n it('goes to URL', () => {\n const page = loadPage(URL);\n equal(page.url, URL);\n });\n});\n```\n" }, { "path": "docs/src/content/docs/explainers/find-global-leaks.mdx", "content": "---\ndescription: How to find a global leak.\ntitle: Find global leaks\n---\n\nDetecting which module is causing a global leak can be tedious. Add these lines at the very beginning of your tests, or in a file which is included via `--require`:\n\n```javascript\nObject.defineProperty(global, \"name_of_leaking_property\", {\n set: function (value) {\n throw new Error(\"Found the leak!\");\n },\n});\n```\n\nThis will print a stacktrace that shows which module caused the leak. And if it's not yours--go open a pull request! :)\n" }, { "path": "docs/src/content/docs/explainers/global-variables.mdx", "content": "---\ndescription: How to work with global variables in Mocha tests\ntitle: \"Global variables\"\n---\n\nRelated issue [#1582](https://github.com/mochajs/mocha/issues/1582)\n\nIf your test manipulates global variables, a reasonable expectation is that you will clean up after yourself. This includes commonly called methods such as `process.stdout.write()` or `console.log()`.\n\n```js\nvar expect = require(\"chai\").expect;\n\ndescribe(\"my nice test\", function () {\n var write,\n log,\n output = \"\";\n\n // restore process.stdout.write() and console.log() to their previous glory\n var cleanup = function () {\n process.stdout.write = write;\n console.log = log;\n output = \"\";\n };\n\n beforeEach(function () {\n // store these functions to restore later because we are messing with them\n write = process.stdout.write;\n log = console.log;\n\n // our stub will concatenate any output to a string\n process.stdout.write = console.log = function (s) {\n output += s;\n };\n });\n\n // restore after each test\n afterEach(cleanup);\n\n it(\"should suppress all output if a non-AssertionError was thrown\", function () {\n process.stdout.write(\"foo\");\n console.log(\"bar\");\n // uncomment below line to suppress output, which is bad\n // expect(output).to.equal(foobar);\n expect(output).to.equal(\"foobar\");\n });\n\n it(\"should not suppress any output\", function () {\n try {\n process.stdout.write(\"foo\");\n console.log(\"bar\");\n // uncomment below line to just throw an AssertionError\n // expect(output).to.equal('barfoo');\n expect(output).to.equal(foobar); // ReferenceError\n } catch (e) {\n cleanup();\n throw e;\n }\n });\n});\n```\n" }, { "path": "docs/src/content/docs/explainers/nodejs-native-esm-support.mdx", "content": "---\ndescription: A mid-level outline of Mocha's \"flow of execution\".\ntitle: Node.js Native ESM Support\n---\n\n:::note[New in v7.1.0]\n:::\n\nMocha supports writing your tests as ES modules, and not just using CommonJS.\nFor example:\n\n```js\n// test.mjs\nimport { add } from \"./add.mjs\";\nimport assert from \"assert\";\n\nit(\"should add to numbers from an es module\", () => {\n assert.equal(add(3, 5), 8);\n});\n```\n\nTo enable this you don't need to do anything special.\nWrite your test file as an ES module.\nIn Node.js this means either ending the file with a `.mjs` extension, or, if you want to use the regular `.js` extension, by adding `\"type\": \"module\"` to your `package.json`.\nMore information can be found in the [Node.js documentation](https://nodejs.org/api/esm.html).\n\n### Current Limitations\n\n- [Watch mode](/running/cli#--watch--w) does not support ES Module test files\n- [Custom reporters](/reporters/third-party) and [custom interfaces](/interfaces/third-party) can only be CommonJS files\n- [Configuration file](/running/configuring) can only be a CommonJS file (`.mocharc.js` or `.mocharc.cjs`)\n- Mocha in Node.js version 24.4.0 or older [silently ignored top level errors in ESM files](https://github.com/mochajs/mocha/issues/5396).\n If you cannot upgrade to a newer Node.js version, you can add `--no-experimental-require-module` to the `NODE_OPTIONS` environment variable.\n- When using module-level mocks via libs like `proxyquire`, `rewiremock` or `rewire`, hold off on using ES modules for your test files.\n You can switch to using `testdouble`, which does support ESM.\n" }, { "path": "docs/src/content/docs/explainers/programmatic-usage.mdx", "content": "---\ndescription: Using Mocha programmatically\ntitle: Programmatic usage\n---\n\nThere are a lot of reasons why you might want to automate running the tests using Mocha. Using the command-line can run into some problems if you want to load specific files, for example.\n\nHere is an example of using Mocha programmatically:\n\n```javascript\nvar Mocha = require(\"mocha\"),\n fs = require(\"fs\"),\n path = require(\"path\");\n\n// Instantiate a Mocha instance.\nvar mocha = new Mocha();\n\nvar testDir = \"some/dir/test\";\n\n// Add each .js file to the mocha instance\nfs.readdirSync(testDir)\n .filter(function (file) {\n // Only keep the .js files\n return file.substr(-3) === \".js\";\n })\n .forEach(function (file) {\n mocha.addFile(path.join(testDir, file));\n });\n\n// Run the tests.\nmocha.run(function (failures) {\n process.exitCode = failures ? 1 : 0; // exit with non-zero status if there were failures\n});\n```\n\n`mocha.run()` returns a `Runner` instance which emits many [events](https://github.com/mochajs/mocha/blob/9a7053349589344236b20301de965030eaabfea9/lib/runner.js#L52) of interest.\n\nNote that `run` (via `loadFiles`, which it calls) relies on Node's `require` to execute the test interface functions. Thus, files loaded by Mocha will be stored in Node's `require` cache and therefore tests in these files will not be re-run if `mocha.run()` is called again. If you want to run tests multiple times, you may need to clear Node's `require` cache before subsequent calls in whichever manner best suits your needs. The upcoming Mocha-6.0 release will provide `Mocha#unloadFiles`, which will remove all files loaded by `Mocha#loadFiles`.\n\nUnfortunately, event listeners in multiple places are not yet configured for restartability; for now, we recommend recreating the `mocha` instance before rerunning to _ensure_ everything gets reset properly.\n\nFind a fully [working example here](https://github.com/mochajs/mocha-examples/tree/main/packages/programmatic-usage).\n\n## Set options\n\nThere are two ways to set the options to run the tests.\n\nFirstly, you can set these options in the constructor object:\n\n```javascript\nvar mocha = new Mocha({\n ui: \"tdd\",\n reporter: \"list\",\n});\n```\n\nPlease check our [API documentation](https://mochajs.org/api/mocha) for a complete list of these options.\n\nSecondly, on the `mocha` object, there are some chainable methods allowing you to change some more options.\n\nHere is an example:\n\n```javascript\n// Change the reporter to \"list\" before running the tests\nmocha.reporter(\"list\").run();\n\n// Change the UI to \"tdd\" before running the tests\nmocha.ui(\"tdd\").run();\n\n// Or do both changes before running the tests\nmocha.reporter(\"list\").ui(\"tdd\").run();\n```\n\nPlease check our [API documentation](https://mochajs.org/api/mocha) for more information.\n" }, { "path": "docs/src/content/docs/explainers/related-tools.mdx", "content": "---\ndescription: External tools and libraries that work well with Mocha\ntitle: Related tools\n---\n\n# Related Tools\n\n## Assertion Libraries\n\n- [chai](http://chaijs.com/) (recommended): expect(), assert(), and should style assertions\n- [earl](https://earl.fun/): ergonomic, modern and type-safe assertion library for TypeScript\n- [unexpected](https://unexpectedjs.github.io/): extensible BDD assertion toolkit\n\n## Mocks, Stubs & Spies\n\n- [sinon.js](https://sinonjs.org/): Test spies, stubs and mocks for JavaScript.\n- [nock](https://github.com/nock/nock): HTTP mocking and expectations library.\n" }, { "path": "docs/src/content/docs/explainers/run-cycle-overview.mdx", "content": "---\ndescription: A mid-level outline of Mocha's \"flow of execution\".\ntitle: Run Cycle Overview\n---\n\nThe following is a mid-level outline of Mocha’s \"flow of execution\" when run in Node.js; the \"less important\" details have been omitted.\n\nIn a browser, test files are loaded by `\n \n\n \n \n \n \n \n \n\n```\n\nMocha supports the latest major versions of evergreen browsers available when Mocha's oldest supported Node.js major version was released.\nAs of Mocha v12.0.0, that includes the following browser versions that were stable as of [Node.js 20.0.0](https://nodejs.org/en/blog/release/v20.0.0)'s release on April 18, 2023:\n\n- [Chrome 112](https://developer.chrome.com/blog/new-in-chrome-112)\n- [Edge 112](https://learn.microsoft.com/en-us/deployedge/microsoft-edge-relnote-archive-stable-channel#version-1120172248-april-14-2023)\n- [Firefox 112](https://www.mozilla.org/en-US/firefox/112.0/releasenotes)\n- [Safari 16.4](https://developer.apple.com/documentation/safari-release-notes/safari-16_4-release-notes)\n\n## Grep\n\nThe browser may use the `--grep` as functionality.\nAppend a query-string to your URL: `?grep=api`.\n\n## Browser Configuration\n\nMocha options can be set via `mocha.setup()`.\nExamples:\n\n```js\n// Use \"tdd\" interface. This is a shortcut to setting the interface;\n// any other options must be passed via an object.\nmocha.setup('tdd');\n\n// This is equivalent to the above.\nmocha.setup({\n ui: 'tdd'\n});\n\n// Examples of options:\nmocha.setup({\n allowUncaught: true,\n asyncOnly: true,\n bail: true,\n checkLeaks: true,\n dryRun: true,\n failZero: true,\n forbidOnly: true,\n forbidPending: true,\n global: ['MyLib'],\n retries: 3,\n rootHooks: { beforeEach(done) { ... done();} },\n slow: '100',\n timeout: '2000',\n ui: 'bdd'\n});\n```\n\n## Browser-Specific Options\n\nBrowser Mocha supports many, but not all [CLI options](/running/configuring).\nTo use a CLI option that contains a \"-\", please convert the option to camelCase, (eg. `check-leaks` to `checkLeaks`).\n\n### Options That Differ Slightly From [CLI Options](/running/configuring)\n\n> `reporter` _`string|constructor`_\n\nYou can pass a reporter's name or a custom reporter's constructor.\nYou can find **recommended** reporters for the browser [here](#reporting).\n\nIt is possible to use [built-in reporters](/reporters/spec) as well.\nTheir employment in browsers is neither recommended nor supported, open the console to see the test results.\n\n### Options That _Only_ Function In Browser Context\n\n> `noHighlighting` _`boolean`_\n\nIf set to `true`, do not attempt to use syntax highlighting on output test code.\n\n## Reporting\n\nThe HTML reporter is the default reporter when running Mocha in the browser.\nIt looks like this:\n\n![HTML test reporter](./reporter-html.png)\n\n[Mochawesome](https://npm.im/mochawesome) is a great alternative to the default HTML reporter.\n" }, { "path": "docs/src/content/docs/running/cli.mdx", "content": "---\ntitle: Command-Line Usage\ndescription: Running Mocha in your terminal.\n---\n\nRunning `npx mocha --help` will show the full list of available commands:\n\n{/* This output is defined in lib/cli/run.js */}\n\n```plaintext\nmocha [spec..]\n\nRun tests with Mocha\n\nCommands\n mocha inspect [spec..] Run tests with Mocha [default]\n mocha init create a client-side Mocha setup at \n\nRules & Behavior\n --allow-uncaught Allow uncaught errors to propagate [boolean]\n -A, --async-only Require all tests to use a callback (async)\n or return a Promise [boolean]\n -b, --bail Abort (\"bail\") after first test failure\n [boolean]\n --check-leaks Check for global variable leaks [boolean]\n --delay Delay initial execution of root suite\n [boolean]\n --dry-run Report tests without executing them[boolean]\n --exit Force Mocha to quit after tests complete\n [boolean]\n --pass-on-failing-test-suite Not fail test run if tests were failed\n [boolean] [default: false]\n --fail-zero Fail test run if no test(s) encountered\n [boolean]\n --forbid-only Fail if exclusive test(s) encountered\n [boolean]\n --forbid-pending Fail if pending test(s) encountered[boolean]\n --global, --globals List of allowed global variables [array]\n -j, --jobs Number of concurrent jobs for --parallel;\n use 1 to run in serial\n [number] [default: (number of CPU cores - 1)]\n -p, --parallel Run tests in parallel [boolean]\n --retries Retry failed tests this many times [number]\n -s, --slow Specify \"slow\" test threshold (in\n milliseconds) [string] [default: 75]\n -t, --timeout, --timeouts Specify test timeout threshold (in\n milliseconds) [string] [default: 2000]\n -u, --ui Specify user interface\n [string] [default: \"bdd\"]\n\nReporting & Output\n -c, --color, --colors Force-enable color output [boolean]\n --diff Show diff on failure\n [boolean] [default: true]\n --full-trace Display full stack traces [boolean]\n --inline-diffs Display actual/expected differences\n inline within each string [boolean]\n -R, --reporter Specify reporter to use\n [string] [default: \"spec\"]\n -O, --reporter-option, Reporter-specific options\n --reporter-options () [array]\n\nConfiguration\n --config Path to config file [string] [default: (nearest rc file)]\n -n, --node-option Node or V8 option (no leading \"--\") [array]\n --package Path to package.json for config [string]\n\nFile Handling\n --extension File extension(s) to load\n [array] [default: [\"js\",\"cjs\",\"mjs\"]]\n --file Specify file(s) to be loaded prior to root suite\n execution [array] [default: (none)]\n --ignore, --exclude Ignore file(s) or glob pattern(s)\n [array] [default: (none)]\n --recursive Look for tests in subdirectories [boolean]\n -r, --require Require module [array] [default: (none)]\n -S, --sort Sort test files [boolean]\n -w, --watch Watch files in the current working directory for\n changes [boolean]\n --watch-files List of paths or globs to watch [array]\n --watch-ignore List of paths or globs to exclude from watching\n [array] [default: [\"node_modules\",\".git\"]]\n\nTest Filters\n -f, --fgrep Only run tests containing this string [string]\n -g, --grep Only run tests matching this string or regexp [string]\n -i, --invert Inverts --grep and --fgrep matches [boolean]\n\nPositional Arguments\n spec One or more files, directories, or globs to test\n [array] [default: [\"test\"]]\n\nOther Options\n -h, --help Show usage information & exit [boolean]\n -V, --version Show version number & exit [boolean]\n --list-interfaces List built-in user interfaces & exit [boolean]\n --list-reporters List built-in reporters & exit [boolean]\n\nMocha Resources\n Chat: https://discord.gg/KeDn2uXhER\n GitHub: https://github.com/mochajs/mocha.git\n Docs: https://mochajs.org/\n```\n\n## Rules & Behavior\n\n### `--allow-uncaught`\n\nBy default, Mocha will attempt to trap uncaught exceptions thrown from running tests and report these as test failures.\nUse `--allow-uncaught` to disable this behavior and allow uncaught exceptions to propagate.\nWill typically cause the process to crash.\n\nThis flag is useful when debugging particularly difficult-to-track exceptions.\n\n### `--async-only, -A`\n\nEnforce a rule that tests must be written in \"async\" style, meaning each test provides a `done` callback or returns a `Promise`.\nNon-compliant tests will be marked as failures.\n\n### `--bail, -b`\n\nCauses Mocha to stop running tests after the first test failure it encounters.\nCorresponding \"after each\" and \"after all\" hooks are executed for potential cleanup.\n\n`--bail` does _not_ imply `--exit`.\n\n### `--check-leaks`\n\nUse this option to have Mocha check for global variables that are leaked while running tests.\nSpecify globals that are acceptable via the `--global` option (for example: `--check-leaks --global jQuery --global MyLib`).\n\n### `--compilers`\n\n:::note\n`--compilers` was removed in v6.0.0.\nSee [further explanation and workarounds](https://github.com/mochajs/mocha/wiki/compilers-deprecation).\n:::\n\n### `--delay`\n\nDelay initial execution of root suite.\n\nSee [Delayed Root Suite](/features/hooks#delayed-root-suite).\n\n### `--dry-run`\n\n:::note[New in v9.0.0]\n:::\n\nReport tests without executing any of them, neither tests nor hooks.\n\n### `--exit`\n\n:::note[Updated in v4.0.0]\nTL;DR: If your tests hang after an upgrade to Mocha v4.0.0 or newer, use `--exit` for a quick (though not necessarily recommended) fix.\n:::\n\n_Prior to_ version v4.0.0, _by default_, Mocha would force its own process to exit once it was finished executing all tests.\nThis behavior enables a set of potential problems: it's indicative of tests (or fixtures, harnesses, code under test, etc.) which don't clean up after themselves properly.\nUltimately, \"dirty\" tests can (but not always) lead to _false positive_ or _false negative_ results.\n\n\"Hanging\" most often manifests itself if a server is still listening on a port, or a socket is still open, etc.\nIt can also be something like a runaway `setInterval()`, or even an errant `Promise` that never fulfilled.\n\nThe _default behavior_ in v4.0.0 (and newer) is `--no-exit`, where previously it was `--exit`.\n\n**The easiest way to \"fix\" the issue is to pass `--exit` to the Mocha process.**\nIt _can_ be time-consuming to debug--because it's not always obvious where the problem is--but it _is_ recommended to do so.\n\nTo ensure your tests aren't leaving messes around, here are some ideas to get started:\n\n- See the [Node.js guide to debugging](https://nodejs.org/en/docs/inspector)\n- Use the new [`async_hooks`](https://github.com/nodejs/node/blob/master/doc/api/async_hooks.md) API ([example](https://gist.github.com/boneskull/7fe75b63d613fa940db7ec990a5f5843))\n- Try something like [wtfnode](https://npm.im/wtfnode)\n- Use [`.only`](/declaring/exclusive-tests) until you find the test that causes Mocha to hang\n\n### `--pass-on-failing-test-suite`\n\n:::note[New in v10.7.0]\n:::\n\nIf set to `true`, Mocha returns exit code `0` even if there are failed tests during the run.\n\n### `--fail-zero`\n\n:::note[New in v9.1.0]\n:::\n\nFail test run with `exit-code: 1` if no tests are encountered.\n\n### `--forbid-only`\n\nEnforce a rule that tests may not be exclusive (use of e.g., `describe.only()` or `it.only()` is disallowed).\n\n`--forbid-only` causes Mocha to fail when an exclusive (\"only'd\") test or suite is encountered, and it will abort further test execution.\n\n### `--forbid-pending`\n\nEnforce a rule that tests may not be skipped (use of e.g., `describe.skip()`, `it.skip()`, or `this.skip()` anywhere is disallowed).\n\n`--forbid-pending` causes Mocha to fail when a skipped (\"pending\") test or suite is encountered, and it will abort further test execution.\n\n### `--global `\n\n:::note[Updated in v6.0.0]\nThe option is `--global` and `--globals` is now an alias.\n:::\n\nDefine a global variable name.\nFor example, suppose your app deliberately exposes a global named `app` and `YUI`, you may want to add `--global app --global YUI`.\n\n`--global` accepts wildcards.\nYou could do `--global '*bar'` and it would match `foobar`, `barbar`, etc.\nYou can also pass in `'*'` to ignore all globals.\n\n`--global` can accept a comma-delimited list; `--global app,YUI` is equivalent to `--global app --global YUI`.\n\nBy using this option in conjunction with `--check-leaks`, you can specify an allowlist of known global variables that you _expect_ to leak into global scope.\n\n### `--jobs , -j `\n\n:::note[New in v8.0.0]\n:::\n\nUse `--jobs ` to specify the _maximum_ number of processes in the worker pool.\n\nThe default value is the _number of CPU cores_ less 1.\n\n:::tip\nUse `--jobs 0` or `--jobs 1` to temporarily disable `--parallel`.\n:::\n\nHas no effect unless used with [`--parallel`](#--parallel--p).\n\n### `--parallel, -p`\n\n:::note[New in v8.0.0]\n:::\n\nUse the `--parallel` flag to run tests in a worker pool.\n\nEach test file will be put into a queue and executed as workers become available.\n\n:::caution\n`--parallel` has certain implications for Mocha's behavior which you must be aware of.\nRead more about [running tests in parallel](/features/parallel-mode).\n:::\n\n### `--retries `\n\nRetries failed tests `n` times.\n\nMocha does not retry test failures by default.\n\n### `--slow , -s `\n\nSpecify the \"slow\" test threshold in milliseconds.\nMocha uses this to highlight test cases that are taking too long.\n\"Slow\" tests are not considered failures.\n\n:::note\nA test that executes for _half_ of the \"slow\" time will be highlighted _in yellow_ with the default `spec` reporter; a test that executes for entire \"slow\" time will be highlighted _in red_.\n:::\n\n### `--timeout , -t `\n\n:::note[Updated in v6.0.0]\n`--timeout 0` is implied when invoking Mocha using inspect flags.\n`--timeout 99999999` is no longer needed.\n:::\n\nSpecifies the test case timeout, defaulting to two (2) seconds (2000 milliseconds).\nTests taking longer than this amount of time will be marked as failed.\n\nTo override you may pass the timeout in milliseconds, or a value with the `s` suffix, e.g., `--timeout 2s` and `--timeout 2000` are equivalent.\n\nTo disable timeouts, use `--timeout 0`.\n\n:::note\nSynchronous (blocking) tests are also bound by the timeout, but they will not complete until the code stops blocking.\nInfinite loops will still be infinite loops!\n:::\n\n### `--ui , -u `\n\nThe `--ui` option lets you specify the interface to use, defaulting to `bdd`.\n\n## Reporting & Output\n\n### `--color, -c, --colors`\n\n:::note[Updated in v6.0.0]\n`--colors` is now an alias for `--color`.\n:::\n\n\"Force\" color output to be enabled, or alternatively force it to be disabled via `--no-color`.\nBy default, Mocha uses the [supports-color](https://npm.im/supports-color) module to decide.\n\nIn some cases, color output will be explicitly suppressed by certain reporters outputting in a machine-readable format.\n\n### `--diff`\n\nWhen possible, show the difference between expected and actual values when an assertion failure is encountered.\n\nThis flag is unusual in that it **defaults to `true`**; use `--no-diff` to suppress Mocha's own diff output.\n\nSome assertion libraries will supply their own diffs, in which case Mocha's will not be used, regardless of the default value.\n\nMocha's own diff output does not conform to any known standards, and is designed to be human-readable.\n\n:::note[New in v9.2.1]\n:::\n\nBy default strings are truncated to 8192 characters before generating a diff.\nThis is to prevent performance problems with large strings.\n\nIt can however make the output harder to interpret when comparing large strings.\nTherefore it is possible to configure this value using `--reporter-option maxDiffSize=[number]`.\n\nA value of 0 indicates no limit, default is 8192 characters.\n\n### `--full-trace`\n\nEnable \"full\" stack traces.\nBy default, Mocha attempts to distill stack traces into less noisy (though still useful) output.\n\nThis flag is helpful when debugging a suspected issue within Mocha or Node.js itself.\n\n### `--inline-diffs`\n\nEnable \"inline\" diffs, an alternative output for diffing strings.\n\nUseful when working with large strings.\n\nDoes nothing if an assertion library supplies its own diff output.\n\n### `--reporter , -R `\n\nSpecify the reporter that will be used, defaulting to `spec`.\n\nAllows use of third-party reporters.\nFor example, [mocha-lcov-reporter](https://npm.im/mocha-lcov-reporter) may be used with `--reporter mocha-lcov-reporter` after it has been installed.\n\n### `--reporter-option