Add throwHttpErrors option (#14)

index.js

@@ -88,7 +88,7 @@ const timeout = (promise, ms) => Promise.race([
 ]);
 
 class Ky {
-	constructor(input, {timeout = 10000, json, ...otherOptions}) {
+	constructor(input, {timeout = 10000, throwHttpErrors = true, json, ...otherOptions}) {
 		this._input = input;
 		this._retryCount = 0;
 
@@ -100,6 +100,7 @@ class Ky {
 		};
 
 		this._timeout = timeout;
+		this._throwHttpErrors = throwHttpErrors;
 
 		const headers = new window.Headers(this._options.headers || {});
 
@@ -149,7 +150,9 @@ class Ky {
 					return retry();
 				}
 
-				throw error;
+				if (this._throwHttpErrors) {
+					throw error;
+				}
 			}
 		};
 

readme.md

@@ -125,6 +125,15 @@ Default: `10000`
 
 Timeout in milliseconds for getting a response.
 
+### throwHttpErrors
+
+Type: `boolean`<br>
+Default: `true`
+
+Throw a `HTTPError` for error responses (non-2xx status codes).
+
+Setting this to `false` may be useful if you are checking for resource availability and are expecting error responses.
+
 ### ky.extend(defaultOptions)
 
 Create a new `ky` instance with some defaults overridden with your own.

test.js

@@ -222,6 +222,20 @@ test('timeout option', async t => {
 	await server.close();
 });
 
+test('throwHttpErrors option', async t => {
+	const server = await createTestServer();
+	server.get('/', (request, response) => {
+		response.sendStatus(500);
+	});
+
+	await t.notThrowsAsync(
+		ky.get(server.url, {throwHttpErrors: false}).text(),
+		/Internal Server Error/
+	);
+
+	await server.close();
+});
+
 test('ky.extend()', async t => {
 	const server = await createTestServer();
 	server.get('/', (request, response) => {