Merge #1739 into Got 12

Author: szmarczak

source/as-promise/types.ts

@@ -15,6 +15,7 @@ export class CancelError extends RequestError {
 	constructor(request: Request) {
 		super('Promise was canceled', {}, request);
 		this.name = 'CancelError';
+		this.code = 'ERR_CANCELED';
 	}
 
 	get isCanceled() {

source/core/calculate-retry-delay.ts

@@ -18,7 +18,7 @@ const calculateRetryDelay: Returns<RetryFunction, number> = ({
 	}
 
 	const hasMethod = retryOptions.methods.includes(error.options.method);
-	const hasErrorCode = retryOptions.errorCodes.includes(error.code!);
+	const hasErrorCode = retryOptions.errorCodes.includes(error.code);
 	const hasStatusCode = error.response && retryOptions.statusCodes.includes(error.response.statusCode);
 	if (!hasMethod || (!hasErrorCode && !hasStatusCode)) {
 		return 0;

source/core/errors.ts

@@ -19,7 +19,7 @@ Contains a `code` property with error class code, like `ECONNREFUSED`.
 export class RequestError extends Error {
 	input?: string;
 
-	code?: string;
+	code: string;
 	stack!: string;
 	declare readonly options: Options;
 	readonly response?: Response;
@@ -31,7 +31,7 @@ export class RequestError extends Error {
 		Error.captureStackTrace(this, this.constructor);
 
 		this.name = 'RequestError';
-		this.code = error.code;
+		this.code = error.code ?? 'ERR_GOT_REQUEST_ERROR';
 		this.input = (error as any).input;
 
 		if (isRequest(self)) {
@@ -80,6 +80,7 @@ export class MaxRedirectsError extends RequestError {
 	constructor(request: Request) {
 		super(`Redirected ${request.options.maxRedirects} times. Aborting.`, {}, request);
 		this.name = 'MaxRedirectsError';
+		this.code = 'ERR_TOO_MANY_REDIRECTS';
 	}
 }
 
@@ -95,6 +96,7 @@ export class HTTPError extends RequestError {
 	constructor(response: PlainResponse) {
 		super(`Response code ${response.statusCode} (${response.statusMessage!})`, {}, response.request);
 		this.name = 'HTTPError';
+		this.code = 'ERR_NON_2XX_3XX_RESPONSE';
 	}
 }
 
@@ -108,6 +110,7 @@ export class CacheError extends RequestError {
 	constructor(error: Error, request: Request) {
 		super(error.message, error, request);
 		this.name = 'CacheError';
+		this.code = this.code === 'ERR_GOT_REQUEST_ERROR' ? 'ERR_CACHE_ACCESS' : this.code;
 	}
 }
 
@@ -120,6 +123,7 @@ export class UploadError extends RequestError {
 	constructor(error: Error, request: Request) {
 		super(error.message, error, request);
 		this.name = 'UploadError';
+		this.code = this.code === 'ERR_GOT_REQUEST_ERROR' ? 'ERR_UPLOAD' : this.code;
 	}
 }
 
@@ -151,6 +155,7 @@ export class ReadError extends RequestError {
 	constructor(error: Error, request: Request) {
 		super(error.message, error, request);
 		this.name = 'ReadError';
+		this.code = this.code === 'ERR_GOT_REQUEST_ERROR' ? 'ERR_READING_RESPONSE_STREAM' : this.code;
 	}
 }
 

source/core/options.ts

@@ -1166,7 +1166,10 @@ export default class Options {
 		}
 
 		if (url.protocol !== 'http:' && url.protocol !== 'https:') {
-			throw new Error(`Unsupported protocol: ${url.protocol}`);
+			const error: NodeJS.ErrnoException = new Error(`Unsupported protocol: ${url.protocol}`);
+			error.code = 'ERR_UNSUPPORTED_PROTOCOL';
+
+			throw error;
 		}
 
 		if (this._internals.username) {

source/core/response.ts

@@ -123,6 +123,7 @@ export class ParseError extends RequestError {
 
 		super(`${error.message} in "${options.url!.toString()}"`, error, response.request);
 		this.name = 'ParseError';
+		this.code = 'ERR_BODY_PARSE_FAILURE';
 	}
 }
 

test/cache.ts

@@ -121,7 +121,10 @@ test('cache error throws `CacheError`', withServer, async (t, server, got) => {
 	const cache = {};
 
 	// @ts-expect-error Error tests
-	await t.throwsAsync(got({cache}), {instanceOf: CacheError});
+	await t.throwsAsync(got({cache}), {
+		instanceOf: CacheError,
+		code: 'ERR_CACHE_ACCESS'
+	});
 });
 
 test('doesn\'t cache response when received HTTP error', withServer, async (t, server, got) => {

test/cancel.ts

@@ -78,7 +78,10 @@ test.serial('does not retry after cancelation', withServerAndFakeTimers, async (
 		gotPromise.cancel();
 	});
 
-	await t.throwsAsync(gotPromise, {instanceOf: CancelError});
+	await t.throwsAsync(gotPromise, {
+		instanceOf: CancelError,
+		code: 'ERR_CANCELED'
+	});
 	await t.notThrowsAsync(promise, 'Request finished instead of aborting.');
 });
 
@@ -105,7 +108,10 @@ test.serial('cleans up request timeouts', withServer, async (t, server, got) =>
 		}
 	});
 
-	await t.throwsAsync(gotPromise, {instanceOf: CancelError});
+	await t.throwsAsync(gotPromise, {
+		instanceOf: CancelError,
+		code: 'ERR_CANCELED'
+	});
 
 	// Wait for unhandled errors
 	await delay(40);
@@ -127,7 +133,10 @@ test.serial('cancels in-progress request', withServerAndFakeTimers, async (t, se
 		body.push(null);
 	});
 
-	await t.throwsAsync(gotPromise, {instanceOf: CancelError});
+	await t.throwsAsync(gotPromise, {
+		instanceOf: CancelError,
+		code: 'ERR_CANCELED'
+	});
 	await t.notThrowsAsync(promise, 'Request finished instead of aborting.');
 });
 
@@ -147,7 +156,10 @@ test.serial('cancels in-progress request with timeout', withServerAndFakeTimers,
 		body.push(null);
 	});
 
-	await t.throwsAsync(gotPromise, {instanceOf: CancelError});
+	await t.throwsAsync(gotPromise, {
+		instanceOf: CancelError,
+		code: 'ERR_CANCELED'
+	});
 	await t.notThrowsAsync(promise, 'Request finished instead of aborting.');
 });
 
