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'
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