URLSession の新しい HTTP ローダ

この提案では、Darwin の URLSession で新しい HTTP ローダを利用するためのオプトインフラグを URLSessionConfiguration に追加し、あわせて新スタックで動かないか古くなった機能を deprecated にします。

新ローダへのオプトイン

URLSessionConfiguration に新しいプロパティ usesClassicLoadingMode が追加されます。名前のとおり「従来のローダを使うか」を表すフラグで、デフォルトは true です。false を指定すると、Network framework ベースの新しい HTTP ローダが利用されます。

open class URLSessionConfiguration {

    /* Uses the classic network loader */
    @available(*, unavailable, message: "Not available on non-Darwin platforms")
    open var usesClassicLoadingMode: Bool
}

このフラグは現状 Darwin プラットフォームでのみ利用可能で、非 Darwin プラットフォームでは利用できません。デフォルト値は当面 true のままですが、将来の OS でデフォルトが false に切り替わる可能性があります。

このため、新しい挙動を試したい場合は URLSessionConfiguration を作って usesClassicLoadingMode = false にすることになります。

let config = URLSessionConfiguration.default
config.usesClassicLoadingMode = false
let session = URLSession(configuration: config)

deprecated になる機能

新スタックでサポートされない機能や、すでに有名無実化していた API が deprecated になります。Swift 6.1 以降のコンパイラで deprecation 警告が出ます。

• FTP: 旧スタックでもすでに deprecated で、新スタックではサポートされません。NSURLProtectionSpaceFTP と NSURLProtectionSpaceFTPProxy が deprecated になります。
• HTTP/1 pipelining: 新 HTTP スタックではサポートされません。旧スタックでもデフォルトで無効で、サーバとの互換性問題も知られていました。URLRequest・NSURLRequest・NSMutableURLRequest・URLSessionConfiguration の httpShouldUsePipelining がそれぞれ deprecated になります。
• Server push: HTTP/2 の server push は採用率の低さと web 互換性の問題から、iOS 17 以降はどちらのスタックでも無効化されています。URLSessionTaskMetrics.ResourceFetchType.serverPush ケースが deprecated になります。
• NSURLErrorFailingURLStringErrorKey: 同等の NSURLErrorFailingURLErrorKey があり、こちらは WHATWG URL とも互換性があります。URLError.failureURLString プロパティと、定数 NSURLErrorFailingURLStringErrorKey の両方が deprecated になります。
• shouldUseExtendedBackgroundIdleMode: 旧スタックでも新スタックでもサポートされていませんでした。URLSessionConfiguration.shouldUseExtendedBackgroundIdleMode が deprecated になります。

これらは Swift 6.1 で @available(swift, deprecated: 6.1, ...) のかたちで deprecated にされます。差し替え方針はメッセージで案内されており、たとえば HTTP/1 pipelining については「HTTP/2 や HTTP/3 を採用してください」、failureURLString については「failingURL を使ってください」といったかたちです。