Instance Method インスタンスメソッド

bytes(for:delegate:)

Retrieves the contents of a URL based on the specified URL request and delivers an asynchronous sequence of bytes.

Declaration 宣言 

func bytes(for request: URLRequest, delegate: URLSessionTaskDelegate? = nil) async throws -> (URLSession.AsyncBytes, URLResponse)

Parameters パラメータ

request

A URL request object that provides request-specific information such as the URL, cache policy, request type, and body data or body stream. リクエスト特有の情報、たとえばURL、キャッシュ方針、リクエスト型、ボディデータまたはボディストリーム、などを提供するURLリクエストオブジェクト。

delegate

A delegate that receives life cycle and authentication challenge callbacks as the transfer progresses.

Return Value 戻り値

An asynchronously-delivered tuple that contains a URLSession.AsyncBytes sequence to iterate over, and a URLResponse.

Discussion 議論

Use this method when you want to process the bytes while the transfer is underway. You can use a for-await-in loop to handle each byte. For textual data, use the URLSession.AsyncBytes properties characters, unicodeScalars, or lines to receive the content as asynchronous sequences of those types.

To wait until the session finishes transferring data and receive it in a single Data instance, use data(for:delegate:).

See Also 参照

Performing Asynchronous Transfers 非同期転送を実行する

func bytes(from: URL, delegate: URLSessionTaskDelegate?) -> (URLSession.AsyncBytes, URLResponse)
Retrieves the contents of a given URL and delivers an asynchronous sequence of bytes.
struct URLSession.AsyncBytes
An asynchronous sequence of bytes. バイトいくつかからなるある非同期シーケンス。
func data(for: URLRequest, delegate: URLSessionTaskDelegate?) -> (Data, URLResponse)
Downloads the contents of a URL based on the specified URL request and delivers the data asynchronously.
func data(from: URL, delegate: URLSessionTaskDelegate?) -> (Data, URLResponse)
Retrieves the contents of a URL and delivers the data asynchronously.
func download(for: URLRequest, delegate: URLSessionTaskDelegate?) -> (URL, URLResponse)
Retrieves the contents of a URL based on the specified URL request and delivers the URL of the saved file asynchronously.
func download(from: URL, delegate: URLSessionTaskDelegate?) -> (URL, URLResponse)
Retrieves the contents of a URL and delivers the URL of the saved file asynchronously.
func download(resumeFrom: Data, delegate: URLSessionTaskDelegate?) -> (URL, URLResponse)
Resumes a previously-paused download and delivers the URL of the saved file asynchronously.
func upload(for: URLRequest, from: Data, delegate: URLSessionTaskDelegate?) -> (Data, URLResponse)
Uploads data to a URL based on the specified URL request and delivers the result asynchronously.
func upload(for: URLRequest, fromFile: URL, delegate: URLSessionTaskDelegate?) -> (Data, URLResponse)
Uploads data to a URL and delivers the result asynchronously.
protocol URLSessionTaskDelegate
A protocol that defines methods that URL session instances call on their delegates to handle task-level events. あるプロトコル、それはいくつかのメソッドを定義します、それらはURLセッションインスタンスがそれらの委任先上で呼び出してタスク水準イベントを取り扱うものです。