Document allowing mocha root plugins in the browser

[IanVS]

Is your feature request related to a problem or a nice-to-have?? Please describe.

I am using @web/test-runner, which uses mocha in the browser. I need a way to call cleanup from '@testing-library/react' after every test, which seems like the perfect thing for a root plugin.

However, plugins need to be added with --require, which I can't use since I'm in the browser.

Describe the solution you'd like
I think a new option should be added to mocha.setup(), to allow specifying mochaHooks directly.

Describe alternatives you've considered
I've tried using root hooks, loaded in a <script> after mocha is set up, and that was working for firefox and chrome, but fails in safari which seems to try to run it before mocha is finished being added to the global scope. Also, the docs recommend root hook plugins instead, and I'd like to avoid an approach which might be deprecated.

Additional context
Add any other context or screenshots about the feature request here.

[IanVS]

After looking into it more, it seems that rootHooks is indeed available to use on mocha.setup(). So I've changed this ticket to documenting it, because it definitely wasn't clear that it was possible to do.

[gushogg-blake]

@IanVS how did you get this working? I tried adding a config option to the setup call but it didn't work (setup("bdd", { rootHooks: ... });). Searching for setup in the code doesn't turn anything up either... Cheers!

[gushogg-blake]

Found it - setup takes an options object or a string, in which case the string is used as the ui option ("bdd" etc):

mocha/browser-entry.js

Line 147 in 667e9a2

mocha.setup = function(opts) {