Documentation menu

Event Handlers

React events mirror core upload state.

tsx
<UpupUploader
    uploadEndpoint="/api/upload-token"
    onFilesSelected={files => console.log(files)}
    onUploadStart={() => console.log('started')}
    onFileUploadComplete={file => console.log(file)}
    onUploadComplete={files => console.log(files)}
    onError={message => console.error(message)}
/>

Common handlers:

HandlerCalled when
onFilesSelectedFiles enter core state.
onFileRemovedA file is removed.
onUploadStartUpload begins.
onFileUploadProgressByte progress changes for one file.
onFilesUploadProgressAggregate byte progress across the batch.
onFileUploadCompleteOne file succeeds.
onUploadCompleteAll files succeed.
onErrorA validation, config, network, or provider failure occurs; delivers a message string.

File objects use the UploadFile contract from @upupjs/core/contracts.