AsyncProps
async-auto-upload Boolean
By default, the selected files are uploaded immediately. To avoid the automatic upload of selected files, set async-auto-upload
to false
.
async-batch Boolean
By default and if supported by the browser, the selected files are uploaded in separate requests. To avoid the upload of selected files in separate requests, set async-batch
to true
. As a result, all selected files are uploaded in one request. The batch mode applies to multiple files which are selected simultaneously. Files that are selected one after the other are uploaded in separate requests.
async-chunk-size Number
When async-chunk-size
is set, the selected files are uploaded chunk by chunk with the declared size. Each request sends a separate file blob and additional string metadata to the server.
The string metadata that is sent to the server is in a stringified JSON format and contains the following properties:
fileName
relativePath
chunkIndex
contentType
totalFileSize
totalChunks
uploadUid
These properties enable the validation and combination of the file on the server side. The response also returns a JSON object with the uploaded and fileUid
properties and notifies the client what the next chunk is.
async-concurrent Boolean
By default, the selected files are uploaded one after the other. When async-concurrent
is set to true
, all selected files start to upload simultaneously.
async-auto-retry-after Number
If async-auto-retry-after
is set, the failed upload request is repeated after the declared amount of time (in milliseconds).
async-max-auto-retries Number
The maximum number of attempts that are performed if an upload fails.
async-remove-field String
The name of the form
field that is submitted to removeUrl
.
async-remove-url String
The URL of the handler which is responsible for the removal of the uploaded files (if any). The handler must accept POST
requests with one or more fileNames
fields which specify the files that will be deleted.
async-remove-verb String
The HTTP verb that will be used by the remove
action.
async-save-field String
The name of the form
field which is submitted to saveUrl
. Defaults to the input name.
async-save-url String
The URL of the handler that will receive the submitted files. The handler must accept POST
requests which contain one or more fields with the same name as the original input name.
async-use-array-buffer Boolean
By default, the files are uploaded as file data. When async-use-array-buffer
is set to true
, the files are read as a file buffer by using FileReader
. This buffer is sent in the request body.
async-with-credentials Boolean
Controls whether to send credentials (cookies, headers) for cross-site requests.