This documentation is for the old version. Go to the latest Upload Suite docs

uploadSettings.chunkSize Property

Supported browsers: Internet ExplorerFirefoxGoogle ChromeSafari

Gets or sets a maximium allowed size of binary data (in bytes) uploaded within a POST request.

Syntax

JavaScript Initialize
$au.uploader({
    uploadSettings: {
        //...other params...
        chunkSize: 0,
        //...other params...
    }
})
Get/Set Value at Runtime
$au.uploader('uploaderID').uploadSettings().chunkSize(value);
value = $au.uploader('uploaderID').uploadSettings().chunkSize();

Property Value

Type: Number

The number of bytes allowed to upload within a request. When this value is 0, converted file uploaded entirely in accordiance with filesPerPackage and uploadConverterOutputSeparately properties.

Default value is 0.

Remarks

When this property is greater than 0, Image Uploader adds converted files and metadata to a POST request until the request length exceeds chunkSize + metadata size bytes. If the last added file does not meet the chunk size limitation, Image Uploader adds just a portion of this file to complete this chunk. The remaining portion will be added at the beginning of the next chunk. Each chunk is submitted to a server as a separate request. It gives a number of benefits: makes each request compartible with maximum POST request length limitation and allows resuming partially uploaded files.

Note

When you turn this mode on, it is highly recommended to use Image Uploader ASP.NET or Image Uploader PHP to handle upload on the server side. Both these wrappers automatically bundle pieces of one file, uploaded in separated chunks, and provide an access to this file as if it was uploaded entirely.

See Also

Reference

Manual