{"id":9227,"date":"2022-03-05T20:35:36","date_gmt":"2022-03-05T20:35:36","guid":{"rendered":"http:\/\/putridparrot.com\/blog\/?p=9227"},"modified":"2022-03-05T20:35:36","modified_gmt":"2022-03-05T20:35:36","slug":"urlsession-shared-datatask-and-http-errors-such-as-404","status":"publish","type":"post","link":"https:\/\/putridparrot.com\/blog\/urlsession-shared-datatask-and-http-errors-such-as-404\/","title":{"rendered":"URLSession.shared.dataTask and HTTP errors such as 404"},"content":{"rendered":"

The URLSession.shared.dataTask<\/em> completionHandler passes us three pieces of information. Data, the response from an HTTP request and an error. <\/p>\n

Transport errors are returned within the error object but HTTP status codes which we’d possible class as errors are supplied in the response object, so I wanted both transport and HTTP status errors to be returned as an Error.<\/p>\n

Note: I’m not using URLSession.shared.data as it’s not currently supported on Linux, from what I can tell.<\/em><\/p>\n

The code below creates a new dataTask method that is async and returns a Result<Data?, Error><\/em>. Let’s first look at new dataTask method without the status code handling<\/p>\n

\r\nprivate func dataTask(with request: URLRequest) async -> Result<Data?, Error> {\r\n   await withCheckedContinuation { continuation in\r\n      URLSession.shared.dataTask(with: request) { data, response, error in\r\n         if let error = error {\r\n            continuation.resume(returning: .failure(error))\r\n            return\r\n         }\r\n         continuation.resume(returning: .success(data))\r\n    }.resume()\r\n}\r\n<\/pre>\n
So this creates a continuation which is used as a promise\/future\/task by calling the continuation resume<\/em> method with either a success or failure.<\/p>\n
As already mentioned, this will not return 404’s (for example) as errors. So let’s simply add code to create a failure when certain HTTP status codes appear. We might want to differentiate between the two types of error, i.e. transport layer and HTTP, so first off let’s create our Error subclass, which looks like this<\/p>\n
\r\npublic enum HTTPError: Error {\r\n    case transportError(Error)\r\n    case httpError(Int)\r\n}\r\n<\/pre>\n
This will allow us to pass back the Error from the URLSession.shared.dataTask<\/em> completion handler for transport errors and the code from the HTTP status for HTTP errors.<\/p>\n
Now we’ll change the earlier code to look like this<\/p>\n
\r\nprivate func dataTask(with request: URLRequest) async -> Result<Data?, Error> {\r\n   await withCheckedContinuation { continuation in\r\n      URLSession.shared.dataTask(with: request) { data, response, error in\r\n         if let error = error {\r\n            continuation.resume(returning: .failure(HTTPError.transportError(error)))\r\n            return\r\n         }\r\n\r\n         let resp = response as! HTTPURLResponse\r\n         let status = resp.statusCode\r\n         guard (200...299).contains(status) else {\r\n            continuation.resume(returning: .failure(HTTPError.httpError(status)))\r\n            return\r\n         }\r\n\r\n         continuation.resume(returning: .success(data))\r\n    }.resume()\r\n}\r\n<\/pre>\n
Now we can check the Result<Data?, Error><\/em> for the error and see what type of error it is, for the example below I actually throw the error for the caller to catch<\/p>\n
\r\nlet result = await dataTask(url: url!, httpMethod: "POST", httpBody: httpBody)\r\nif case .failure(let error) = result  {\r\n   throw error            \r\n}\r\n<\/pre>\n","protected":false},"excerpt":{"rendered":"
The URLSession.shared.dataTask completionHandler passes us three pieces of information. Data, the response from an HTTP request and an error. Transport errors are returned within the error object but HTTP status codes which we’d possible class as errors are supplied in the response object, so I wanted both transport and HTTP status errors to be returned […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_jetpack_memberships_contains_paid_content":false,"footnotes":""},"categories":[286],"tags":[],"class_list":["post-9227","post","type-post","status-publish","format-standard","hentry","category-swift"],"jetpack_sharing_enabled":true,"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/posts\/9227","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/comments?post=9227"}],"version-history":[{"count":4,"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/posts\/9227\/revisions"}],"predecessor-version":[{"id":9231,"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/posts\/9227\/revisions\/9231"}],"wp:attachment":[{"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/media?parent=9227"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/categories?post=9227"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/tags?post=9227"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}