@@ -227,7 +239,10 @@ test.serial('throws on incomplete (canceled) response - promise #2', withServer,
 		promise.cancel();
 	}, 500);
 
-	await t.throwsAsync(promise, {instanceOf: CancelError});
+	await t.throwsAsync(promise, {
+		instanceOf: CancelError,
+		code: 'ERR_CANCELED'
+	});
 });
 
 test.serial('throws on incomplete (canceled) response - stream', withServerAndFakeTimers, async (t, server, got, clock) => {
@@ -255,5 +270,8 @@ test('throws when canceling cached request', withServer, async (t, server, got)
 	const promise = got({cache});
 	promise.cancel();
 
-	await t.throwsAsync(promise, {instanceOf: CancelError});
+	await t.throwsAsync(promise, {
+		instanceOf: CancelError,
+		code: 'ERR_CANCELED'
+	});
 });

test/error.ts

@@ -27,7 +27,7 @@ test('properties', withServer, async (t, server, got) => {
 	t.truthy(error.options);
 	t.true({}.propertyIsEnumerable.call(error, 'options'));
 	t.false({}.propertyIsEnumerable.call(error, 'response'));
-	t.is(error.code, undefined);
+	t.is(error.code, 'ERR_NON_2XX_3XX_RESPONSE');
 	t.is(error.message, 'Response code 404 (Not Found)');
 	t.deepEqual(error.options.url, url);
 	t.is(error.response.headers.connection, 'close');
@@ -40,6 +40,7 @@ test('catches dns errors', async t => {
 	t.regex(error.message, /ENOTFOUND|EAI_AGAIN/);
 	t.is((error.options.url as URL).host, 'doesntexist');
 	t.is(error.options.method, 'GET');
+	t.is(error.code, 'ENOTFOUND');
 });
 
 test('`options.body` form error message', async t => {
@@ -132,7 +133,8 @@ test('`http.request` error', async t => {
 		}
 	}), {
 		instanceOf: RequestError,
-		message: 'The header content contains invalid characters'
+		message: 'The header content contains invalid characters',
+		code: 'ERR_GOT_REQUEST_ERROR'
 	});
 });
 
@@ -236,7 +238,8 @@ test('promise does not hang on timeout on HTTP error', withServer, async (t, ser
 			request: 100
 		}
 	}), {
-		instanceOf: TimeoutError
+		instanceOf: TimeoutError,
+		code: 'ETIMEDOUT'
 	});
 });
 

test/http.ts

@@ -93,7 +93,8 @@ test('doesn\'t throw if `options.throwHttpErrors` is false', withServer, async (
 test('invalid protocol throws', async t => {
 	await t.throwsAsync(got('c:/nope.com').json(), {
 		instanceOf: RequestError,
-		message: 'Unsupported protocol: c:'
+		message: 'Unsupported protocol: c:',
+		code: 'ERR_UNSUPPORTED_PROTOCOL'
 	});
 });
 
@@ -226,7 +227,8 @@ test('throws an error if the server aborted the request', withServer, async (t,
 	});
 
 	const error = await t.throwsAsync<ReadError>(got(''), {
-		message: 'The server aborted pending request'
+		message: 'The server aborted pending request',
+		code: 'ECONNRESET'
 	});
 
 	t.truthy(error.response.retryCount);

test/post.ts

@@ -334,7 +334,8 @@ test('throws on upload error', withServer, async (t, server, got) => {
 		}
 	})), {
 		instanceOf: UploadError,
-		message
+		message,
+		code: 'ERR_UPLOAD'
 	});
 });