/**
 * An {@link Error} that wraps a {@link Response}.
 *
 * Thrown when the HTTP response is not OK (HTTP code status outside range 200 – 299).
 */
// Should be named HTTPError or HttpError?
// - [XML*Http*Request](https://developer.mozilla.org/en-US/docs/Web/API)
// - Node.js uses [http](https://nodejs.org/en/docs/guides/anatomy-of-an-http-transaction/)
// - Deno uses [Http](https://github.com/denoland/deno/blob/v1.5.3/cli/rt/01_errors.js#L116)
export class HttpError extends Error {
  /**
   * Undefined when using {@link createHttpError()} or {@link createResponsePromise()}.
   */
  request: Request;
  response: Response;

  constructor(request: Request, response: Response) {
    const { status, statusText } = response;

    super(
      // statusText can be empty: https://stackoverflow.com/q/41632077
      statusText || String(status)
    );

    this.name = 'HttpError';
    this.request = request;
    this.response = response;
  }
}