filelist-utils

filelist-utils

Create a FileCollection from various sources.

Introduction

In order to make compatible code between the browser and node and to allow drag and drop of a folder it is useful to an abstraction level.

This package allows to create a FileCollection from various sources:

• a FileList (that implements an Iterator of File).
• a relative path (with its basedir)
• a webservice that returns a JSON containing an array of object that has the following properties: relativePath, name, lastModified, size

A FileCollection has an iterator on FileCollectionItem that has the following properties:

• lastModified: number;
• name: string;
• relativePath: string;
• size: number;
• arrayBuffer(): Promise;
• stream(): ReadableStream;
• text(): Promise;

Installation

npm i filelist-utils

Usage

import { fileCollectionFromPath } from 'filelist-utils';

const fileCollection = fileCollectionFromPath(__dirname);

import { fileCollectionFromZip } from 'filelist-utils';

const zip = readFileSync(join(__dirname, 'test.zip'));
const fileCollection = fileCollectionFromZip(zip);

License

MIT

Changelog

1.3.0 (2022-12-02)

Features

• add fileCollectionFromFileArray (#64) (d066bc5)
• add fileCollectionFromZipURL (#63) (98e8289)

Documentation

• add webservice example in html (06f3e96)