Retries and before each not working

When having an integration/e2e test it might happen that beforeEach could fail. In the example from the documentation: https://mochajs.org/#retry-tests

describe('retries', function() {
  // Retry all tests in this suite up to 4 times
  this.retries(4);

  beforeEach(function() {
    browser.get('http://www.yahoo.com');
  });

  it('should succeed on the 3rd try', function() {
    // Specify this test to only retry up to 2 times
    this.retries(2);
    expect($('.foo').isDisplayed()).to.eventually.be.true;
  });
});

It could happen that browser.get fails and we need a retry. Currently, one could have “browser.get” inside the it, but that does not allow to reuse code across tests.

I’d be interested in doing:

beforeEach(function() {
    this.retries(2)
    browser.get('http://www.yahoo.com');
  });

Not sure that it makes 100% sense. If it does not make sense, maybe it would be possible to change the documentation, since it can be slightly misleading:

This feature does re-run beforeEach/afterEach hooks but not before/after hooks.

It could either mean that retries affect beforeEach, or what it actually means, that if the test fails then beforeEach will be executed again.

[juergba]

this.retries() has no effect on failing hooks. No hooks or tests will be re-run.

this.retries() does re-run a failing test it()

• incl. its corresponding beforeEach and afterEach hooks
• excl. before and after hooks

[juergba]

We updated our docs accordingly, thank you.