LocalFile Property

The path to a local file for uploading or downloading. When downloading, if the file exists it is overwritten (optional).

Syntax

 amazons3.getLocalFile([callback])
 amazons3.setLocalFile( localFile, [callback])

Default Value

""

Callback

The 'callback' parameter specifies a function which will be called when the operation completes (or an error is encountered). If the 'callback' parameter is not specified, then the method will block and will not return until the operation completes (or an error is encountered).

The callback for the getLocalFile([callback]) method is defined as:

function(err, data){ }

'err' is the error that occurred. If there was no error, then 'err' is 'null'.

'data' is the value returned by the method.

The callback for the setLocalFile([callback]) method is defined as:

function(err){ }

'err' is the error that occurred. If there was no error, then 'err' is 'null'.

'err' has 2 properties which hold detailed information:

err.code
err.message

Remarks

The LocalFile property is used when getting a document via GetObject or putting a document via CreateObject.

If LocalFile is empty then the data to be sent or received is provided via the ObjectData property.

Data Type

String