ngx-uploadx

ngx-uploadx

Angular Resumable Upload Module

Key Features

• Pause / Resume / Cancel Uploads
• Retries using exponential back-off strategy
• Chunking

Setup

• Add ngx-uploadx module as dependency :

  npm install ngx-uploadx

• Import UploadxModule:

//...
import { UploadxModule } from 'ngx-uploadx';

@NgModule({
  imports: [
    UploadxModule,
   // ...
});

Basic usage

// Component code
//...
import { UploadxOptions, UploadState } from 'ngx-uploadx';

@Component({
  selector: 'app-home',
  templateUrl: `
  <input type="file" [uploadx]="options" (state)="onUpload($event)">
  `
})
export class AppHomeComponent {
  options: UploadxOptions = { endpoint: `[URL]` };
  onUpload(state: UploadState) {
    console.log(state);
    //...
  }
}

Please navigate to the src/app sub-folder for more detailed examples

Server-side setup

• node-uploadx
• tus-node-server
• tusd

API

UploadxOptions

• allowedTypes Allowed file types (directive only)

• authorize Function used to apply authorization token (example)

• autoUpload Auto start upload when files added. Default value: true

• chunkSize Set a fixed chunk size. If not specified, the optimal size will be automatically adjusted based on the network speed.

• concurrency Set the maximum parallel uploads. Default value: 2

• endpoint URL to create new uploads. Default value: '/upload'

• headers Headers to be appended to each HTTP request

• metadata Custom uploads metadata

• multiple Allow selecting multiple files. Default value: true (directive only)

• prerequest Function called before every request (example)

• retryConfig Configure retry settings

• token Authorization token as a string or function returning a string or Promise<string>

• uploaderClass Upload API implementation. Built-in: UploaderX(default), Tus. More examples.

UploadxModule

Adds directives and provide static method withConfig for global configuration (example)

Directives

<div uploadxDrop>
  <label class="file-drop">
    <input type="file" [uploadx]="options" [control]="control" (state)="onState($event)" />
  </label>
</div>

uploadx

File input directive

selectors: [uploadx], uploadx

Properties:

• @Input() uploadx: UploadxOptions Set directive options

• @Input() options: UploadxOptions Alias for uploadx property

• @Input() control: UploadxControlEvent Control the uploads

• @Output() state: EventEmitter<UploadState> Event emitted on upload state change

uploadxDrop

File drop directive.

selector: uploadxDrop

Activates the .uploadx-drop-active class on DnD operations.

UploadxService

• init(options?: UploadxOptions): Observable<UploadState>

  Initializes service. Returns Observable that emits a new value on progress or status changes.

  //  @example:
  uploadxOptions: UploadxOptions = {
    concurrency: 4,
    endpoint: `${environment.api}/upload`,
    token:  () => localStorage.getItem('access_token'),
    uploaderClass: Tus
  };
  ngOnInit() {
    this.uploadService.init(this.uploadxOptions)
      .subscribe((item: UploadState) => {
        console.log(item);
        //...
      }
  }
  

• connect(options?: UploadxOptions): Observable<Uploader[]>

  Initializes service. Returns Observable that emits the current queue

  // @example:
  @Component({
    template: `
      <input type="file" uploadx">
      <div *ngFor="let item of uploads$ | async">{{item.name}}</div>
    `,
    changeDetection: ChangeDetectionStrategy.OnPush
  })
  export class UploadsComponent {
    uploads$: Observable<Uploader[]>;
    options: UploadxOptions = {
      endpoint: `${environment.api}/upload?uploadType=uploadx`,
      token:  () => localStorage.getItem('access_token'),
      headers: { 'ngsw-bypass': 1 }
    }
    constructor(private uploadService: UploadxService) {
      this.uploads$ = this.uploadService.connect(this.options);
    }
  

• disconnect(): void

  Terminate all uploads and clears the queue

• handleFiles(files: FileList | File | File[], options = {} as UploadxOptions): void

  Creates uploaders for files and adds them to the upload queue

• control(event: UploadxControlEvent): void

  Uploads control

  // @example:
  pause(uploadId: string) {
    this.uploadService.control({ action: 'pause', uploadId });
  }
  setToken(token: string) {
    this.uploadService.control({ token });
  }
  

• request<T = string>(config: AjaxRequestConfig): Promise<AjaxResponse<T>>

  Make HTTP request with axios like interface.

• queue: Uploader[]

  Uploaders array

• events: Observable<UploadState>

  Uploads state events

DI tokens

• UPLOADX_FACTORY_OPTIONS for override default configuration

• UPLOADX_OPTIONS for global options

• UPLOADX_AJAX for override internal ajax lib

Run demo

• Run script npm start
• Navigate to http://localhost:4200/

Build

Run npm run build to build the lib.

packaged by ng-packagr

Contributing

Pull requests are welcome!

References

• https://developers.google.com/drive/api/v3/manage-uploads#resumable
• https://github.com/tus/tus-resumable-upload-protocol/blob/master/protocol.md

License

The MIT License (see the LICENSE file for the full text)