Method Summary | |
---|---|
Boolean | cancel() Cancels the transfer process. |
Number | getCurrentBytesToTransfer() Returns the number of bytes to transfer for the current file. |
Number | getCurrentFileIndex() Returns the index of the current file being transferred. |
Number | getCurrentTransferredBytes() Returns the number of bytes already transferred for the current file. |
String | getCurrentTransferredFileName() Returns the name of the current file being transferred. |
Number | getTotalBytesToTransfer() Returns the total bytes to transfer to or from the server (sum of all the files size) |
Number | getTotalFilesToTransfer() Returns the total number of files to transfer. |
Number | getTotalTransferredBytes() Returns the total bytes already transferred (for all files) |
Boolean | isCanceled() Returns true if the process was canceled. |
Boolean | isFinished() Returns true if the process is finished. |
JSProgressMonitor | setProgressCallBack(function, interval) Sets a method to be called repeatedly at the given interval (in seconds), the method will receive an instance of this JSProgressMonitor updated with the latest values. |
JSProgressMonitor | setProgressCallBack(function, interval, delay) Sets a method to be called repeatedly at the given interval (in seconds), the method will receive an instance of this JSProgressMonitor updated with the latest values. |
Method Details | |
---|---|
cancel |
|
Boolean cancel () | |
Cancels the transfer process.
|
|
Returns |
|
Sample monitor.cancel(); |
|
getCurrentBytesToTransfer |
|
Number getCurrentBytesToTransfer () | |
Returns the number of bytes to transfer for the current file.
|
|
Returns |
|
Sample application.output('total transferred: ' + monitor.getTotalTransferredBytes() + ' / ' + monitor.getTotalBytesToTransfer()); application.output('current file: ' + monitor.getCurrentTransferredFileName() + ' ( ' + monitor.getCurrentFileIndex() + ' / ' + monitor.getTotalFilesToTransfer() + ' )'); application.output('current bytes transferred: '+monitor.getCurrentTransferredBytes() + ' / ' + monitor.getCurrentBytesToTransfer()); if (monitor.isCanceled()) { application.output('canceled!') } if (monitor.isFinished()) { application.output('finished!') } |
|
getCurrentFileIndex |
|
Number getCurrentFileIndex () | |
Returns the index of the current file being transferred.
|
|
Returns |
|
Sample application.output('total transferred: ' + monitor.getTotalTransferredBytes() + ' / ' + monitor.getTotalBytesToTransfer()); application.output('current file: ' + monitor.getCurrentTransferredFileName() + ' ( ' + monitor.getCurrentFileIndex() + ' / ' + monitor.getTotalFilesToTransfer() + ' )'); application.output('current bytes transferred: '+monitor.getCurrentTransferredBytes() + ' / ' + monitor.getCurrentBytesToTransfer()); if (monitor.isCanceled()) { application.output('canceled!') } if (monitor.isFinished()) { application.output('finished!') } |
|
getCurrentTransferredBytes |
|
Number getCurrentTransferredBytes () | |
Returns the number of bytes already transferred for the current file.
|
|
Returns |
|
Sample application.output('total transferred: ' + monitor.getTotalTransferredBytes() + ' / ' + monitor.getTotalBytesToTransfer()); application.output('current file: ' + monitor.getCurrentTransferredFileName() + ' ( ' + monitor.getCurrentFileIndex() + ' / ' + monitor.getTotalFilesToTransfer() + ' )'); application.output('current bytes transferred: '+monitor.getCurrentTransferredBytes() + ' / ' + monitor.getCurrentBytesToTransfer()); if (monitor.isCanceled()) { application.output('canceled!') } if (monitor.isFinished()) { application.output('finished!') } |
|
getCurrentTransferredFileName |
|
String getCurrentTransferredFileName () | |
Returns the name of the current file being transferred.
|
|
Returns |
|
Sample application.output('total transferred: ' + monitor.getTotalTransferredBytes() + ' / ' + monitor.getTotalBytesToTransfer()); application.output('current file: ' + monitor.getCurrentTransferredFileName() + ' ( ' + monitor.getCurrentFileIndex() + ' / ' + monitor.getTotalFilesToTransfer() + ' )'); application.output('current bytes transferred: '+monitor.getCurrentTransferredBytes() + ' / ' + monitor.getCurrentBytesToTransfer()); if (monitor.isCanceled()) { application.output('canceled!') } if (monitor.isFinished()) { application.output('finished!') } |
|
getTotalBytesToTransfer |
|
Number getTotalBytesToTransfer () | |
Returns the total bytes to transfer to or from the server (sum of all the files size)
|
|
Returns |
|
Sample application.output('total transferred: ' + monitor.getTotalTransferredBytes() + ' / ' + monitor.getTotalBytesToTransfer()); application.output('current file: ' + monitor.getCurrentTransferredFileName() + ' ( ' + monitor.getCurrentFileIndex() + ' / ' + monitor.getTotalFilesToTransfer() + ' )'); application.output('current bytes transferred: '+monitor.getCurrentTransferredBytes() + ' / ' + monitor.getCurrentBytesToTransfer()); if (monitor.isCanceled()) { application.output('canceled!') } if (monitor.isFinished()) { application.output('finished!') } |
|
getTotalFilesToTransfer |
|
Number getTotalFilesToTransfer () | |
Returns the total number of files to transfer.
|
|
Returns |
|
Sample application.output('total transferred: ' + monitor.getTotalTransferredBytes() + ' / ' + monitor.getTotalBytesToTransfer()); application.output('current file: ' + monitor.getCurrentTransferredFileName() + ' ( ' + monitor.getCurrentFileIndex() + ' / ' + monitor.getTotalFilesToTransfer() + ' )'); application.output('current bytes transferred: '+monitor.getCurrentTransferredBytes() + ' / ' + monitor.getCurrentBytesToTransfer()); if (monitor.isCanceled()) { application.output('canceled!') } if (monitor.isFinished()) { application.output('finished!') } |
|
getTotalTransferredBytes |
|
Number getTotalTransferredBytes () | |
Returns the total bytes already transferred (for all files)
|
|
Returns |
|
Sample application.output('total transferred: ' + monitor.getTotalTransferredBytes() + ' / ' + monitor.getTotalBytesToTransfer()); application.output('current file: ' + monitor.getCurrentTransferredFileName() + ' ( ' + monitor.getCurrentFileIndex() + ' / ' + monitor.getTotalFilesToTransfer() + ' )'); application.output('current bytes transferred: '+monitor.getCurrentTransferredBytes() + ' / ' + monitor.getCurrentBytesToTransfer()); if (monitor.isCanceled()) { application.output('canceled!') } if (monitor.isFinished()) { application.output('finished!') } |
|
isCanceled |
|
Boolean isCanceled () | |
Returns true if the process was canceled.
|
|
Returns |
|
Sample application.output('total transferred: ' + monitor.getTotalTransferredBytes() + ' / ' + monitor.getTotalBytesToTransfer()); application.output('current file: ' + monitor.getCurrentTransferredFileName() + ' ( ' + monitor.getCurrentFileIndex() + ' / ' + monitor.getTotalFilesToTransfer() + ' )'); application.output('current bytes transferred: '+monitor.getCurrentTransferredBytes() + ' / ' + monitor.getCurrentBytesToTransfer()); if (monitor.isCanceled()) { application.output('canceled!') } if (monitor.isFinished()) { application.output('finished!') } |
|
isFinished |
|
Boolean isFinished () | |
Returns true if the process is finished.
|
|
Returns |
|
Sample application.output('total transferred: ' + monitor.getTotalTransferredBytes() + ' / ' + monitor.getTotalBytesToTransfer()); application.output('current file: ' + monitor.getCurrentTransferredFileName() + ' ( ' + monitor.getCurrentFileIndex() + ' / ' + monitor.getTotalFilesToTransfer() + ' )'); application.output('current bytes transferred: '+monitor.getCurrentTransferredBytes() + ' / ' + monitor.getCurrentBytesToTransfer()); if (monitor.isCanceled()) { application.output('canceled!') } if (monitor.isFinished()) { application.output('finished!') } |
|
setProgressCallBack |
|
JSProgressMonitor setProgressCallBack (function, interval) | |
Sets a method to be called repeatedly at the given interval (in seconds), the method will receive an instance of this JSProgressMonitor updated with the latest values. Can use an optional delay (for testing purpose in developer).
|
|
Parameters |
|
Returns JSProgressMonitor - this for chaining
|
|
Sample // call the progressCallbackFuntion every 2 and a half seconds (with a delay of 200ms in developer): monitor.setProgressCallBack(progressCallbackFunction, 2.5, (application.isInDeveloper() ? 200 : 0)); |
|
setProgressCallBack |
|
JSProgressMonitor setProgressCallBack (function, interval, delay) | |
Sets a method to be called repeatedly at the given interval (in seconds), the method will receive an instance of this JSProgressMonitor updated with the latest values. Can use an optional delay (for testing purpose in developer).
|
|
Parameters |
|
Returns JSProgressMonitor - this for chaining
|
|
Sample // call the progressCallbackFuntion every 2 and a half seconds (with a delay of 200ms in developer): monitor.setProgressCallBack(progressCallbackFunction, 2.5, (application.isInDeveloper() ? 200 : 0)); |
|