@victoryoalli/fu.js v1.1.0

fu.js File Upload Library

fu.js is a lightweight JavaScript library built on top of tus-js-client for simplifying file uploads to a server. It allows easy configuration of the upload endpoint, including setting the host and folder dynamically. The library is designed to work in web environments and provides hooks for upload progress, success, and error handling.

Features

• Easy to configure with custom hosts and folders
• Built-in progress, success, and error callbacks
• Utilizes tus-js-client for reliable uploads with support for resuming

Installation

To use fu.js in your project, you first need to ensure tus-js-client is available. fu.js can then be included in your project directly.

Including tus-js-client

If not already included in your project, add tus-js-client by running:

npm install tus-js-client

npm install @victoryoalli/fu.js

Basic Usage

<input type="file" id="fileInput" accept="video/*" />
<button id="uploadButton">Upload Video</button>
<div id="uploadProgress"></div>

import fu from '@victoryoalli/fu.js'

//fu.host ="http://localhost:1231"
//fu.folder ="files"

    document.addEventListener("DOMContentLoaded", function() {
    var input = document.getElementById("fileInput");
    var button = document.getElementById("uploadButton");
    var progress = document.getElementById("uploadProgress");

    button.addEventListener("click", function() {
    if (input.files.length > 0) {
        var file = input.files[0];

    fu.upload(file)
       .progress(function(bytesUploaded, bytesTotal, percentage) {
         console.log("Percentage:", percentage);
         progress.textContent = "Upload is " + percentage + "% complete";
       })
       .error(function(error) {
        console.error("Failed because: ", error);
       })
       .success(function(upload) {
         console.log("Upload finished:", upload.url);
         progress.textContent = "Upload finished!";
       }) ;

    } else {
        alert("Please select a file.");
    }
    });

});

Configuration

• host: The server host (default is derived from window.location).
• folder: The folder path on the server where files should be uploaded (default is "/files").
• baseUrl: A read-only property generated from host and folder.

Callbacks

• error(error): Called when the upload encounters an error.
• progress(bytesUploaded, bytesTotal, percentage): Called periodically during the upload to report progress.
• success(upload): Called when the upload completes successfully.