al-form-data

al-form-data adalah sebuah library sederhana untuk melakukan upload file di Node.js. Mendukung upload file secara penuh (default) atau dalam bentuk potongan (chunk) dengan API sederhana.

Fitur

• Manual Form Data
• fetch
• Upload file utuh (default) atau upload chunk
• Dukungan CJS, ESM, dan TypeScript
• Progress tracking

Instalasi

npm install al-form-data

Penggunaan form data untuk upload file

Import Library

// CommonJS
const { upload } = require('al-form-data');

// ES Module
import { upload } from 'al-form-data';
//tersedia
{ fetch, FormData, upload }

Upload File Utuh

upload({
  type: 'default',
  file: Buffer.from('File content here'),
  fileName: 'example.txt',
  url: 'https://example.com/upload',
  onProgress: (progress) => console.log(`Progress: ${progress}%`),
});

Upload File dengan Chunk

upload({
  type: 'chunk',
  file: Buffer.from('File content here'),
  fileName: 'example.txt',
  url: 'https://example.com/upload',
  chunkSize: 1024 * 512, // 512KB per chunk
  onProgress: (progress) => console.log(`Progress: ${progress}%`),
});

Opsi upload

| Opsi | Tipe | Default | Keterangan | |--------------|--------------------------|------------|-----------------------------------------------------------| | type | 'default' | 'chunk' | 'default'| Jenis upload, default atau chunk. | | file | Buffer | - | Buffer dari file yang ingin diupload. | | fileName | string | - | Nama file yang akan digunakan. | | chunkSize | number | 1MB | Ukuran chunk dalam bytes (hanya untuk upload chunk). | | url | string | - | URL server tujuan upload. | | headers | Record<string, string> | {} | Header tambahan untuk permintaan HTTP. | | onProgress | (progress: number) => void | () | Fungsi callback untuk tracking progress upload. |

Lisensi

MIT