SessionTests.swift 44 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249
  1. //
  2. // SessionTests.swift
  3. //
  4. // Copyright (c) 2014-2018 Alamofire Software Foundation (http://alamofire.org/)
  5. //
  6. // Permission is hereby granted, free of charge, to any person obtaining a copy
  7. // of this software and associated documentation files (the "Software"), to deal
  8. // in the Software without restriction, including without limitation the rights
  9. // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  10. // copies of the Software, and to permit persons to whom the Software is
  11. // furnished to do so, subject to the following conditions:
  12. //
  13. // The above copyright notice and this permission notice shall be included in
  14. // all copies or substantial portions of the Software.
  15. //
  16. // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  17. // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  18. // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  19. // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  20. // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  21. // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  22. // THE SOFTWARE.
  23. //
  24. @testable import Alamofire
  25. import Foundation
  26. import XCTest
  27. class SessionTestCase: BaseTestCase {
  28. // MARK: Helper Types
  29. private class HTTPMethodAdapter: RequestInterceptor {
  30. let method: HTTPMethod
  31. let throwsError: Bool
  32. var adaptedCount = 0
  33. init(method: HTTPMethod, throwsError: Bool = false) {
  34. self.method = method
  35. self.throwsError = throwsError
  36. }
  37. func adapt(_ urlRequest: URLRequest, for session: Session, completion: @escaping (Result<URLRequest>) -> Void) {
  38. adaptedCount += 1
  39. let result: Result<URLRequest> = Result {
  40. guard !throwsError else { throw AFError.invalidURL(url: "") }
  41. var urlRequest = urlRequest
  42. urlRequest.httpMethod = method.rawValue
  43. return urlRequest
  44. }
  45. completion(result)
  46. }
  47. }
  48. private class HeaderAdapter: RequestInterceptor {
  49. let headers: HTTPHeaders
  50. let throwsError: Bool
  51. var adaptedCount = 0
  52. init(headers: HTTPHeaders = ["field": "value"], throwsError: Bool = false) {
  53. self.headers = headers
  54. self.throwsError = throwsError
  55. }
  56. func adapt(_ urlRequest: URLRequest, for session: Session, completion: @escaping (Result<URLRequest>) -> Void) {
  57. adaptedCount += 1
  58. let result: Result<URLRequest> = Result {
  59. guard !throwsError else { throw AFError.invalidURL(url: "") }
  60. var urlRequest = urlRequest
  61. var finalHeaders = urlRequest.httpHeaders
  62. headers.forEach { finalHeaders.add($0) }
  63. urlRequest.httpHeaders = finalHeaders
  64. return urlRequest
  65. }
  66. completion(result)
  67. }
  68. }
  69. private class RequestHandler: RequestInterceptor {
  70. var adaptedCount = 0
  71. var retryCount = 0
  72. var retryErrors: [Error] = []
  73. var shouldApplyAuthorizationHeader = false
  74. var throwsErrorOnFirstAdapt = false
  75. var throwsErrorOnSecondAdapt = false
  76. var throwsErrorOnRetry = false
  77. var shouldRetry = true
  78. var retryDelay: TimeInterval?
  79. func adapt(_ urlRequest: URLRequest, for session: Session, completion: @escaping (Result<URLRequest>) -> Void) {
  80. let result: Result<URLRequest> = Result {
  81. if throwsErrorOnFirstAdapt {
  82. throwsErrorOnFirstAdapt = false
  83. throw AFError.invalidURL(url: "")
  84. }
  85. if throwsErrorOnSecondAdapt && adaptedCount == 1 {
  86. throwsErrorOnSecondAdapt = false
  87. throw AFError.invalidURL(url: "")
  88. }
  89. var urlRequest = urlRequest
  90. adaptedCount += 1
  91. if shouldApplyAuthorizationHeader && adaptedCount > 1 {
  92. urlRequest.httpHeaders.update(.authorization(username: "user", password: "password"))
  93. }
  94. return urlRequest
  95. }
  96. completion(result)
  97. }
  98. func retry(
  99. _ request: Request,
  100. for session: Session,
  101. dueTo error: Error,
  102. completion: @escaping (RetryResult) -> Void)
  103. {
  104. if throwsErrorOnRetry {
  105. let error = AFError.invalidURL(url: "")
  106. completion(.doNotRetryWithError(error))
  107. return
  108. }
  109. guard shouldRetry else { completion(.doNotRetry); return }
  110. retryCount += 1
  111. retryErrors.append(error)
  112. if retryCount < 2 {
  113. if let retryDelay = retryDelay {
  114. completion(.retryWithDelay(retryDelay))
  115. } else {
  116. completion(.retry)
  117. }
  118. } else {
  119. completion(.doNotRetry)
  120. }
  121. }
  122. }
  123. private class UploadHandler: RequestInterceptor {
  124. var adaptedCount = 0
  125. var retryCount = 0
  126. var retryErrors: [Error] = []
  127. func adapt(_ urlRequest: URLRequest, for session: Session, completion: @escaping (Result<URLRequest>) -> Void) {
  128. let result: Result<URLRequest> = Result {
  129. adaptedCount += 1
  130. if adaptedCount == 1 { throw AFError.invalidURL(url: "") }
  131. return urlRequest
  132. }
  133. completion(result)
  134. }
  135. func retry(
  136. _ request: Request,
  137. for session: Session,
  138. dueTo error: Error,
  139. completion: @escaping (RetryResult) -> Void)
  140. {
  141. retryCount += 1
  142. retryErrors.append(error)
  143. completion(.retry)
  144. }
  145. }
  146. // MARK: Tests - Initialization
  147. func testInitializerWithDefaultArguments() {
  148. // Given, When
  149. let session = Session()
  150. // Then
  151. XCTAssertNotNil(session.session.delegate, "session delegate should not be nil")
  152. XCTAssertTrue(session.delegate === session.session.delegate, "manager delegate should equal session delegate")
  153. XCTAssertNil(session.serverTrustManager, "session server trust policy manager should be nil")
  154. }
  155. func testInitializerWithSpecifiedArguments() {
  156. // Given
  157. let configuration = URLSessionConfiguration.default
  158. let delegate = SessionDelegate()
  159. let serverTrustManager = ServerTrustManager(evaluators: [:])
  160. // When
  161. let session = Session(configuration: configuration,
  162. delegate: delegate,
  163. serverTrustManager: serverTrustManager)
  164. // Then
  165. XCTAssertNotNil(session.session.delegate, "session delegate should not be nil")
  166. XCTAssertTrue(session.delegate === session.session.delegate, "manager delegate should equal session delegate")
  167. XCTAssertNotNil(session.serverTrustManager, "session server trust policy manager should not be nil")
  168. }
  169. func testThatSessionInitializerSucceedsWithDefaultArguments() {
  170. // Given
  171. let delegate = SessionDelegate()
  172. let underlyingQueue = DispatchQueue(label: "underlyingQueue")
  173. let urlSession: URLSession = {
  174. let configuration = URLSessionConfiguration.default
  175. let queue = OperationQueue(underlyingQueue: underlyingQueue, name: "delegateQueue")
  176. return URLSession(configuration: configuration, delegate: delegate, delegateQueue: queue)
  177. }()
  178. // When
  179. let session = Session(session: urlSession, delegate: delegate, rootQueue: underlyingQueue)
  180. // Then
  181. XCTAssertTrue(session.delegate === session.session.delegate, "manager delegate should equal session delegate")
  182. XCTAssertNil(session.serverTrustManager, "session server trust policy manager should be nil")
  183. }
  184. func testThatSessionInitializerSucceedsWithSpecifiedArguments() {
  185. // Given
  186. let delegate = SessionDelegate()
  187. let underlyingQueue = DispatchQueue(label: "underlyingQueue")
  188. let urlSession: URLSession = {
  189. let configuration = URLSessionConfiguration.default
  190. let queue = OperationQueue(underlyingQueue: underlyingQueue, name: "delegateQueue")
  191. return URLSession(configuration: configuration, delegate: delegate, delegateQueue: queue)
  192. }()
  193. let serverTrustManager = ServerTrustManager(evaluators: [:])
  194. // When
  195. let session = Session(session: urlSession,
  196. delegate: delegate,
  197. rootQueue: underlyingQueue,
  198. serverTrustManager: serverTrustManager)
  199. // Then
  200. XCTAssertTrue(session.delegate === session.session.delegate, "manager delegate should equal session delegate")
  201. XCTAssertNotNil(session.serverTrustManager, "session server trust policy manager should not be nil")
  202. }
  203. // MARK: Tests - Default HTTP Headers
  204. func testDefaultUserAgentHeader() {
  205. // Given, When
  206. let userAgent = HTTPHeaders.default["User-Agent"]
  207. // Then
  208. let osNameVersion: String = {
  209. let version = ProcessInfo.processInfo.operatingSystemVersion
  210. let versionString = "\(version.majorVersion).\(version.minorVersion).\(version.patchVersion)"
  211. let osName: String = {
  212. #if os(iOS)
  213. return "iOS"
  214. #elseif os(watchOS)
  215. return "watchOS"
  216. #elseif os(tvOS)
  217. return "tvOS"
  218. #elseif os(macOS)
  219. return "macOS"
  220. #elseif os(Linux)
  221. return "Linux"
  222. #else
  223. return "Unknown"
  224. #endif
  225. }()
  226. return "\(osName) \(versionString)"
  227. }()
  228. let alamofireVersion: String = {
  229. guard
  230. let afInfo = Bundle(for: Session.self).infoDictionary,
  231. let build = afInfo["CFBundleShortVersionString"]
  232. else { return "Unknown" }
  233. return "Alamofire/\(build)"
  234. }()
  235. let expectedUserAgent = "Unknown/Unknown (Unknown; build:Unknown; \(osNameVersion)) \(alamofireVersion)"
  236. XCTAssertEqual(userAgent, expectedUserAgent)
  237. }
  238. // MARK: Tests - Supported Accept-Encodings
  239. func testDefaultAcceptEncodingSupportsAppropriateEncodingsOnAppropriateSystems() {
  240. // Given
  241. let brotliURL = URL(string: "https://httpbin.org/brotli")!
  242. let gzipURL = URL(string: "https://httpbin.org/gzip")!
  243. let deflateURL = URL(string: "https://httpbin.org/deflate")!
  244. let brotliExpectation = expectation(description: "brotli request should complete")
  245. let gzipExpectation = expectation(description: "gzip request should complete")
  246. let deflateExpectation = expectation(description: "deflate request should complete")
  247. var brotliResponse: DataResponse<Any>?
  248. var gzipResponse: DataResponse<Any>?
  249. var deflateResponse: DataResponse<Any>?
  250. // When
  251. AF.request(brotliURL).responseJSON { response in
  252. brotliResponse = response
  253. brotliExpectation.fulfill()
  254. }
  255. AF.request(gzipURL).responseJSON { response in
  256. gzipResponse = response
  257. gzipExpectation.fulfill()
  258. }
  259. AF.request(deflateURL).responseJSON { response in
  260. deflateResponse = response
  261. deflateExpectation.fulfill()
  262. }
  263. waitForExpectations(timeout: timeout, handler: nil)
  264. // Then
  265. if #available(iOS 11.0, macOS 10.13, tvOS 11.0, watchOS 4.0, *) {
  266. XCTAssertTrue(brotliResponse?.result.isSuccess == true)
  267. } else {
  268. XCTAssertTrue(brotliResponse?.result.isFailure == true)
  269. }
  270. XCTAssertTrue(gzipResponse?.result.isSuccess == true)
  271. XCTAssertTrue(deflateResponse?.result.isSuccess == true)
  272. }
  273. // MARK: Tests - Start Requests Immediately
  274. func testSetStartRequestsImmediatelyToFalseAndResumeRequest() {
  275. // Given
  276. let session = Session(startRequestsImmediately: false)
  277. let url = URL(string: "https://httpbin.org/get")!
  278. let urlRequest = URLRequest(url: url)
  279. let expectation = self.expectation(description: "\(url)")
  280. var response: HTTPURLResponse?
  281. // When
  282. session.request(urlRequest)
  283. .response { resp in
  284. response = resp.response
  285. expectation.fulfill()
  286. }
  287. .resume()
  288. waitForExpectations(timeout: timeout, handler: nil)
  289. // Then
  290. XCTAssertNotNil(response, "response should not be nil")
  291. XCTAssertTrue(response?.statusCode == 200, "response status code should be 200")
  292. }
  293. func testSetStartRequestsImmediatelyToFalseAndCancelledCallsResponseHandlers() {
  294. // Given
  295. let session = Session(startRequestsImmediately: false)
  296. let url = URL(string: "https://httpbin.org/get")!
  297. let urlRequest = URLRequest(url: url)
  298. let expectation = self.expectation(description: "\(url)")
  299. var response: DataResponse<Data?>?
  300. // When
  301. let request = session.request(urlRequest)
  302. .cancel()
  303. .response { resp in
  304. response = resp
  305. expectation.fulfill()
  306. }
  307. waitForExpectations(timeout: timeout, handler: nil)
  308. // Then
  309. XCTAssertNotNil(response, "response should not be nil")
  310. XCTAssertTrue(request.isCancelled)
  311. XCTAssertTrue((request.task == nil) || (request.task?.state == .canceling || request.task?.state == .completed))
  312. guard let error = request.error?.asAFError, case .explicitlyCancelled = error else {
  313. XCTFail("Request should have an .explicitlyCancelled error.")
  314. return
  315. }
  316. }
  317. func testSetStartRequestsImmediatelyToFalseAndResumeThenCancelRequestHasCorrectOutput() {
  318. // Given
  319. let session = Session(startRequestsImmediately: false)
  320. let url = URL(string: "https://httpbin.org/get")!
  321. let urlRequest = URLRequest(url: url)
  322. let expectation = self.expectation(description: "\(url)")
  323. var response: DataResponse<Data?>?
  324. // When
  325. let request = session.request(urlRequest)
  326. .resume()
  327. .cancel()
  328. .response { resp in
  329. response = resp
  330. expectation.fulfill()
  331. }
  332. waitForExpectations(timeout: timeout, handler: nil)
  333. // Then
  334. XCTAssertNotNil(response, "response should not be nil")
  335. XCTAssertTrue(request.isCancelled)
  336. XCTAssertTrue((request.task == nil) || (request.task?.state == .canceling || request.task?.state == .completed))
  337. guard let error = request.error?.asAFError, case .explicitlyCancelled = error else {
  338. XCTFail("Request should have an .explicitlyCancelled error.")
  339. return
  340. }
  341. }
  342. func testSetStartRequestsImmediatelyToFalseAndCancelThenResumeRequestDoesntCreateTaskAndStaysCancelled() {
  343. // Given
  344. let session = Session(startRequestsImmediately: false)
  345. let url = URL(string: "https://httpbin.org/get")!
  346. let urlRequest = URLRequest(url: url)
  347. let expectation = self.expectation(description: "\(url)")
  348. var response: DataResponse<Data?>?
  349. // When
  350. let request = session.request(urlRequest)
  351. .cancel()
  352. .resume()
  353. .response { resp in
  354. response = resp
  355. expectation.fulfill()
  356. }
  357. waitForExpectations(timeout: timeout, handler: nil)
  358. // Then
  359. XCTAssertNotNil(response, "response should not be nil")
  360. XCTAssertTrue(request.isCancelled)
  361. XCTAssertTrue((request.task == nil) || (request.task?.state == .canceling || request.task?.state == .completed))
  362. guard let error = request.error?.asAFError, case .explicitlyCancelled = error else {
  363. XCTFail("Request should have an .explicitlyCancelled error.")
  364. return
  365. }
  366. }
  367. // MARK: Tests - Deinitialization
  368. func testReleasingManagerWithPendingRequestDeinitializesSuccessfully() {
  369. // Given
  370. let monitor = ClosureEventMonitor()
  371. let expectation = self.expectation(description: "Request created")
  372. monitor.requestDidCreateTask = { _, _ in expectation.fulfill() }
  373. var session: Session? = Session(startRequestsImmediately: false, eventMonitors: [monitor])
  374. let url = URL(string: "https://httpbin.org/get")!
  375. let urlRequest = URLRequest(url: url)
  376. // When
  377. let request = session?.request(urlRequest)
  378. session = nil
  379. waitForExpectations(timeout: timeout, handler: nil)
  380. // Then
  381. XCTAssertEqual(request?.task?.state, .suspended)
  382. XCTAssertNil(session, "manager should be nil")
  383. }
  384. func testReleasingManagerWithPendingCanceledRequestDeinitializesSuccessfully() {
  385. // Given
  386. var session: Session? = Session(startRequestsImmediately: false)
  387. let url = URL(string: "https://httpbin.org/get")!
  388. let urlRequest = URLRequest(url: url)
  389. // When
  390. let request = session?.request(urlRequest)
  391. request?.cancel()
  392. session = nil
  393. let state = request?.state
  394. // Then
  395. XCTAssertTrue(state == .cancelled, "state should be .cancelled")
  396. XCTAssertNil(session, "manager should be nil")
  397. }
  398. // MARK: Tests - Bad Requests
  399. func testThatDataRequestWithInvalidURLStringThrowsResponseHandlerError() {
  400. // Given
  401. let session = Session()
  402. let expectation = self.expectation(description: "Request should fail with error")
  403. var response: DataResponse<Data?>?
  404. // When
  405. session.request("https://httpbin.org/get/äëïöü").response { resp in
  406. response = resp
  407. expectation.fulfill()
  408. }
  409. waitForExpectations(timeout: timeout, handler: nil)
  410. // Then
  411. XCTAssertNil(response?.request)
  412. XCTAssertNil(response?.response)
  413. XCTAssertNil(response?.data)
  414. XCTAssertNotNil(response?.error)
  415. if let error = response?.error?.asAFError {
  416. XCTAssertTrue(error.isInvalidURLError)
  417. XCTAssertEqual(error.urlConvertible as? String, "https://httpbin.org/get/äëïöü")
  418. } else {
  419. XCTFail("error should not be nil")
  420. }
  421. }
  422. func testThatDownloadRequestWithInvalidURLStringThrowsResponseHandlerError() {
  423. // Given
  424. let session = Session()
  425. let expectation = self.expectation(description: "Download should fail with error")
  426. var response: DownloadResponse<URL?>?
  427. // When
  428. session.download("https://httpbin.org/get/äëïöü").response { resp in
  429. response = resp
  430. expectation.fulfill()
  431. }
  432. waitForExpectations(timeout: timeout, handler: nil)
  433. // Then
  434. XCTAssertNil(response?.request)
  435. XCTAssertNil(response?.response)
  436. XCTAssertNil(response?.fileURL)
  437. XCTAssertNil(response?.resumeData)
  438. XCTAssertNotNil(response?.error)
  439. if let error = response?.error?.asAFError {
  440. XCTAssertTrue(error.isInvalidURLError)
  441. XCTAssertEqual(error.urlConvertible as? String, "https://httpbin.org/get/äëïöü")
  442. } else {
  443. XCTFail("error should not be nil")
  444. }
  445. }
  446. func testThatUploadDataRequestWithInvalidURLStringThrowsResponseHandlerError() {
  447. // Given
  448. let session = Session()
  449. let expectation = self.expectation(description: "Upload should fail with error")
  450. var response: DataResponse<Data?>?
  451. // When
  452. session.upload(Data(), to: "https://httpbin.org/get/äëïöü").response { resp in
  453. response = resp
  454. expectation.fulfill()
  455. }
  456. waitForExpectations(timeout: timeout, handler: nil)
  457. // Then
  458. XCTAssertNil(response?.request)
  459. XCTAssertNil(response?.response)
  460. XCTAssertNil(response?.data)
  461. XCTAssertNotNil(response?.error)
  462. if let error = response?.error?.asAFError {
  463. XCTAssertTrue(error.isInvalidURLError)
  464. XCTAssertEqual(error.urlConvertible as? String, "https://httpbin.org/get/äëïöü")
  465. } else {
  466. XCTFail("error should not be nil")
  467. }
  468. }
  469. func testThatUploadFileRequestWithInvalidURLStringThrowsResponseHandlerError() {
  470. // Given
  471. let session = Session()
  472. let expectation = self.expectation(description: "Upload should fail with error")
  473. var response: DataResponse<Data?>?
  474. // When
  475. session.upload(URL(fileURLWithPath: "/invalid"), to: "https://httpbin.org/get/äëïöü").response { resp in
  476. response = resp
  477. expectation.fulfill()
  478. }
  479. waitForExpectations(timeout: timeout, handler: nil)
  480. // Then
  481. XCTAssertNil(response?.request)
  482. XCTAssertNil(response?.response)
  483. XCTAssertNil(response?.data)
  484. XCTAssertNotNil(response?.error)
  485. if let error = response?.error?.asAFError {
  486. XCTAssertTrue(error.isInvalidURLError)
  487. XCTAssertEqual(error.urlConvertible as? String, "https://httpbin.org/get/äëïöü")
  488. } else {
  489. XCTFail("error should not be nil")
  490. }
  491. }
  492. func testThatUploadStreamRequestWithInvalidURLStringThrowsResponseHandlerError() {
  493. // Given
  494. let session = Session()
  495. let expectation = self.expectation(description: "Upload should fail with error")
  496. var response: DataResponse<Data?>?
  497. // When
  498. session.upload(InputStream(data: Data()), to: "https://httpbin.org/get/äëïöü").response { resp in
  499. response = resp
  500. expectation.fulfill()
  501. }
  502. waitForExpectations(timeout: timeout, handler: nil)
  503. // Then
  504. XCTAssertNil(response?.request)
  505. XCTAssertNil(response?.response)
  506. XCTAssertNil(response?.data)
  507. XCTAssertNotNil(response?.error)
  508. if let error = response?.error?.asAFError {
  509. XCTAssertTrue(error.isInvalidURLError)
  510. XCTAssertEqual(error.urlConvertible as? String, "https://httpbin.org/get/äëïöü")
  511. } else {
  512. XCTFail("error should not be nil")
  513. }
  514. }
  515. // MARK: Tests - Request Adapter
  516. func testThatSessionCallsRequestAdaptersWhenCreatingDataRequest() {
  517. // Given
  518. let urlString = "https://httpbin.org/get"
  519. let methodAdapter = HTTPMethodAdapter(method: .post)
  520. let headerAdapter = HeaderAdapter()
  521. let monitor = ClosureEventMonitor()
  522. let session = Session(startRequestsImmediately: false, interceptor: methodAdapter, eventMonitors: [monitor])
  523. // When
  524. let expectation1 = self.expectation(description: "Request 1 created")
  525. monitor.requestDidCreateTask = { _, _ in expectation1.fulfill() }
  526. let request1 = session.request(urlString)
  527. waitForExpectations(timeout: timeout, handler: nil)
  528. let expectation2 = self.expectation(description: "Request 2 created")
  529. monitor.requestDidCreateTask = { _, _ in expectation2.fulfill() }
  530. let request2 = session.request(urlString, interceptor: headerAdapter)
  531. waitForExpectations(timeout: timeout, handler: nil)
  532. // Then
  533. XCTAssertEqual(request1.task?.originalRequest?.httpMethod, methodAdapter.method.rawValue)
  534. XCTAssertEqual(request2.task?.originalRequest?.httpMethod, methodAdapter.method.rawValue)
  535. XCTAssertEqual(request2.task?.originalRequest?.allHTTPHeaderFields?.count, 1)
  536. XCTAssertEqual(methodAdapter.adaptedCount, 2)
  537. XCTAssertEqual(headerAdapter.adaptedCount, 1)
  538. }
  539. func testThatSessionCallsRequestAdaptersWhenCreatingDownloadRequest() {
  540. // Given
  541. let urlString = "https://httpbin.org/get"
  542. let methodAdapter = HTTPMethodAdapter(method: .post)
  543. let headerAdapter = HeaderAdapter()
  544. let monitor = ClosureEventMonitor()
  545. let session = Session(startRequestsImmediately: false, interceptor: methodAdapter, eventMonitors: [monitor])
  546. // When
  547. let expectation1 = self.expectation(description: "Request 1 created")
  548. monitor.requestDidCreateTask = { _, _ in expectation1.fulfill() }
  549. let request1 = session.download(urlString)
  550. waitForExpectations(timeout: timeout, handler: nil)
  551. let expectation2 = self.expectation(description: "Request 2 created")
  552. monitor.requestDidCreateTask = { _, _ in expectation2.fulfill() }
  553. let request2 = session.download(urlString, interceptor: headerAdapter)
  554. waitForExpectations(timeout: timeout, handler: nil)
  555. // Then
  556. XCTAssertEqual(request1.task?.originalRequest?.httpMethod, methodAdapter.method.rawValue)
  557. XCTAssertEqual(request2.task?.originalRequest?.httpMethod, methodAdapter.method.rawValue)
  558. XCTAssertEqual(request2.task?.originalRequest?.allHTTPHeaderFields?.count, 1)
  559. XCTAssertEqual(methodAdapter.adaptedCount, 2)
  560. XCTAssertEqual(headerAdapter.adaptedCount, 1)
  561. }
  562. func testThatSessionCallsRequestAdaptersWhenCreatingUploadRequestWithData() {
  563. // Given
  564. let data = Data("data".utf8)
  565. let urlString = "https://httpbin.org/post"
  566. let methodAdapter = HTTPMethodAdapter(method: .get)
  567. let headerAdapter = HeaderAdapter()
  568. let monitor = ClosureEventMonitor()
  569. let session = Session(startRequestsImmediately: false, interceptor: methodAdapter, eventMonitors: [monitor])
  570. // When
  571. let expectation1 = self.expectation(description: "Request 1 created")
  572. monitor.requestDidCreateTask = { _, _ in expectation1.fulfill() }
  573. let request1 = session.upload(data, to: urlString)
  574. waitForExpectations(timeout: timeout, handler: nil)
  575. let expectation2 = self.expectation(description: "Request 2 created")
  576. monitor.requestDidCreateTask = { _, _ in expectation2.fulfill() }
  577. let request2 = session.upload(data, to: urlString, interceptor: headerAdapter)
  578. waitForExpectations(timeout: timeout, handler: nil)
  579. // Then
  580. XCTAssertEqual(request1.task?.originalRequest?.httpMethod, methodAdapter.method.rawValue)
  581. XCTAssertEqual(request2.task?.originalRequest?.httpMethod, methodAdapter.method.rawValue)
  582. XCTAssertEqual(request2.task?.originalRequest?.allHTTPHeaderFields?.count, 1)
  583. XCTAssertEqual(methodAdapter.adaptedCount, 2)
  584. XCTAssertEqual(headerAdapter.adaptedCount, 1)
  585. }
  586. func testThatSessionCallsRequestAdaptersWhenCreatingUploadRequestWithFile() {
  587. // Given
  588. let fileURL = URL(fileURLWithPath: "/path/to/some/file.txt")
  589. let urlString = "https://httpbin.org/post"
  590. let methodAdapter = HTTPMethodAdapter(method: .get)
  591. let headerAdapter = HeaderAdapter()
  592. let monitor = ClosureEventMonitor()
  593. let session = Session(startRequestsImmediately: false, interceptor: methodAdapter, eventMonitors: [monitor])
  594. // When
  595. let expectation1 = self.expectation(description: "Request 1 created")
  596. monitor.requestDidCreateTask = { _, _ in expectation1.fulfill() }
  597. let request1 = session.upload(fileURL, to: urlString)
  598. waitForExpectations(timeout: timeout, handler: nil)
  599. let expectation2 = self.expectation(description: "Request 2 created")
  600. monitor.requestDidCreateTask = { _, _ in expectation2.fulfill() }
  601. let request2 = session.upload(fileURL, to: urlString, interceptor: headerAdapter)
  602. waitForExpectations(timeout: timeout, handler: nil)
  603. // Then
  604. XCTAssertEqual(request1.task?.originalRequest?.httpMethod, methodAdapter.method.rawValue)
  605. XCTAssertEqual(request2.task?.originalRequest?.httpMethod, methodAdapter.method.rawValue)
  606. XCTAssertEqual(request2.task?.originalRequest?.allHTTPHeaderFields?.count, 1)
  607. XCTAssertEqual(methodAdapter.adaptedCount, 2)
  608. XCTAssertEqual(headerAdapter.adaptedCount, 1)
  609. }
  610. func testThatSessionCallsRequestAdaptersWhenCreatingUploadRequestWithInputStream() {
  611. // Given
  612. let inputStream = InputStream(data: Data("data".utf8))
  613. let urlString = "https://httpbin.org/post"
  614. let methodAdapter = HTTPMethodAdapter(method: .get)
  615. let headerAdapter = HeaderAdapter()
  616. let monitor = ClosureEventMonitor()
  617. let session = Session(startRequestsImmediately: false, interceptor: methodAdapter, eventMonitors: [monitor])
  618. // When
  619. let expectation1 = self.expectation(description: "Request 1 created")
  620. monitor.requestDidCreateTask = { _, _ in expectation1.fulfill() }
  621. let request1 = session.upload(inputStream, to: urlString)
  622. waitForExpectations(timeout: timeout, handler: nil)
  623. let expectation2 = self.expectation(description: "Request 2 created")
  624. monitor.requestDidCreateTask = { _, _ in expectation2.fulfill() }
  625. let request2 = session.upload(inputStream, to: urlString, interceptor: headerAdapter)
  626. waitForExpectations(timeout: timeout, handler: nil)
  627. // Then
  628. XCTAssertEqual(request1.task?.originalRequest?.httpMethod, methodAdapter.method.rawValue)
  629. XCTAssertEqual(request2.task?.originalRequest?.httpMethod, methodAdapter.method.rawValue)
  630. XCTAssertEqual(request2.task?.originalRequest?.allHTTPHeaderFields?.count, 1)
  631. XCTAssertEqual(methodAdapter.adaptedCount, 2)
  632. XCTAssertEqual(headerAdapter.adaptedCount, 1)
  633. }
  634. func testThatSessionReturnsRequestAdaptationErrorWhenRequestAdapterThrowsError() {
  635. // Given
  636. let urlString = "https://httpbin.org/get"
  637. let methodAdapter = HTTPMethodAdapter(method: .post, throwsError: true)
  638. let headerAdapter = HeaderAdapter(throwsError: true)
  639. let monitor = ClosureEventMonitor()
  640. let session = Session(startRequestsImmediately: false, interceptor: methodAdapter, eventMonitors: [monitor])
  641. // When
  642. let expectation1 = self.expectation(description: "Request 1 created")
  643. monitor.requestDidFailToAdaptURLRequestWithError = { _, _, _ in expectation1.fulfill() }
  644. let request1 = session.request(urlString)
  645. waitForExpectations(timeout: timeout, handler: nil)
  646. let expectation2 = self.expectation(description: "Request 2 created")
  647. monitor.requestDidFailToAdaptURLRequestWithError = { _, _, _ in expectation2.fulfill() }
  648. let request2 = session.request(urlString, interceptor: headerAdapter)
  649. waitForExpectations(timeout: timeout, handler: nil)
  650. let requests = [request1, request2]
  651. // Then
  652. for request in requests {
  653. if let error = request.error?.asAFError {
  654. XCTAssertTrue(error.isRequestAdaptationError)
  655. XCTAssertEqual(error.underlyingError?.asAFError?.urlConvertible as? String, "")
  656. } else {
  657. XCTFail("error should not be nil")
  658. }
  659. }
  660. }
  661. // MARK: Tests - Request Retrier
  662. func testThatSessionCallsRequestRetrierWhenRequestEncountersError() {
  663. // Given
  664. let handler = RequestHandler()
  665. let session = Session()
  666. let expectation = self.expectation(description: "request should eventually fail")
  667. var response: DataResponse<Any>?
  668. // When
  669. let request = session.request("https://httpbin.org/basic-auth/user/password", interceptor: handler)
  670. .validate()
  671. .responseJSON { jsonResponse in
  672. response = jsonResponse
  673. expectation.fulfill()
  674. }
  675. waitForExpectations(timeout: timeout, handler: nil)
  676. // Then
  677. XCTAssertEqual(handler.adaptedCount, 2)
  678. XCTAssertEqual(handler.retryCount, 2)
  679. XCTAssertEqual(request.retryCount, 1)
  680. XCTAssertEqual(response?.result.isSuccess, false)
  681. XCTAssertTrue(session.requestTaskMap.isEmpty)
  682. }
  683. func testThatSessionCallsRequestRetrierThenSessionRetrierWhenRequestEncountersError() {
  684. // Given
  685. let sessionHandler = RequestHandler()
  686. let requestHandler = RequestHandler()
  687. let session = Session(interceptor: sessionHandler)
  688. let expectation = self.expectation(description: "request should eventually fail")
  689. var response: DataResponse<Any>?
  690. // When
  691. let request = session.request("https://httpbin.org/basic-auth/user/password", interceptor: requestHandler)
  692. .validate()
  693. .responseJSON { jsonResponse in
  694. response = jsonResponse
  695. expectation.fulfill()
  696. }
  697. waitForExpectations(timeout: timeout, handler: nil)
  698. // Then
  699. XCTAssertEqual(sessionHandler.adaptedCount, 3)
  700. XCTAssertEqual(sessionHandler.retryCount, 2)
  701. XCTAssertEqual(requestHandler.adaptedCount, 3)
  702. XCTAssertEqual(requestHandler.retryCount, 3)
  703. XCTAssertEqual(request.retryCount, 2)
  704. XCTAssertEqual(response?.result.isSuccess, false)
  705. XCTAssertTrue(session.requestTaskMap.isEmpty)
  706. }
  707. func testThatSessionCallsRequestRetrierWhenRequestInitiallyEncountersAdaptError() {
  708. // Given
  709. let handler = RequestHandler()
  710. handler.adaptedCount = 1
  711. handler.throwsErrorOnSecondAdapt = true
  712. handler.shouldApplyAuthorizationHeader = true
  713. let session = Session()
  714. let expectation = self.expectation(description: "request should eventually fail")
  715. var response: DataResponse<Any>?
  716. // When
  717. session.request("https://httpbin.org/basic-auth/user/password", interceptor: handler)
  718. .validate()
  719. .responseJSON { jsonResponse in
  720. response = jsonResponse
  721. expectation.fulfill()
  722. }
  723. waitForExpectations(timeout: timeout, handler: nil)
  724. // Then
  725. XCTAssertEqual(handler.adaptedCount, 2)
  726. XCTAssertEqual(handler.retryCount, 1)
  727. XCTAssertEqual(response?.result.isSuccess, true)
  728. XCTAssertTrue(session.requestTaskMap.isEmpty)
  729. }
  730. func testThatSessionCallsRequestRetrierWhenDownloadInitiallyEncountersAdaptError() {
  731. // Given
  732. let handler = RequestHandler()
  733. handler.adaptedCount = 1
  734. handler.throwsErrorOnSecondAdapt = true
  735. handler.shouldApplyAuthorizationHeader = true
  736. let session = Session()
  737. let expectation = self.expectation(description: "request should eventually fail")
  738. var response: DownloadResponse<Any>?
  739. let destination: DownloadRequest.Destination = { _, _ in
  740. let fileURL = self.testDirectoryURL.appendingPathComponent("test-output.json")
  741. return (fileURL, [.removePreviousFile])
  742. }
  743. // When
  744. session.download("https://httpbin.org/basic-auth/user/password", interceptor: handler, to: destination)
  745. .validate()
  746. .responseJSON { jsonResponse in
  747. response = jsonResponse
  748. expectation.fulfill()
  749. }
  750. waitForExpectations(timeout: timeout, handler: nil)
  751. // Then
  752. XCTAssertEqual(handler.adaptedCount, 2)
  753. XCTAssertEqual(handler.retryCount, 1)
  754. XCTAssertEqual(response?.result.isSuccess, true)
  755. XCTAssertTrue(session.requestTaskMap.isEmpty)
  756. }
  757. func testThatSessionCallsRequestRetrierWhenUploadInitiallyEncountersAdaptError() {
  758. // Given
  759. let handler = UploadHandler()
  760. let session = Session(interceptor: handler)
  761. let expectation = self.expectation(description: "request should eventually fail")
  762. var response: DataResponse<Any>?
  763. let uploadData = Data("upload data".utf8)
  764. // When
  765. session.upload(uploadData, to: "https://httpbin.org/post")
  766. .validate()
  767. .responseJSON { jsonResponse in
  768. response = jsonResponse
  769. expectation.fulfill()
  770. }
  771. waitForExpectations(timeout: timeout, handler: nil)
  772. // Then
  773. XCTAssertEqual(handler.adaptedCount, 2)
  774. XCTAssertEqual(handler.retryCount, 1)
  775. XCTAssertEqual(response?.result.isSuccess, true)
  776. XCTAssertTrue(session.requestTaskMap.isEmpty)
  777. }
  778. func testThatSessionCallsAdapterWhenRequestIsRetried() {
  779. // Given
  780. let handler = RequestHandler()
  781. handler.shouldApplyAuthorizationHeader = true
  782. let session = Session(interceptor: handler)
  783. let expectation = self.expectation(description: "request should eventually succeed")
  784. var response: DataResponse<Any>?
  785. // When
  786. let request = session.request("https://httpbin.org/basic-auth/user/password")
  787. .validate()
  788. .responseJSON { jsonResponse in
  789. response = jsonResponse
  790. expectation.fulfill()
  791. }
  792. waitForExpectations(timeout: timeout, handler: nil)
  793. // Then
  794. XCTAssertEqual(handler.adaptedCount, 2)
  795. XCTAssertEqual(handler.retryCount, 1)
  796. XCTAssertEqual(request.retryCount, 1)
  797. XCTAssertEqual(response?.result.isSuccess, true)
  798. XCTAssertTrue(session.requestTaskMap.isEmpty)
  799. }
  800. func testThatSessionReturnsRequestAdaptationErrorWhenRequestIsRetried() {
  801. // Given
  802. let handler = RequestHandler()
  803. handler.throwsErrorOnSecondAdapt = true
  804. let session = Session(interceptor: handler)
  805. let expectation = self.expectation(description: "request should eventually fail")
  806. var response: DataResponse<Any>?
  807. // When
  808. let request = session.request("https://httpbin.org/basic-auth/user/password")
  809. .validate()
  810. .responseJSON { jsonResponse in
  811. response = jsonResponse
  812. expectation.fulfill()
  813. }
  814. waitForExpectations(timeout: timeout, handler: nil)
  815. // Then
  816. XCTAssertEqual(handler.adaptedCount, 1)
  817. XCTAssertEqual(handler.retryCount, 2)
  818. XCTAssertEqual(request.retryCount, 1)
  819. XCTAssertEqual(response?.result.isSuccess, false)
  820. XCTAssertTrue(session.requestTaskMap.isEmpty)
  821. if let error = response?.result.error?.asAFError {
  822. XCTAssertTrue(error.isRequestAdaptationError)
  823. XCTAssertEqual(error.underlyingError?.asAFError?.urlConvertible as? String, "")
  824. } else {
  825. XCTFail("error should not be nil")
  826. }
  827. }
  828. func testThatSessionRetriesRequestWithDelayWhenRetryResultContainsDelay() {
  829. // Given
  830. let handler = RequestHandler()
  831. handler.retryDelay = 0.01
  832. handler.throwsErrorOnSecondAdapt = true
  833. let session = Session(interceptor: handler)
  834. let expectation = self.expectation(description: "request should eventually fail")
  835. var response: DataResponse<Any>?
  836. // When
  837. let request = session.request("https://httpbin.org/basic-auth/user/password")
  838. .validate()
  839. .responseJSON { jsonResponse in
  840. response = jsonResponse
  841. expectation.fulfill()
  842. }
  843. waitForExpectations(timeout: timeout, handler: nil)
  844. // Then
  845. XCTAssertEqual(handler.adaptedCount, 1)
  846. XCTAssertEqual(handler.retryCount, 2)
  847. XCTAssertEqual(request.retryCount, 1)
  848. XCTAssertEqual(response?.result.isSuccess, false)
  849. XCTAssertTrue(session.requestTaskMap.isEmpty)
  850. if let error = response?.result.error?.asAFError {
  851. XCTAssertTrue(error.isRequestAdaptationError)
  852. XCTAssertEqual(error.underlyingError?.asAFError?.urlConvertible as? String, "")
  853. } else {
  854. XCTFail("error should not be nil")
  855. }
  856. }
  857. func testThatSessionReturnsRequestRetryErrorWhenRequestRetrierThrowsError() {
  858. // Given
  859. let handler = RequestHandler()
  860. handler.throwsErrorOnRetry = true
  861. let session = Session(interceptor: handler)
  862. let expectation = self.expectation(description: "request should eventually fail")
  863. var response: DataResponse<Any>?
  864. // When
  865. let request = session.request("https://httpbin.org/basic-auth/user/password")
  866. .validate()
  867. .responseJSON { jsonResponse in
  868. response = jsonResponse
  869. expectation.fulfill()
  870. }
  871. waitForExpectations(timeout: timeout, handler: nil)
  872. // Then
  873. XCTAssertEqual(handler.adaptedCount, 1)
  874. XCTAssertEqual(handler.retryCount, 0)
  875. XCTAssertEqual(request.retryCount, 0)
  876. XCTAssertEqual(response?.result.isSuccess, false)
  877. XCTAssertTrue(session.requestTaskMap.isEmpty)
  878. if let error = response?.result.error?.asAFError {
  879. XCTAssertTrue(error.isRequestRetryError)
  880. XCTAssertEqual(error.underlyingError?.asAFError?.urlConvertible as? String, "")
  881. } else {
  882. XCTFail("error should not be nil")
  883. }
  884. }
  885. // MARK: Tests - Session Invalidation
  886. func testThatSessionIsInvalidatedAndAllRequestsCompleteWhenSessionIsDeinitialized() {
  887. // Given
  888. let invalidationExpectation = expectation(description: "sessionDidBecomeInvalidWithError should be called")
  889. let events = ClosureEventMonitor()
  890. events.sessionDidBecomeInvalidWithError = { (_, _) in
  891. invalidationExpectation.fulfill()
  892. }
  893. var session: Session? = Session(startRequestsImmediately: false, eventMonitors: [events])
  894. var error: Error?
  895. let requestExpectation = expectation(description: "request should complete")
  896. // When
  897. session?.request(URLRequest.makeHTTPBinRequest()).response { (response) in
  898. error = response.error
  899. requestExpectation.fulfill()
  900. }
  901. session = nil
  902. waitForExpectations(timeout: timeout, handler: nil)
  903. // Then
  904. assertErrorIsAFError(error) { XCTAssertTrue($0.isSessionDeinitializedError) }
  905. }
  906. }
  907. // MARK: -
  908. class SessionManagerConfigurationHeadersTestCase: BaseTestCase {
  909. enum ConfigurationType {
  910. case `default`, ephemeral, background
  911. }
  912. func testThatDefaultConfigurationHeadersAreSentWithRequest() {
  913. // Given, When, Then
  914. executeAuthorizationHeaderTest(for: .default)
  915. }
  916. func testThatEphemeralConfigurationHeadersAreSentWithRequest() {
  917. // Given, When, Then
  918. executeAuthorizationHeaderTest(for: .ephemeral)
  919. }
  920. #if os(macOS)
  921. func testThatBackgroundConfigurationHeadersAreSentWithRequest() {
  922. // Given, When, Then
  923. executeAuthorizationHeaderTest(for: .background)
  924. }
  925. #endif
  926. private func executeAuthorizationHeaderTest(for type: ConfigurationType) {
  927. // Given
  928. let session: Session = {
  929. let configuration: URLSessionConfiguration = {
  930. let configuration: URLSessionConfiguration
  931. switch type {
  932. case .default:
  933. configuration = .default
  934. case .ephemeral:
  935. configuration = .ephemeral
  936. case .background:
  937. let identifier = "org.alamofire.test.manager-configuration-tests"
  938. configuration = .background(withIdentifier: identifier)
  939. }
  940. var headers = HTTPHeaders.default
  941. headers["Authorization"] = "Bearer 123456"
  942. configuration.httpHeaders = headers
  943. return configuration
  944. }()
  945. return Session(configuration: configuration)
  946. }()
  947. let expectation = self.expectation(description: "request should complete successfully")
  948. var response: DataResponse<Any>?
  949. // When
  950. session.request("https://httpbin.org/headers")
  951. .responseJSON { closureResponse in
  952. response = closureResponse
  953. expectation.fulfill()
  954. }
  955. waitForExpectations(timeout: timeout, handler: nil)
  956. // Then
  957. if let response = response {
  958. XCTAssertNotNil(response.request, "request should not be nil")
  959. XCTAssertNotNil(response.response, "response should not be nil")
  960. XCTAssertNotNil(response.data, "data should not be nil")
  961. XCTAssertTrue(response.result.isSuccess, "result should be a success")
  962. if
  963. let response = response.result.value as? [String: Any],
  964. let headers = response["headers"] as? [String: String],
  965. let authorization = headers["Authorization"]
  966. {
  967. XCTAssertEqual(authorization, "Bearer 123456", "authorization header value does not match")
  968. } else {
  969. XCTFail("failed to extract authorization header value")
  970. }
  971. } else {
  972. XCTFail("response should not be nil")
  973. }
  974. }
  975. }