pure-upload

Pure-upload

The pure JS (TS) upload library with no dependencies compatible with Google Chrome, Firefox, IE10+ (IE9- with auto-start by default, manual-start optionally) and mobile browsers.

Installation

1. Dowload as a ZIP file directly from GitHub pages and include to your project.
2. Install with npm by npm install pure-upload --save.
3. Install with bower by bower install pure-upload.

Example

See a simple example.

Api

Uploader

Uploader manages upload queue and registers upload areas.

Initialization:

let uploader = pu.getUploader(uploadQueueOptions, uploadQueueCallbacks)

Upload queue options

maxParallelUploads?: number;
parallelBatchOffset?: number;
autoStart?: boolean;
autoRemove?: boolean;

Upload queue callbacks

onProgressCallback?: (file: IUploadFile) => void;
onCancelledCallback?: (file: IUploadFile) => void;
onFinishedCallback?: (file: IUploadFile) => void;
onUploadedCallback?: (file: IUploadFile) => void;
onErrorCallback?: (file: IUploadFile) => void;
onUploadStartedCallback?: (file: IUploadFile) => void;
onFileAddedCallback?: (file: IUploadFile) => void;
onFileRemovedCallback?: (file: IUploadFile) => void;
onAllFinishedCallback?: () => void;
onQueueChangedCallback?: (queue: IUploadFile[]) => void;
onFilesAddedErrorCallback?: (files: IUploadFile[]) => void;

Upload area

Upload area defines element registred in Uploader.

Registration:

let uploadArea = uploader.registerArea(element, uploadAreaOptions);

Registration for IE9- with manual-start:

let uploadArea = uploader.registerArea(element, uploadAreaOptions, compatibilityForm);

The compatibilityForm objects has to be form element containing one input element for file and one input element for submit.

Unregistration:

uploader.unregisterArea(uploadArea);

Upload area options

url: string;
method: string;
withCredentials?: boolean;
headers?: { [key: string]: string; };
params?: { [key: string]: string; };
localizer?: (message: string, params?: Object) => string;
maxFileSize?: number;
allowDragDrop?: boolean | (() => boolean);
clickable?: boolean | (() => boolean);
accept?: string;
multiple?: boolean;
validateExtension?: boolean;
manualStart?: boolean;
onFileAdded?: (file: IUploadFile) => void;
onFileSelected?: (file: IUploadFile) => void;
onFileError?: (file: IUploadFile) => void;
onFileCanceled?: (file: IUploadFile) => void;

Upload area - manual starting

start(autoClear?: boolean): void;
clear(): void;

Upload file

Standard File object extended with additional informations and methods to manage a file in queue.

guid: string;
uploadStatus: UploadStatus;
responseCode: number;
responseText: string;
progress: number;
sentBytes: number;
cancel: () => void;
remove: () => void;
start: () => void;

Upload status

File statuses accesible by pu.uploadStatus.

Library used by GMC Software Technology.

MIT, Copyright © 2015 Tomáš Růt

Changelog

2.2.3

Fix

Removed duplications when same file is adding many times to queue. Few options of UploadArea changed to be acceptable as a function.