Class: StatusCodeError¶

An error that will be thrown by Fetcher.fetch when the fetcher response has an HTTP status code of 400 or greater.

This class largely models the StatusCodeError from the (now deprecated) request-promise library, which has a quirky structure.

Example¶

let response;
try {
  response = await context.fetcher.fetch({
    method: "GET",
    // Open this URL in your browser to see what the data looks like.
    url: "https://api.artic.edu/api/v1/artworks/123",
  });
} catch (error) {
  // If the request failed because the server returned a 300+ status code.
  if (coda.StatusCodeError.isStatusCodeError(error)) {
    // Cast the error as a StatusCodeError, for better intellisense.
    let statusError = error as coda.StatusCodeError;
    // If the API returned an error message in the body, show it to the user.
    let message = statusError.body?.detail;
    if (message) {
      throw new coda.UserVisibleError(message);
    }
  }
  // The request failed for some other reason. Re-throw the error so that it
  // bubbles up.
  throw error;
}

See¶

Fetching remote data - Errors

Extends¶

Error

Properties¶

body¶

body: any

Defined in: api.ts:207

The parsed body of the HTTP response.

error¶

error: any

Defined in: api.ts:211

Alias for body.

name¶

name: string = 'StatusCodeError'

Defined in: api.ts:199

The name of the error, for identification purposes.

Overrides¶

Error.name

options¶

options: FetchRequest

Defined in: api.ts:215

The original fetcher request used to make this HTTP request.

response¶

response: StatusCodeErrorResponse

Defined in: api.ts:219

The raw HTTP response, including headers.

statusCode¶

statusCode: number

Defined in: api.ts:203

The HTTP status code, e.g. 404.

Methods¶

isStatusCodeError()¶

static isStatusCodeError(err): err is StatusCodeError

Defined in: api.ts:241

Returns if the error is an instance of StatusCodeError. Note that instanceof may not work.

Parameters¶

Parameter	Type
`err`	`any`

Returns¶

err is StatusCodeError