@typespec/ts-http-runtime
Version:
Isomorphic client library for making HTTP requests in node.js and browser.
89 lines • 3.23 kB
JavaScript
// Copyright (c) Microsoft Corporation.
// Licensed under the MIT License.
import { isError } from "./util/error.js";
import { custom } from "./util/inspect-web.mjs";
import { Sanitizer } from "./util/sanitizer.js";
const errorSanitizer = new Sanitizer();
/**
* A custom error type for failed pipeline requests.
*/
export class RestError extends Error {
/**
* Something went wrong when making the request.
* This means the actual request failed for some reason,
* such as a DNS issue or the connection being lost.
*/
static REQUEST_SEND_ERROR = "REQUEST_SEND_ERROR";
/**
* This means that parsing the response from the server failed.
* It may have been malformed.
*/
static PARSE_ERROR = "PARSE_ERROR";
/**
* The code of the error itself (use statics on RestError if possible.)
*/
code;
/**
* The HTTP status code of the request (if applicable.)
*/
statusCode;
/**
* The request that was made.
* This property is non-enumerable.
*/
request;
/**
* The response received (if any.)
* This property is non-enumerable.
*/
response;
/**
* Bonus property set by the throw site.
*/
details;
constructor(message, options = {}) {
super(message);
this.name = "RestError";
this.code = options.code;
this.statusCode = options.statusCode;
// The request and response may contain sensitive information in the headers or body.
// To help prevent this sensitive information being accidentally logged, the request and response
// properties are marked as non-enumerable here. This prevents them showing up in the output of
// JSON.stringify and console.log.
Object.defineProperty(this, "request", { value: options.request, enumerable: false });
Object.defineProperty(this, "response", { value: options.response, enumerable: false });
// Only include useful agent information in the request for logging, as the full agent object
// may contain large binary data.
const agent = this.request?.agent
? {
maxFreeSockets: this.request.agent.maxFreeSockets,
maxSockets: this.request.agent.maxSockets,
}
: undefined;
// Logging method for util.inspect in Node
Object.defineProperty(this, custom, {
value: () => {
// Extract non-enumerable properties and add them back. This is OK since in this output the request and
// response get sanitized.
return `RestError: ${this.message} \n ${errorSanitizer.sanitize({
...this,
request: { ...this.request, agent },
response: this.response,
})}`;
},
enumerable: false,
});
Object.setPrototypeOf(this, RestError.prototype);
}
}
/**
* Typeguard for RestError
* @param e - Something caught by a catch clause.
*/
export function isRestError(e) {
if (e instanceof RestError) {
return true;
}
return isError(e) && e.name === "RestError";
}
//# sourceMappingURL=restError.js.map