Struct UploadTask 

pub struct UploadTask { /* private fields */ }

Stateful helper that mirrors the Firebase Web SDK’s resumable upload behaviour.

A task is created via StorageReference::upload_bytes_resumable and can then be polled chunk-by-chunk (upload_next) or allowed to run to completion (run_to_completion). Small payloads are uploaded with a single multipart request, whereas larger blobs utilise the resumable REST API.

Implementations

impl UploadTask

pub fn total_bytes(&self) -> u64

Returns the total number of bytes that will be uploaded.

pub fn bytes_transferred(&self) -> u64

Returns the number of bytes that have been successfully uploaded so far.

pub fn state(&self) -> UploadTaskState

Current task state.

pub fn last_error(&self) -> Option<&StorageError>

Last error reported by the task, if any.

pub fn metadata(&self) -> Option<&ObjectMetadata>

Resulting object metadata after a successful upload.

pub fn upload_session_url(&self) -> Option<&str>

The resumable session URL, if one has been established.

pub fn upload_next_with_progress<F>( &mut self, progress: F, ) -> StorageResult<Option<ObjectMetadata>>

where F: FnMut(UploadProgress),

Uploads the next chunk and invokes the provided progress callback.

Returns Ok(Some(metadata)) when the upload finishes and the remote metadata is available.

pub fn upload_next(&mut self) -> StorageResult<Option<ObjectMetadata>>

Uploads the next chunk without emitting progress callbacks.

pub fn run_to_completion_with_progress<F>( self, progress: F, ) -> StorageResult<ObjectMetadata>

where F: FnMut(UploadProgress),

Runs the task to completion while notifying progress for each chunk.

pub fn run_to_completion(self) -> StorageResult<ObjectMetadata>

Runs the task to completion without progress callbacks.