Initialize the UI code
[holmes/rule-management.git] / rulemgt / src / main / frontend / src / public / common / js / jQuery-File-Upload / js / jquery.fileupload.js
1 /*
2  * jQuery File Upload Plugin
3  * https://github.com/blueimp/jQuery-File-Upload
4  *
5  * Copyright 2010, Sebastian Tschan
6  * https://blueimp.net
7  *
8  * Licensed under the MIT license:
9  * http://www.opensource.org/licenses/MIT
10  */
11
12 /* jshint nomen:false */
13 /* global define, require, window, document, location, Blob, FormData */
14
15 (function (factory) {
16     'use strict';
17     if (typeof define === 'function' && define.amd) {
18         // Register as an anonymous AMD module:
19         define([
20             './jquery',
21             './jquery.ui.widget'
22         ], factory);
23     } else if (typeof exports === 'object') {
24         // Node/CommonJS:
25         factory(
26             require('jquery'),
27             require('./vendor/jquery.ui.widget')
28         );
29     } else {
30         // Browser globals:
31         factory(window.jQuery);
32     }
33 }(function ($) {
34     'use strict';
35
36     // Detect file input support, based on
37     // http://viljamis.com/blog/2012/file-upload-support-on-mobile/
38     $.support.fileInput = !(new RegExp(
39         // Handle devices which give false positives for the feature detection:
40         '(Android (1\\.[0156]|2\\.[01]))' +
41         '|(Windows Phone (OS 7|8\\.0))|(XBLWP)|(ZuneWP)|(WPDesktop)' +
42         '|(w(eb)?OSBrowser)|(webOS)' +
43         '|(Kindle/(1\\.0|2\\.[05]|3\\.0))'
44     ).test(window.navigator.userAgent) ||
45         // Feature detection for all other devices:
46     $('<input type="file">').prop('disabled'));
47
48     // The FileReader API is not actually used, but works as feature detection,
49     // as some Safari versions (5?) support XHR file uploads via the FormData API,
50     // but not non-multipart XHR file uploads.
51     // window.XMLHttpRequestUpload is not available on IE10, so we check for
52     // window.ProgressEvent instead to detect XHR2 file upload capability:
53     $.support.xhrFileUpload = !!(window.ProgressEvent && window.FileReader);
54     $.support.xhrFormDataFileUpload = !!window.FormData;
55
56     // Detect support for Blob slicing (required for chunked uploads):
57     $.support.blobSlice = window.Blob && (Blob.prototype.slice ||
58         Blob.prototype.webkitSlice || Blob.prototype.mozSlice);
59
60     // Helper function to create drag handlers for dragover/dragenter/dragleave:
61     function getDragHandler(type) {
62         var isDragOver = type === 'dragover';
63         return function (e) {
64             e.dataTransfer = e.originalEvent && e.originalEvent.dataTransfer;
65             var dataTransfer = e.dataTransfer;
66             if (dataTransfer && $.inArray('Files', dataTransfer.types) !== -1 &&
67                 this._trigger(
68                     type,
69                     $.Event(type, {delegatedEvent: e})
70                 ) !== false) {
71                 e.preventDefault();
72                 if (isDragOver) {
73                     dataTransfer.dropEffect = 'copy';
74                 }
75             }
76         };
77     }
78
79     // The fileupload widget listens for change events on file input fields defined
80     // via fileInput setting and paste or drop events of the given dropZone.
81     // In addition to the default jQuery Widget methods, the fileupload widget
82     // exposes the "add" and "send" methods, to add or directly send files using
83     // the fileupload API.
84     // By default, files added via file input selection, paste, drag & drop or
85     // "add" method are uploaded immediately, but it is possible to override
86     // the "add" callback option to queue file uploads.
87     $.widget('blueimp.fileupload', {
88
89         options: {
90             // The drop target element(s), by the default the complete document.
91             // Set to null to disable drag & drop support:
92             dropZone: $(document),
93             // The paste target element(s), by the default undefined.
94             // Set to a DOM node or jQuery object to enable file pasting:
95             pasteZone: undefined,
96             // The file input field(s), that are listened to for change events.
97             // If undefined, it is set to the file input fields inside
98             // of the widget element on plugin initialization.
99             // Set to null to disable the change listener.
100             fileInput: undefined,
101             // By default, the file input field is replaced with a clone after
102             // each input field change event. This is required for iframe transport
103             // queues and allows change events to be fired for the same file
104             // selection, but can be disabled by setting the following option to false:
105             replaceFileInput: true,
106             // The parameter name for the file form data (the request argument name).
107             // If undefined or empty, the name property of the file input field is
108             // used, or "files[]" if the file input name property is also empty,
109             // can be a string or an array of strings:
110             paramName: undefined,
111             // By default, each file of a selection is uploaded using an individual
112             // request for XHR type uploads. Set to false to upload file
113             // selections in one request each:
114             singleFileUploads: true,
115             // To limit the number of files uploaded with one XHR request,
116             // set the following option to an integer greater than 0:
117             limitMultiFileUploads: undefined,
118             // The following option limits the number of files uploaded with one
119             // XHR request to keep the request size under or equal to the defined
120             // limit in bytes:
121             limitMultiFileUploadSize: undefined,
122             // Multipart file uploads add a number of bytes to each uploaded file,
123             // therefore the following option adds an overhead for each file used
124             // in the limitMultiFileUploadSize configuration:
125             limitMultiFileUploadSizeOverhead: 512,
126             // Set the following option to true to issue all file upload requests
127             // in a sequential order:
128             sequentialUploads: false,
129             // To limit the number of concurrent uploads,
130             // set the following option to an integer greater than 0:
131             limitConcurrentUploads: undefined,
132             // Set the following option to true to force iframe transport uploads:
133             forceIframeTransport: false,
134             // Set the following option to the location of a redirect url on the
135             // origin server, for cross-domain iframe transport uploads:
136             redirect: undefined,
137             // The parameter name for the redirect url, sent as part of the form
138             // data and set to 'redirect' if this option is empty:
139             redirectParamName: undefined,
140             // Set the following option to the location of a postMessage window,
141             // to enable postMessage transport uploads:
142             postMessage: undefined,
143             // By default, XHR file uploads are sent as multipart/form-data.
144             // The iframe transport is always using multipart/form-data.
145             // Set to false to enable non-multipart XHR uploads:
146             multipart: true,
147             // To upload large files in smaller chunks, set the following option
148             // to a preferred maximum chunk size. If set to 0, null or undefined,
149             // or the browser does not support the required Blob API, files will
150             // be uploaded as a whole.
151             maxChunkSize: undefined,
152             // When a non-multipart upload or a chunked multipart upload has been
153             // aborted, this option can be used to resume the upload by setting
154             // it to the size of the already uploaded bytes. This option is most
155             // useful when modifying the options object inside of the "add" or
156             // "send" callbacks, as the options are cloned for each file upload.
157             uploadedBytes: undefined,
158             // By default, failed (abort or error) file uploads are removed from the
159             // global progress calculation. Set the following option to false to
160             // prevent recalculating the global progress data:
161             recalculateProgress: true,
162             // Interval in milliseconds to calculate and trigger progress events:
163             progressInterval: 100,
164             // Interval in milliseconds to calculate progress bitrate:
165             bitrateInterval: 500,
166             // By default, uploads are started automatically when adding files:
167             autoUpload: true,
168
169             // Error and info messages:
170             messages: {
171                 uploadedBytes: 'Uploaded bytes exceed file size'
172             },
173
174             // Translation function, gets the message key to be translated
175             // and an object with context specific data as arguments:
176             i18n: function (message, context) {
177                 message = this.messages[message] || message.toString();
178                 if (context) {
179                     $.each(context, function (key, value) {
180                         message = message.replace('{' + key + '}', value);
181                     });
182                 }
183                 return message;
184             },
185
186             // Additional form data to be sent along with the file uploads can be set
187             // using this option, which accepts an array of objects with name and
188             // value properties, a function returning such an array, a FormData
189             // object (for XHR file uploads), or a simple object.
190             // The form of the first fileInput is given as parameter to the function:
191             formData: function (form) {
192                 return form.serializeArray();
193             },
194
195             // The add callback is invoked as soon as files are added to the fileupload
196             // widget (via file input selection, drag & drop, paste or add API call).
197             // If the singleFileUploads option is enabled, this callback will be
198             // called once for each file in the selection for XHR file uploads, else
199             // once for each file selection.
200             //
201             // The upload starts when the submit method is invoked on the data parameter.
202             // The data object contains a files property holding the added files
203             // and allows you to override plugin options as well as define ajax settings.
204             //
205             // Listeners for this callback can also be bound the following way:
206             // .bind('fileuploadadd', func);
207             //
208             // data.submit() returns a Promise object and allows to attach additional
209             // handlers using jQuery's Deferred callbacks:
210             // data.submit().done(func).fail(func).always(func);
211             add: function (e, data) {
212                 if (e.isDefaultPrevented()) {
213                     return false;
214                 }
215                 if (data.autoUpload || (data.autoUpload !== false &&
216                     $(this).fileupload('option', 'autoUpload'))) {
217                     data.process().done(function () {
218                         data.submit();
219                     });
220                 }
221             },
222
223             // Other callbacks:
224
225             // Callback for the submit event of each file upload:
226             // submit: function (e, data) {}, // .bind('fileuploadsubmit', func);
227
228             // Callback for the start of each file upload request:
229             // send: function (e, data) {}, // .bind('fileuploadsend', func);
230
231             // Callback for successful uploads:
232             // done: function (e, data) {}, // .bind('fileuploaddone', func);
233
234             // Callback for failed (abort or error) uploads:
235             // fail: function (e, data) {}, // .bind('fileuploadfail', func);
236
237             // Callback for completed (success, abort or error) requests:
238             // always: function (e, data) {}, // .bind('fileuploadalways', func);
239
240             // Callback for upload progress events:
241             // progress: function (e, data) {}, // .bind('fileuploadprogress', func);
242
243             // Callback for global upload progress events:
244             // progressall: function (e, data) {}, // .bind('fileuploadprogressall', func);
245
246             // Callback for uploads start, equivalent to the global ajaxStart event:
247             // start: function (e) {}, // .bind('fileuploadstart', func);
248
249             // Callback for uploads stop, equivalent to the global ajaxStop event:
250             // stop: function (e) {}, // .bind('fileuploadstop', func);
251
252             // Callback for change events of the fileInput(s):
253             // change: function (e, data) {}, // .bind('fileuploadchange', func);
254
255             // Callback for paste events to the pasteZone(s):
256             // paste: function (e, data) {}, // .bind('fileuploadpaste', func);
257
258             // Callback for drop events of the dropZone(s):
259             // drop: function (e, data) {}, // .bind('fileuploaddrop', func);
260
261             // Callback for dragover events of the dropZone(s):
262             // dragover: function (e) {}, // .bind('fileuploaddragover', func);
263
264             // Callback for the start of each chunk upload request:
265             // chunksend: function (e, data) {}, // .bind('fileuploadchunksend', func);
266
267             // Callback for successful chunk uploads:
268             // chunkdone: function (e, data) {}, // .bind('fileuploadchunkdone', func);
269
270             // Callback for failed (abort or error) chunk uploads:
271             // chunkfail: function (e, data) {}, // .bind('fileuploadchunkfail', func);
272
273             // Callback for completed (success, abort or error) chunk upload requests:
274             // chunkalways: function (e, data) {}, // .bind('fileuploadchunkalways', func);
275
276             // The plugin options are used as settings object for the ajax calls.
277             // The following are jQuery ajax settings required for the file uploads:
278             processData: false,
279             contentType: false,
280             cache: false,
281             timeout: 0
282         },
283
284         // A list of options that require reinitializing event listeners and/or
285         // special initialization code:
286         _specialOptions: [
287             'fileInput',
288             'dropZone',
289             'pasteZone',
290             'multipart',
291             'forceIframeTransport'
292         ],
293
294         _blobSlice: $.support.blobSlice && function () {
295             var slice = this.slice || this.webkitSlice || this.mozSlice;
296             return slice.apply(this, arguments);
297         },
298
299         _BitrateTimer: function () {
300             this.timestamp = ((Date.now) ? Date.now() : (new Date()).getTime());
301             this.loaded = 0;
302             this.bitrate = 0;
303             this.getBitrate = function (now, loaded, interval) {
304                 var timeDiff = now - this.timestamp;
305                 if (!this.bitrate || !interval || timeDiff > interval) {
306                     this.bitrate = (loaded - this.loaded) * (1000 / timeDiff) * 8;
307                     this.loaded = loaded;
308                     this.timestamp = now;
309                 }
310                 return this.bitrate;
311             };
312         },
313
314         _isXHRUpload: function (options) {
315             return !options.forceIframeTransport &&
316                 ((!options.multipart && $.support.xhrFileUpload) ||
317                 $.support.xhrFormDataFileUpload);
318         },
319
320         _getFormData: function (options) {
321             var formData;
322             if ($.type(options.formData) === 'function') {
323                 return options.formData(options.form);
324             }
325             if ($.isArray(options.formData)) {
326                 return options.formData;
327             }
328             if ($.type(options.formData) === 'object') {
329                 formData = [];
330                 $.each(options.formData, function (name, value) {
331                     formData.push({name: name, value: value});
332                 });
333                 return formData;
334             }
335             return [];
336         },
337
338         _getTotal: function (files) {
339             var total = 0;
340             $.each(files, function (index, file) {
341                 total += file.size || 1;
342             });
343             return total;
344         },
345
346         _initProgressObject: function (obj) {
347             var progress = {
348                 loaded: 0,
349                 total: 0,
350                 bitrate: 0
351             };
352             if (obj._progress) {
353                 $.extend(obj._progress, progress);
354             } else {
355                 obj._progress = progress;
356             }
357         },
358
359         _initResponseObject: function (obj) {
360             var prop;
361             if (obj._response) {
362                 for (prop in obj._response) {
363                     if (obj._response.hasOwnProperty(prop)) {
364                         delete obj._response[prop];
365                     }
366                 }
367             } else {
368                 obj._response = {};
369             }
370         },
371
372         _onProgress: function (e, data) {
373             if (e.lengthComputable) {
374                 var now = ((Date.now) ? Date.now() : (new Date()).getTime()),
375                     loaded;
376                 if (data._time && data.progressInterval &&
377                     (now - data._time < data.progressInterval) &&
378                     e.loaded !== e.total) {
379                     return;
380                 }
381                 data._time = now;
382                 loaded = Math.floor(
383                         e.loaded / e.total * (data.chunkSize || data._progress.total)
384                     ) + (data.uploadedBytes || 0);
385                 // Add the difference from the previously loaded state
386                 // to the global loaded counter:
387                 this._progress.loaded += (loaded - data._progress.loaded);
388                 this._progress.bitrate = this._bitrateTimer.getBitrate(
389                     now,
390                     this._progress.loaded,
391                     data.bitrateInterval
392                 );
393                 data._progress.loaded = data.loaded = loaded;
394                 data._progress.bitrate = data.bitrate = data._bitrateTimer.getBitrate(
395                     now,
396                     loaded,
397                     data.bitrateInterval
398                 );
399                 // Trigger a custom progress event with a total data property set
400                 // to the file size(s) of the current upload and a loaded data
401                 // property calculated accordingly:
402                 this._trigger(
403                     'progress',
404                     $.Event('progress', {delegatedEvent: e}),
405                     data
406                 );
407                 // Trigger a global progress event for all current file uploads,
408                 // including ajax calls queued for sequential file uploads:
409                 this._trigger(
410                     'progressall',
411                     $.Event('progressall', {delegatedEvent: e}),
412                     this._progress
413                 );
414             }
415         },
416
417         _initProgressListener: function (options) {
418             var that = this,
419                 xhr = options.xhr ? options.xhr() : $.ajaxSettings.xhr();
420             // Accesss to the native XHR object is required to add event listeners
421             // for the upload progress event:
422             if (xhr.upload) {
423                 $(xhr.upload).bind('progress', function (e) {
424                     var oe = e.originalEvent;
425                     // Make sure the progress event properties get copied over:
426                     e.lengthComputable = oe.lengthComputable;
427                     e.loaded = oe.loaded;
428                     e.total = oe.total;
429                     that._onProgress(e, options);
430                 });
431                 options.xhr = function () {
432                     return xhr;
433                 };
434             }
435         },
436
437         _isInstanceOf: function (type, obj) {
438             // Cross-frame instanceof check
439             return Object.prototype.toString.call(obj) === '[object ' + type + ']';
440         },
441
442         _initXHRData: function (options) {
443             var that = this,
444                 formData,
445                 file = options.files[0],
446             // Ignore non-multipart setting if not supported:
447                 multipart = options.multipart || !$.support.xhrFileUpload,
448                 paramName = $.type(options.paramName) === 'array' ?
449                     options.paramName[0] : options.paramName;
450             options.headers = $.extend({}, options.headers);
451             if (options.contentRange) {
452                 options.headers['Content-Range'] = options.contentRange;
453             }
454             if (!multipart || options.blob || !this._isInstanceOf('File', file)) {
455                 options.headers['Content-Disposition'] = 'attachment; filename="' +
456                     encodeURI(file.name) + '"';
457             }
458             if (!multipart) {
459                 options.contentType = file.type || 'application/octet-stream';
460                 options.data = options.blob || file;
461             } else if ($.support.xhrFormDataFileUpload) {
462                 if (options.postMessage) {
463                     // window.postMessage does not allow sending FormData
464                     // objects, so we just add the File/Blob objects to
465                     // the formData array and let the postMessage window
466                     // create the FormData object out of this array:
467                     formData = this._getFormData(options);
468                     if (options.blob) {
469                         formData.push({
470                             name: paramName,
471                             value: options.blob
472                         });
473                     } else {
474                         $.each(options.files, function (index, file) {
475                             formData.push({
476                                 name: ($.type(options.paramName) === 'array' &&
477                                 options.paramName[index]) || paramName,
478                                 value: file
479                             });
480                         });
481                     }
482                 } else {
483                     if (that._isInstanceOf('FormData', options.formData)) {
484                         formData = options.formData;
485                     } else {
486                         formData = new FormData();
487                         $.each(this._getFormData(options), function (index, field) {
488                             formData.append(field.name, field.value);
489                         });
490                     }
491                     if (options.blob) {
492                         formData.append(paramName, options.blob, file.name);
493                     } else {
494                         $.each(options.files, function (index, file) {
495                             // This check allows the tests to run with
496                             // dummy objects:
497                             if (that._isInstanceOf('File', file) ||
498                                 that._isInstanceOf('Blob', file)) {
499                                 formData.append(
500                                     ($.type(options.paramName) === 'array' &&
501                                     options.paramName[index]) || paramName,
502                                     file,
503                                     file.uploadName || file.name
504                                 );
505                             }
506                         });
507                     }
508                 }
509                 options.data = formData;
510             }
511             // Blob reference is not needed anymore, free memory:
512             options.blob = null;
513         },
514
515         _initIframeSettings: function (options) {
516             var targetHost = $('<a></a>').prop('href', options.url).prop('host');
517             // Setting the dataType to iframe enables the iframe transport:
518             options.dataType = 'iframe ' + (options.dataType || '');
519             // The iframe transport accepts a serialized array as form data:
520             options.formData = this._getFormData(options);
521             // Add redirect url to form data on cross-domain uploads:
522             if (options.redirect && targetHost && targetHost !== location.host) {
523                 options.formData.push({
524                     name: options.redirectParamName || 'redirect',
525                     value: options.redirect
526                 });
527             }
528         },
529
530         _initDataSettings: function (options) {
531             if (this._isXHRUpload(options)) {
532                 if (!this._chunkedUpload(options, true)) {
533                     if (!options.data) {
534                         this._initXHRData(options);
535                     }
536                     this._initProgressListener(options);
537                 }
538                 if (options.postMessage) {
539                     // Setting the dataType to postmessage enables the
540                     // postMessage transport:
541                     options.dataType = 'postmessage ' + (options.dataType || '');
542                 }
543             } else {
544                 this._initIframeSettings(options);
545             }
546         },
547
548         _getParamName: function (options) {
549             var fileInput = $(options.fileInput),
550                 paramName = options.paramName;
551             if (!paramName) {
552                 paramName = [];
553                 fileInput.each(function () {
554                     var input = $(this),
555                         name = input.prop('name') || 'files[]',
556                         i = (input.prop('files') || [1]).length;
557                     while (i) {
558                         paramName.push(name);
559                         i -= 1;
560                     }
561                 });
562                 if (!paramName.length) {
563                     paramName = [fileInput.prop('name') || 'files[]'];
564                 }
565             } else if (!$.isArray(paramName)) {
566                 paramName = [paramName];
567             }
568             return paramName;
569         },
570
571         _initFormSettings: function (options) {
572             // Retrieve missing options from the input field and the
573             // associated form, if available:
574             if (!options.form || !options.form.length) {
575                 options.form = $(options.fileInput.prop('form'));
576                 // If the given file input doesn't have an associated form,
577                 // use the default widget file input's form:
578                 if (!options.form.length) {
579                     options.form = $(this.options.fileInput.prop('form'));
580                 }
581             }
582             options.paramName = this._getParamName(options);
583             if (!options.url) {
584                 options.url = options.form.prop('action') || location.href;
585             }
586             // The HTTP request method must be "POST" or "PUT":
587             options.type = (options.type ||
588                 ($.type(options.form.prop('method')) === 'string' &&
589                 options.form.prop('method')) || ''
590             ).toUpperCase();
591             if (options.type !== 'POST' && options.type !== 'PUT' &&
592                 options.type !== 'PATCH') {
593                 options.type = 'POST';
594             }
595             if (!options.formAcceptCharset) {
596                 options.formAcceptCharset = options.form.attr('accept-charset');
597             }
598         },
599
600         _getAJAXSettings: function (data) {
601             var options = $.extend({}, this.options, data);
602             this._initFormSettings(options);
603             this._initDataSettings(options);
604             return options;
605         },
606
607         // jQuery 1.6 doesn't provide .state(),
608         // while jQuery 1.8+ removed .isRejected() and .isResolved():
609         _getDeferredState: function (deferred) {
610             if (deferred.state) {
611                 return deferred.state();
612             }
613             if (deferred.isResolved()) {
614                 return 'resolved';
615             }
616             if (deferred.isRejected()) {
617                 return 'rejected';
618             }
619             return 'pending';
620         },
621
622         // Maps jqXHR callbacks to the equivalent
623         // methods of the given Promise object:
624         _enhancePromise: function (promise) {
625             promise.success = promise.done;
626             promise.error = promise.fail;
627             promise.complete = promise.always;
628             return promise;
629         },
630
631         // Creates and returns a Promise object enhanced with
632         // the jqXHR methods abort, success, error and complete:
633         _getXHRPromise: function (resolveOrReject, context, args) {
634             var dfd = $.Deferred(),
635                 promise = dfd.promise();
636             context = context || this.options.context || promise;
637             if (resolveOrReject === true) {
638                 dfd.resolveWith(context, args);
639             } else if (resolveOrReject === false) {
640                 dfd.rejectWith(context, args);
641             }
642             promise.abort = dfd.promise;
643             return this._enhancePromise(promise);
644         },
645
646         // Adds convenience methods to the data callback argument:
647         _addConvenienceMethods: function (e, data) {
648             var that = this,
649                 getPromise = function (args) {
650                     return $.Deferred().resolveWith(that, args).promise();
651                 };
652             data.process = function (resolveFunc, rejectFunc) {
653                 if (resolveFunc || rejectFunc) {
654                     data._processQueue = this._processQueue =
655                         (this._processQueue || getPromise([this])).pipe(
656                             function () {
657                                 if (data.errorThrown) {
658                                     return $.Deferred()
659                                         .rejectWith(that, [data]).promise();
660                                 }
661                                 return getPromise(arguments);
662                             }
663                         ).pipe(resolveFunc, rejectFunc);
664                 }
665                 return this._processQueue || getPromise([this]);
666             };
667             data.submit = function () {
668                 if (this.state() !== 'pending') {
669                     data.jqXHR = this.jqXHR =
670                         (that._trigger(
671                             'submit',
672                             $.Event('submit', {delegatedEvent: e}),
673                             this
674                         ) !== false) && that._onSend(e, this);
675                 }
676                 return this.jqXHR || that._getXHRPromise();
677             };
678             data.abort = function () {
679                 if (this.jqXHR) {
680                     return this.jqXHR.abort();
681                 }
682                 this.errorThrown = 'abort';
683                 that._trigger('fail', null, this);
684                 return that._getXHRPromise(false);
685             };
686             data.state = function () {
687                 if (this.jqXHR) {
688                     return that._getDeferredState(this.jqXHR);
689                 }
690                 if (this._processQueue) {
691                     return that._getDeferredState(this._processQueue);
692                 }
693             };
694             data.processing = function () {
695                 return !this.jqXHR && this._processQueue && that
696                         ._getDeferredState(this._processQueue) === 'pending';
697             };
698             data.progress = function () {
699                 return this._progress;
700             };
701             data.response = function () {
702                 return this._response;
703             };
704         },
705
706         // Parses the Range header from the server response
707         // and returns the uploaded bytes:
708         _getUploadedBytes: function (jqXHR) {
709             var range = jqXHR.getResponseHeader('Range'),
710                 parts = range && range.split('-'),
711                 upperBytesPos = parts && parts.length > 1 &&
712                     parseInt(parts[1], 10);
713             return upperBytesPos && upperBytesPos + 1;
714         },
715
716         // Uploads a file in multiple, sequential requests
717         // by splitting the file up in multiple blob chunks.
718         // If the second parameter is true, only tests if the file
719         // should be uploaded in chunks, but does not invoke any
720         // upload requests:
721         _chunkedUpload: function (options, testOnly) {
722             options.uploadedBytes = options.uploadedBytes || 0;
723             var that = this,
724                 file = options.files[0],
725                 fs = file.size,
726                 ub = options.uploadedBytes,
727                 mcs = options.maxChunkSize || fs,
728                 slice = this._blobSlice,
729                 dfd = $.Deferred(),
730                 promise = dfd.promise(),
731                 jqXHR,
732                 upload;
733             if (!(this._isXHRUpload(options) && slice && (ub || mcs < fs)) ||
734                 options.data) {
735                 return false;
736             }
737             if (testOnly) {
738                 return true;
739             }
740             if (ub >= fs) {
741                 file.error = options.i18n('uploadedBytes');
742                 return this._getXHRPromise(
743                     false,
744                     options.context,
745                     [null, 'error', file.error]
746                 );
747             }
748             // The chunk upload method:
749             upload = function () {
750                 // Clone the options object for each chunk upload:
751                 var o = $.extend({}, options),
752                     currentLoaded = o._progress.loaded;
753                 o.blob = slice.call(
754                     file,
755                     ub,
756                     ub + mcs,
757                     file.type
758                 );
759                 // Store the current chunk size, as the blob itself
760                 // will be dereferenced after data processing:
761                 o.chunkSize = o.blob.size;
762                 // Expose the chunk bytes position range:
763                 o.contentRange = 'bytes ' + ub + '-' +
764                     (ub + o.chunkSize - 1) + '/' + fs;
765                 // Process the upload data (the blob and potential form data):
766                 that._initXHRData(o);
767                 // Add progress listeners for this chunk upload:
768                 that._initProgressListener(o);
769                 jqXHR = ((that._trigger('chunksend', null, o) !== false && $.ajax(o)) ||
770                 that._getXHRPromise(false, o.context))
771                     .done(function (result, textStatus, jqXHR) {
772                         ub = that._getUploadedBytes(jqXHR) ||
773                             (ub + o.chunkSize);
774                         // Create a progress event if no final progress event
775                         // with loaded equaling total has been triggered
776                         // for this chunk:
777                         if (currentLoaded + o.chunkSize - o._progress.loaded) {
778                             that._onProgress($.Event('progress', {
779                                 lengthComputable: true,
780                                 loaded: ub - o.uploadedBytes,
781                                 total: ub - o.uploadedBytes
782                             }), o);
783                         }
784                         options.uploadedBytes = o.uploadedBytes = ub;
785                         o.result = result;
786                         o.textStatus = textStatus;
787                         o.jqXHR = jqXHR;
788                         that._trigger('chunkdone', null, o);
789                         that._trigger('chunkalways', null, o);
790                         if (ub < fs) {
791                             // File upload not yet complete,
792                             // continue with the next chunk:
793                             upload();
794                         } else {
795                             dfd.resolveWith(
796                                 o.context,
797                                 [result, textStatus, jqXHR]
798                             );
799                         }
800                     })
801                     .fail(function (jqXHR, textStatus, errorThrown) {
802                         o.jqXHR = jqXHR;
803                         o.textStatus = textStatus;
804                         o.errorThrown = errorThrown;
805                         that._trigger('chunkfail', null, o);
806                         that._trigger('chunkalways', null, o);
807                         dfd.rejectWith(
808                             o.context,
809                             [jqXHR, textStatus, errorThrown]
810                         );
811                     });
812             };
813             this._enhancePromise(promise);
814             promise.abort = function () {
815                 return jqXHR.abort();
816             };
817             upload();
818             return promise;
819         },
820
821         _beforeSend: function (e, data) {
822             if (this._active === 0) {
823                 // the start callback is triggered when an upload starts
824                 // and no other uploads are currently running,
825                 // equivalent to the global ajaxStart event:
826                 this._trigger('start');
827                 // Set timer for global bitrate progress calculation:
828                 this._bitrateTimer = new this._BitrateTimer();
829                 // Reset the global progress values:
830                 this._progress.loaded = this._progress.total = 0;
831                 this._progress.bitrate = 0;
832             }
833             // Make sure the container objects for the .response() and
834             // .progress() methods on the data object are available
835             // and reset to their initial state:
836             this._initResponseObject(data);
837             this._initProgressObject(data);
838             data._progress.loaded = data.loaded = data.uploadedBytes || 0;
839             data._progress.total = data.total = this._getTotal(data.files) || 1;
840             data._progress.bitrate = data.bitrate = 0;
841             this._active += 1;
842             // Initialize the global progress values:
843             this._progress.loaded += data.loaded;
844             this._progress.total += data.total;
845         },
846
847         _onDone: function (result, textStatus, jqXHR, options) {
848             var total = options._progress.total,
849                 response = options._response;
850             if (options._progress.loaded < total) {
851                 // Create a progress event if no final progress event
852                 // with loaded equaling total has been triggered:
853                 this._onProgress($.Event('progress', {
854                     lengthComputable: true,
855                     loaded: total,
856                     total: total
857                 }), options);
858             }
859             response.result = options.result = result;
860             response.textStatus = options.textStatus = textStatus;
861             response.jqXHR = options.jqXHR = jqXHR;
862             this._trigger('done', null, options);
863         },
864
865         _onFail: function (jqXHR, textStatus, errorThrown, options) {
866             var response = options._response;
867             if (options.recalculateProgress) {
868                 // Remove the failed (error or abort) file upload from
869                 // the global progress calculation:
870                 this._progress.loaded -= options._progress.loaded;
871                 this._progress.total -= options._progress.total;
872             }
873             response.jqXHR = options.jqXHR = jqXHR;
874             response.textStatus = options.textStatus = textStatus;
875             response.errorThrown = options.errorThrown = errorThrown;
876             this._trigger('fail', null, options);
877         },
878
879         _onAlways: function (jqXHRorResult, textStatus, jqXHRorError, options) {
880             // jqXHRorResult, textStatus and jqXHRorError are added to the
881             // options object via done and fail callbacks
882             this._trigger('always', null, options);
883         },
884
885         _onSend: function (e, data) {
886             if (!data.submit) {
887                 this._addConvenienceMethods(e, data);
888             }
889             var that = this,
890                 jqXHR,
891                 aborted,
892                 slot,
893                 pipe,
894                 options = that._getAJAXSettings(data),
895                 send = function () {
896                     that._sending += 1;
897                     // Set timer for bitrate progress calculation:
898                     options._bitrateTimer = new that._BitrateTimer();
899                     jqXHR = jqXHR || (
900                             ((aborted || that._trigger(
901                                 'send',
902                                 $.Event('send', {delegatedEvent: e}),
903                                 options
904                             ) === false) &&
905                             that._getXHRPromise(false, options.context, aborted)) ||
906                             that._chunkedUpload(options) || $.ajax(options)
907                         ).done(function (result, textStatus, jqXHR) {
908                                 that._onDone(result, textStatus, jqXHR, options);
909                             }).fail(function (jqXHR, textStatus, errorThrown) {
910                                 that._onFail(jqXHR, textStatus, errorThrown, options);
911                             }).always(function (jqXHRorResult, textStatus, jqXHRorError) {
912                                 that._onAlways(
913                                     jqXHRorResult,
914                                     textStatus,
915                                     jqXHRorError,
916                                     options
917                                 );
918                                 that._sending -= 1;
919                                 that._active -= 1;
920                                 if (options.limitConcurrentUploads &&
921                                     options.limitConcurrentUploads > that._sending) {
922                                     // Start the next queued upload,
923                                     // that has not been aborted:
924                                     var nextSlot = that._slots.shift();
925                                     while (nextSlot) {
926                                         if (that._getDeferredState(nextSlot) === 'pending') {
927                                             nextSlot.resolve();
928                                             break;
929                                         }
930                                         nextSlot = that._slots.shift();
931                                     }
932                                 }
933                                 if (that._active === 0) {
934                                     // The stop callback is triggered when all uploads have
935                                     // been completed, equivalent to the global ajaxStop event:
936                                     that._trigger('stop');
937                                 }
938                             });
939                     return jqXHR;
940                 };
941             this._beforeSend(e, options);
942             if (this.options.sequentialUploads ||
943                 (this.options.limitConcurrentUploads &&
944                 this.options.limitConcurrentUploads <= this._sending)) {
945                 if (this.options.limitConcurrentUploads > 1) {
946                     slot = $.Deferred();
947                     this._slots.push(slot);
948                     pipe = slot.pipe(send);
949                 } else {
950                     this._sequence = this._sequence.pipe(send, send);
951                     pipe = this._sequence;
952                 }
953                 // Return the piped Promise object, enhanced with an abort method,
954                 // which is delegated to the jqXHR object of the current upload,
955                 // and jqXHR callbacks mapped to the equivalent Promise methods:
956                 pipe.abort = function () {
957                     aborted = [undefined, 'abort', 'abort'];
958                     if (!jqXHR) {
959                         if (slot) {
960                             slot.rejectWith(options.context, aborted);
961                         }
962                         return send();
963                     }
964                     return jqXHR.abort();
965                 };
966                 return this._enhancePromise(pipe);
967             }
968             return send();
969         },
970
971         _onAdd: function (e, data) {
972             var that = this,
973                 result = true,
974                 options = $.extend({}, this.options, data),
975                 files = data.files,
976                 filesLength = files.length,
977                 limit = options.limitMultiFileUploads,
978                 limitSize = options.limitMultiFileUploadSize,
979                 overhead = options.limitMultiFileUploadSizeOverhead,
980                 batchSize = 0,
981                 paramName = this._getParamName(options),
982                 paramNameSet,
983                 paramNameSlice,
984                 fileSet,
985                 i,
986                 j = 0;
987             if (!filesLength) {
988                 return false;
989             }
990             if (limitSize && files[0].size === undefined) {
991                 limitSize = undefined;
992             }
993             if (!(options.singleFileUploads || limit || limitSize) ||
994                 !this._isXHRUpload(options)) {
995                 fileSet = [files];
996                 paramNameSet = [paramName];
997             } else if (!(options.singleFileUploads || limitSize) && limit) {
998                 fileSet = [];
999                 paramNameSet = [];
1000                 for (i = 0; i < filesLength; i += limit) {
1001                     fileSet.push(files.slice(i, i + limit));
1002                     paramNameSlice = paramName.slice(i, i + limit);
1003                     if (!paramNameSlice.length) {
1004                         paramNameSlice = paramName;
1005                     }
1006                     paramNameSet.push(paramNameSlice);
1007                 }
1008             } else if (!options.singleFileUploads && limitSize) {
1009                 fileSet = [];
1010                 paramNameSet = [];
1011                 for (i = 0; i < filesLength; i = i + 1) {
1012                     batchSize += files[i].size + overhead;
1013                     if (i + 1 === filesLength ||
1014                         ((batchSize + files[i + 1].size + overhead) > limitSize) ||
1015                         (limit && i + 1 - j >= limit)) {
1016                         fileSet.push(files.slice(j, i + 1));
1017                         paramNameSlice = paramName.slice(j, i + 1);
1018                         if (!paramNameSlice.length) {
1019                             paramNameSlice = paramName;
1020                         }
1021                         paramNameSet.push(paramNameSlice);
1022                         j = i + 1;
1023                         batchSize = 0;
1024                     }
1025                 }
1026             } else {
1027                 paramNameSet = paramName;
1028             }
1029             data.originalFiles = files;
1030             $.each(fileSet || files, function (index, element) {
1031                 var newData = $.extend({}, data);
1032                 newData.files = fileSet ? element : [element];
1033                 newData.paramName = paramNameSet[index];
1034                 that._initResponseObject(newData);
1035                 that._initProgressObject(newData);
1036                 that._addConvenienceMethods(e, newData);
1037                 result = that._trigger(
1038                     'add',
1039                     $.Event('add', {delegatedEvent: e}),
1040                     newData
1041                 );
1042                 return result;
1043             });
1044             return result;
1045         },
1046
1047         _replaceFileInput: function (data) {
1048             var input = data.fileInput,
1049                 inputClone = input.clone(true),
1050                 restoreFocus = input.is(document.activeElement);
1051             // Add a reference for the new cloned file input to the data argument:
1052             data.fileInputClone = inputClone;
1053             $('<form></form>').append(inputClone)[0].reset();
1054             // Detaching allows to insert the fileInput on another form
1055             // without loosing the file input value:
1056             input.after(inputClone).detach();
1057             // If the fileInput had focus before it was detached,
1058             // restore focus to the inputClone.
1059             if (restoreFocus) {
1060                 inputClone.focus();
1061             }
1062             // Avoid memory leaks with the detached file input:
1063             $.cleanData(input.unbind('remove'));
1064             // Replace the original file input element in the fileInput
1065             // elements set with the clone, which has been copied including
1066             // event handlers:
1067             this.options.fileInput = this.options.fileInput.map(function (i, el) {
1068                 if (el === input[0]) {
1069                     return inputClone[0];
1070                 }
1071                 return el;
1072             });
1073             // If the widget has been initialized on the file input itself,
1074             // override this.element with the file input clone:
1075             if (input[0] === this.element[0]) {
1076                 this.element = inputClone;
1077             }
1078         },
1079
1080         _handleFileTreeEntry: function (entry, path) {
1081             var that = this,
1082                 dfd = $.Deferred(),
1083                 errorHandler = function (e) {
1084                     if (e && !e.entry) {
1085                         e.entry = entry;
1086                     }
1087                     // Since $.when returns immediately if one
1088                     // Deferred is rejected, we use resolve instead.
1089                     // This allows valid files and invalid items
1090                     // to be returned together in one set:
1091                     dfd.resolve([e]);
1092                 },
1093                 successHandler = function (entries) {
1094                     that._handleFileTreeEntries(
1095                         entries,
1096                         path + entry.name + '/'
1097                     ).done(function (files) {
1098                             dfd.resolve(files);
1099                         }).fail(errorHandler);
1100                 },
1101                 readEntries = function () {
1102                     dirReader.readEntries(function (results) {
1103                         if (!results.length) {
1104                             successHandler(entries);
1105                         } else {
1106                             entries = entries.concat(results);
1107                             readEntries();
1108                         }
1109                     }, errorHandler);
1110                 },
1111                 dirReader, entries = [];
1112             path = path || '';
1113             if (entry.isFile) {
1114                 if (entry._file) {
1115                     // Workaround for Chrome bug #149735
1116                     entry._file.relativePath = path;
1117                     dfd.resolve(entry._file);
1118                 } else {
1119                     entry.file(function (file) {
1120                         file.relativePath = path;
1121                         dfd.resolve(file);
1122                     }, errorHandler);
1123                 }
1124             } else if (entry.isDirectory) {
1125                 dirReader = entry.createReader();
1126                 readEntries();
1127             } else {
1128                 // Return an empy list for file system items
1129                 // other than files or directories:
1130                 dfd.resolve([]);
1131             }
1132             return dfd.promise();
1133         },
1134
1135         _handleFileTreeEntries: function (entries, path) {
1136             var that = this;
1137             return $.when.apply(
1138                 $,
1139                 $.map(entries, function (entry) {
1140                     return that._handleFileTreeEntry(entry, path);
1141                 })
1142             ).pipe(function () {
1143                     return Array.prototype.concat.apply(
1144                         [],
1145                         arguments
1146                     );
1147                 });
1148         },
1149
1150         _getDroppedFiles: function (dataTransfer) {
1151             dataTransfer = dataTransfer || {};
1152             var items = dataTransfer.items;
1153             if (items && items.length && (items[0].webkitGetAsEntry ||
1154                 items[0].getAsEntry)) {
1155                 return this._handleFileTreeEntries(
1156                     $.map(items, function (item) {
1157                         var entry;
1158                         if (item.webkitGetAsEntry) {
1159                             entry = item.webkitGetAsEntry();
1160                             if (entry) {
1161                                 // Workaround for Chrome bug #149735:
1162                                 entry._file = item.getAsFile();
1163                             }
1164                             return entry;
1165                         }
1166                         return item.getAsEntry();
1167                     })
1168                 );
1169             }
1170             return $.Deferred().resolve(
1171                 $.makeArray(dataTransfer.files)
1172             ).promise();
1173         },
1174
1175         _getSingleFileInputFiles: function (fileInput) {
1176             fileInput = $(fileInput);
1177             var entries = fileInput.prop('webkitEntries') ||
1178                     fileInput.prop('entries'),
1179                 files,
1180                 value;
1181             if (entries && entries.length) {
1182                 return this._handleFileTreeEntries(entries);
1183             }
1184             files = $.makeArray(fileInput.prop('files'));
1185             if (!files.length) {
1186                 value = fileInput.prop('value');
1187                 if (!value) {
1188                     return $.Deferred().resolve([]).promise();
1189                 }
1190                 // If the files property is not available, the browser does not
1191                 // support the File API and we add a pseudo File object with
1192                 // the input value as name with path information removed:
1193                 files = [{name: value.replace(/^.*\\/, '')}];
1194             } else if (files[0].name === undefined && files[0].fileName) {
1195                 // File normalization for Safari 4 and Firefox 3:
1196                 $.each(files, function (index, file) {
1197                     file.name = file.fileName;
1198                     file.size = file.fileSize;
1199                 });
1200             }
1201             return $.Deferred().resolve(files).promise();
1202         },
1203
1204         _getFileInputFiles: function (fileInput) {
1205             if (!(fileInput instanceof $) || fileInput.length === 1) {
1206                 return this._getSingleFileInputFiles(fileInput);
1207             }
1208             return $.when.apply(
1209                 $,
1210                 $.map(fileInput, this._getSingleFileInputFiles)
1211             ).pipe(function () {
1212                     return Array.prototype.concat.apply(
1213                         [],
1214                         arguments
1215                     );
1216                 });
1217         },
1218
1219         _onChange: function (e) {
1220             var that = this,
1221                 data = {
1222                     fileInput: $(e.target),
1223                     form: $(e.target.form)
1224                 };
1225             this._getFileInputFiles(data.fileInput).always(function (files) {
1226                 data.files = files;
1227                 if (that.options.replaceFileInput) {
1228                     that._replaceFileInput(data);
1229                 }
1230                 if (that._trigger(
1231                         'change',
1232                         $.Event('change', {delegatedEvent: e}),
1233                         data
1234                     ) !== false) {
1235                     that._onAdd(e, data);
1236                 }
1237             });
1238         },
1239
1240         _onPaste: function (e) {
1241             var items = e.originalEvent && e.originalEvent.clipboardData &&
1242                     e.originalEvent.clipboardData.items,
1243                 data = {files: []};
1244             if (items && items.length) {
1245                 $.each(items, function (index, item) {
1246                     var file = item.getAsFile && item.getAsFile();
1247                     if (file) {
1248                         data.files.push(file);
1249                     }
1250                 });
1251                 if (this._trigger(
1252                         'paste',
1253                         $.Event('paste', {delegatedEvent: e}),
1254                         data
1255                     ) !== false) {
1256                     this._onAdd(e, data);
1257                 }
1258             }
1259         },
1260
1261         _onDrop: function (e) {
1262             e.dataTransfer = e.originalEvent && e.originalEvent.dataTransfer;
1263             var that = this,
1264                 dataTransfer = e.dataTransfer,
1265                 data = {};
1266             if (dataTransfer && dataTransfer.files && dataTransfer.files.length) {
1267                 e.preventDefault();
1268                 this._getDroppedFiles(dataTransfer).always(function (files) {
1269                     data.files = files;
1270                     if (that._trigger(
1271                             'drop',
1272                             $.Event('drop', {delegatedEvent: e}),
1273                             data
1274                         ) !== false) {
1275                         that._onAdd(e, data);
1276                     }
1277                 });
1278             }
1279         },
1280
1281         _onDragOver: getDragHandler('dragover'),
1282
1283         _onDragEnter: getDragHandler('dragenter'),
1284
1285         _onDragLeave: getDragHandler('dragleave'),
1286
1287         _initEventHandlers: function () {
1288             if (this._isXHRUpload(this.options)) {
1289                 this._on(this.options.dropZone, {
1290                     dragover: this._onDragOver,
1291                     drop: this._onDrop,
1292                     // event.preventDefault() on dragenter is required for IE10+:
1293                     dragenter: this._onDragEnter,
1294                     // dragleave is not required, but added for completeness:
1295                     dragleave: this._onDragLeave
1296                 });
1297                 this._on(this.options.pasteZone, {
1298                     paste: this._onPaste
1299                 });
1300             }
1301             if ($.support.fileInput) {
1302                 this._on(this.options.fileInput, {
1303                     change: this._onChange
1304                 });
1305             }
1306         },
1307
1308         _destroyEventHandlers: function () {
1309             this._off(this.options.dropZone, 'dragenter dragleave dragover drop');
1310             this._off(this.options.pasteZone, 'paste');
1311             this._off(this.options.fileInput, 'change');
1312         },
1313
1314         _setOption: function (key, value) {
1315             var reinit = $.inArray(key, this._specialOptions) !== -1;
1316             if (reinit) {
1317                 this._destroyEventHandlers();
1318             }
1319             this._super(key, value);
1320             if (reinit) {
1321                 this._initSpecialOptions();
1322                 this._initEventHandlers();
1323             }
1324         },
1325
1326         _initSpecialOptions: function () {
1327             var options = this.options;
1328             if (options.fileInput === undefined) {
1329                 options.fileInput = this.element.is('input[type="file"]') ?
1330                     this.element : this.element.find('input[type="file"]');
1331             } else if (!(options.fileInput instanceof $)) {
1332                 options.fileInput = $(options.fileInput);
1333             }
1334             if (!(options.dropZone instanceof $)) {
1335                 options.dropZone = $(options.dropZone);
1336             }
1337             if (!(options.pasteZone instanceof $)) {
1338                 options.pasteZone = $(options.pasteZone);
1339             }
1340         },
1341
1342         _getRegExp: function (str) {
1343             var parts = str.split('/'),
1344                 modifiers = parts.pop();
1345             parts.shift();
1346             return new RegExp(parts.join('/'), modifiers);
1347         },
1348
1349         _isRegExpOption: function (key, value) {
1350             return key !== 'url' && $.type(value) === 'string' &&
1351                 /^\/.*\/[igm]{0,3}$/.test(value);
1352         },
1353
1354         _initDataAttributes: function () {
1355             var that = this,
1356                 options = this.options,
1357                 data = this.element.data();
1358             // Initialize options set via HTML5 data-attributes:
1359             $.each(
1360                 this.element[0].attributes,
1361                 function (index, attr) {
1362                     var key = attr.name.toLowerCase(),
1363                         value;
1364                     if (/^data-/.test(key)) {
1365                         // Convert hyphen-ated key to camelCase:
1366                         key = key.slice(5).replace(/-[a-z]/g, function (str) {
1367                             return str.charAt(1).toUpperCase();
1368                         });
1369                         value = data[key];
1370                         if (that._isRegExpOption(key, value)) {
1371                             value = that._getRegExp(value);
1372                         }
1373                         options[key] = value;
1374                     }
1375                 }
1376             );
1377         },
1378
1379         _create: function () {
1380             this._initDataAttributes();
1381             this._initSpecialOptions();
1382             this._slots = [];
1383             this._sequence = this._getXHRPromise(true);
1384             this._sending = this._active = 0;
1385             this._initProgressObject(this);
1386             this._initEventHandlers();
1387         },
1388
1389         // This method is exposed to the widget API and allows to query
1390         // the number of active uploads:
1391         active: function () {
1392             return this._active;
1393         },
1394
1395         // This method is exposed to the widget API and allows to query
1396         // the widget upload progress.
1397         // It returns an object with loaded, total and bitrate properties
1398         // for the running uploads:
1399         progress: function () {
1400             return this._progress;
1401         },
1402
1403         // This method is exposed to the widget API and allows adding files
1404         // using the fileupload API. The data parameter accepts an object which
1405         // must have a files property and can contain additional options:
1406         // .fileupload('add', {files: filesList});
1407         add: function (data) {
1408             var that = this;
1409             if (!data || this.options.disabled) {
1410                 return;
1411             }
1412             if (data.fileInput && !data.files) {
1413                 this._getFileInputFiles(data.fileInput).always(function (files) {
1414                     data.files = files;
1415                     that._onAdd(null, data);
1416                 });
1417             } else {
1418                 data.files = $.makeArray(data.files);
1419                 this._onAdd(null, data);
1420             }
1421         },
1422
1423         // This method is exposed to the widget API and allows sending files
1424         // using the fileupload API. The data parameter accepts an object which
1425         // must have a files or fileInput property and can contain additional options:
1426         // .fileupload('send', {files: filesList});
1427         // The method returns a Promise object for the file upload call.
1428         send: function (data) {
1429             if (data && !this.options.disabled) {
1430                 if (data.fileInput && !data.files) {
1431                     var that = this,
1432                         dfd = $.Deferred(),
1433                         promise = dfd.promise(),
1434                         jqXHR,
1435                         aborted;
1436                     promise.abort = function () {
1437                         aborted = true;
1438                         if (jqXHR) {
1439                             return jqXHR.abort();
1440                         }
1441                         dfd.reject(null, 'abort', 'abort');
1442                         return promise;
1443                     };
1444                     this._getFileInputFiles(data.fileInput).always(
1445                         function (files) {
1446                             if (aborted) {
1447                                 return;
1448                             }
1449                             if (!files.length) {
1450                                 dfd.reject();
1451                                 return;
1452                             }
1453                             data.files = files;
1454                             jqXHR = that._onSend(null, data);
1455                             jqXHR.then(
1456                                 function (result, textStatus, jqXHR) {
1457                                     dfd.resolve(result, textStatus, jqXHR);
1458                                 },
1459                                 function (jqXHR, textStatus, errorThrown) {
1460                                     dfd.reject(jqXHR, textStatus, errorThrown);
1461                                 }
1462                             );
1463                         }
1464                     );
1465                     return this._enhancePromise(promise);
1466                 }
1467                 data.files = $.makeArray(data.files);
1468                 if (data.files.length) {
1469                     return this._onSend(null, data);
1470                 }
1471             }
1472             return this._getXHRPromise(false, data && data.context);
1473         }
1474
1475     });
1476
1477 }));