Isomorphic TypeScript file upload library for browser and node.js environments.

Quickstart:

``
npm install upload

...or

yarn add upload
`

Example usage

$3

`ts
import { upload } from 'upload';

async function test() {
const response = await upload(
'https://example.com/upload',
{
file: someInput.file,
},
{
onProgress: progress => (element.innerText = progress * 100 + '%'),
}
);

console.log(response);
}
`

$3

`ts
async function test() {
const upload = new Upload({
url: 'https://example.com/upload',
form: {
file: someInput.file,
},
headers: {
Authorization: 'Bearer TOKEN',
},
});

upload.on('progress', progress => {
element.innerText = progress * 100 + '%';
});

const response = await upload.upload();
console.log(response);

alert('Done!');
}
`

$3

`ts
const upload = new Upload({
url: 'https://httpbin.org/post',
form: someInput.file,
});

upload.on('state', () => {
if (upload.state === 'aborted') doSomething();
});

upload.upload();
upload.abort();
`

Events

You can attach event listeners to an instance of Upload with .on:

`ts
upload.on('state', state => {
console.log(state);
});
`

$3

Emitted when upload state is changed. Possible states: new, started, aborted, failed, successful.

$3

Emitted when an error occurs.

$3

Emitted when upload progress changes. Progress is a float between 0 and 1.

API

`ts
interface UploadResponse {
data?: string | ArrayBuffer | Blob;
headers?: Record;
}

interface UploadOptions {
form: Record | FormData | FormDataNode;
url: string;
headers?: Record;
}

type UploadState = 'new' | 'started' | 'aborted' | 'failed' | 'successful';

public state: UploadState;
public progress = 0;
public uploadedBytes = 0;
public totalBytes = 0;

new Upload(options: UploadOptions);
upload(): Promise;
abort(): void;

on(eventType: 'progress', listener: (progress: number) => void): void;
on(eventType: 'error', listener: () => void): void;
on(eventType: 'state', listener: (state: string) => void): void;

off(eventType: 'progress', listener: (progress: number) => void): void;
off(eventType: 'error', listener: () => void): void;
off(eventType: 'state', listener: (state: string) => void): void;
``