1. ActiveX/Java Uploader 8.5.81
  2. ActiveX/Java Uploader
  3. Reference
  4. ActiveX/Java Uploader JavaScript Reference
  5. $au Namespace ActiveX/Java Uploader JavaScript
  6. uploadSettings Class ActiveX/Java Uploader JavaScript
  7. uploadSettings Properties ActiveX/Java Uploader JavaScript

uploadSettings.chunkSize Property ActiveX/Java Uploader JavaScript

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, ActiveX/Java 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, ActiveX/Java 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 ActiveX/Java Uploader ASP.NET or ActiveX/Java 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