[Docs]: toThrow fails if error object contains a `cause` property

[kirkwaiblinger]

[Docs]: toThrow fails if error object contains a `cause` property

[kirkwaiblinger]

This appears to occur in the synchronous case as well:

    expect(() => {
      throw new Error('message', { cause: new Error('cause') });
    }).toThrow(new Error('message'));

output:

    expect(received).toThrow(expected)

    Expected message:           "message"
    Received message and cause: "{ message: message, cause: { message: cause }}"

but doesn't occur if cause is just a string....

In summary:

  it("should pass, but doesn't, async case", async () => {
    await expect(
      (async () => {
        throw new Error('message', { cause: new Error('cause') });
      })(),
    ).rejects.toThrow(new Error('message'));
  });

  it("should pass, but doesn't, sync case", () => {
    expect(() => {
      throw new Error('message', { cause: new Error('cause') });
    }).toThrow(new Error('message'));
  });

  it('should pass, does pass', () => {
    expect(() => {
      throw new Error('message', { cause: 'cause' });
    }).toThrow(new Error('message'));
  });

TBH it seems like this may be a bug, not just undocumented behavior