Skip to content

Chunked and resumable file uploads in the browser ​

A chunked upload cuts a file into pieces and sends each piece in its own request. A resumable upload remembers which pieces the server already has, so after a failure only the missing ones are sent. AnyDrop does both, in the browser, with no dependencies in its core.

How it works ​

  1. The file is read with Blob.slice(), one chunk per request, so the whole file never sits in memory.
  2. Each chunk is a multipart/form-data POST that carries the chunk in file and the chunk fields (adUploadId, adChunkIndex, adChunkCount, adChunkSize, adChunkOffset, adTotalSize).
  3. A failed chunk is retried with growing, randomised delays (up to 3 times by default, honouring Retry-After).
  4. After the last chunk, AnyDrop calls your finalize endpoint so the server can assemble the file.
  5. To resume, the client asks your status endpoint which chunks the server holds, and sends only the others.

Turn it on ​

js
import { AnyDrop } from '@vedratech/anydrop-ui';
import '@vedratech/anydrop-ui/style.css';

new AnyDrop('#uploader', {
  url: '/upload',
  chunking: true,
  chunkSize: 5 * 1024 * 1024, // bytes; default is 2 MiB
  parallelChunkUploads: 3, // chunks of one file in flight
  chunkStatusUrl: '/upload/status', // resume: the server's answer wins
  finalizeUrl: '/upload/finalize', // assemble after the last chunk
});

Files up to chunkSize are sent whole unless you set forceChunking: true.

What resumes, and when ​

SituationWhat happens
A chunk request fails (network, timeout, 5xx, 429)Only that chunk is retried.
The user pausesThe upload continues later from the last acknowledged chunk. See Pause and resume uploads.
The connection dropsUploads pause by themselves and continue on reconnect. See uploads that survive a lost connection.
The tab is closed or the page reloadsProgress is saved in IndexedDB. The user drops the same files again and only missing chunks are sent. A web page cannot read files from disk by itself, so this step cannot be skipped. See Resume after reload.

What your backend must do ​

Accept chunks in any order and more than once (writing the same chunk again is harmless), answer a status request with { "received": [0, 1, 4] }, and assemble the file on finalize. The full contract is in the protocol, with working Express, Laravel, Python and Java examples (see also Chunked upload backend (Express, Laravel, Python, Java)).

Not a tus or S3 client ​

AnyDrop speaks its own small HTTP contract, not the tus protocol. If you need tus or presigned S3 uploads, a custom transport lets you keep AnyDrop's queue, pause, resume and UI while you control the requests.

Released under the MIT License.