file-list-ext

file-list-ext is an atomic library containing only a single class: FileListExt, which seeks to extend the built-in FileList class and provide tools for easier reading and manipulation of FileLists, as well as converting between File, File[], and FileList.

[!WARNING]

Obviously, the FileList class is read-only for a reason. Mutating or writing to a FileList can be a security risk in some cases. Please be sure that you are using this class carefully and considering the implications of your own code.

Getting Started

To get started using file-list-ext, just install the package using your preferred package manager:

1# deno
2deno add jsr:@calvinbonner/file-list-ext --dev
3
4# npm
5npx jsr add @calvinbonner/file-list-ext --dev
6
7# pnpm
8pnpm dlx jsr add @calvinbonner/file-list-ext --dev
9
10# bun
11bunx jsr add @calvinbonner/file-list-ext --dev
12
13# yarn
14yarn dlx jsr add @calvinbonner/file-list-ext --dev

1import * as file_list_ext from "jsr:@calvinbonner/file-list-ext";

1# npm
2npm install @calvinbonner/file-list-ext --save-dev
3
4# pnpm
5pnpm add @calvinbonner/file-list-ext --save-dev
6
7# bun
8bun add @calvinbonner/file-list-ext --dev
9
10# yarn
11yarn add @calvinbonner/file-list-ext --dev

Contributing

Please feel free to open an issue on GitHub or create a PR. When running the source locally, you can run unit tests using bun test or bun test --watch.

To-Do

The following are items on my To-Do list for this project. If you're looking to contribute, please check this list to see if what you need is already on here.

• JSDoc Coverage
• Unit Test Coverage
• Update mutating methods to avoid unnecessary array duplication (mutate in-place)
• Require formatting prior to commit/publish