Allow customization of network error about msw

[kettanaito]

Hi, @Lesstat. Thanks for raising this!

This has been brought up in the past, and I've decided not to support custom error messages with HttpResponse.error(). There are two reasons for it.

Reason 1: Response.error()

The HttpResponse.error() static method is modeled after the standard Response.error(), which does not support any arguments, representing a generic network error when processing a request. Staying consistent here means predictable behavior, and I value that quite a lot.

Reason 2: Inconsistent error handling

MSW v1 used to have a NetworkError class that supported custom error messages. It has quickly taught us that it is up to the request client to forward that error message to you, and some widely-used clients do not do that at all. This results in inconsistent errors, degrading the experience (and also producing different behavior based on what request client you're using, which we are trying to eliminate here at MSW).

I hope this gives you some insight as to why this wouldn't be a good idea to introduce.

When I stumbled upon your issue, I also noticed that we still recommended throwing errors in response resolvers in the docs. I've updated the HttpResponse.error() page, also providing a short summary as to why we are not supporting custom error messages.