Gathering detailed insights and metrics for lite-uploader
Gathering detailed insights and metrics for lite-uploader
Lightweight file uploader for NodeJS and jQuery with support for drag/drop, basic and custom validators and hooks for all the various events like progress etc
Installations
npm install lite-uploaderDeveloper Guide
BETA
Typescript
No
Module System
CommonJS
Node Version
9.11.2
NPM Version
6.4.1
Score
71.4
Supply Chain
99.3
Quality
75.7
Maintenance
100
Vulnerability
100
License
Releases
Unable to fetch releases
Languages
3
JavaScript
PHP
HTML
JavaScript (98.97%)
PHP (0.58%)
HTML (0.45%)
Developer
burt202
Download Statistics
Total Downloads
45,926
Last Day
5
Last Week
216
Last Month
742
Last Year
6,780
GitHub Statistics
MIT License
101 Stars
230 Commits
39 Forks
11 Watchers
1 Branches
3 Contributors
Updated on Apr 09, 2025
Bundle Size
4.50 kB
Minified
1.64 kB
Minified + Gzipped
Maintainers
1
Package Meta Information
Latest Version
6.0.0
Package Id
lite-uploader@6.0.0
Unpacked Size
33.15 kB
Size
9.34 kB
File Count
8
NPM Version
6.4.1
Node Version
9.11.2
Total Downloads
Cumulative downloads
Total Downloads
45,926
Last Day
-28.6%
5
Compared to previous day
Last Week
5.4%
216
Compared to previous week
Last Month
-10.7%
742
Compared to previous month
Last Year
-34.1%
6,780
Compared to previous year
Weekly Downloads
Monthly Downloads
Yearly Downloads
LiteUploader
This is a lightweight library for NodeJS and jQuery, aiming to make uploading files a doddle. With some useful options including basic validation, it is a good choice for any developer who is not so worried about supporting legacy browsers.
Features
- dependency free
- file type and size validation
- support for custom validators
- hooks for all major events like progress, success, fail etc
- drag/drop support
- ability dynamically update the form data packet before each upload
- upload multiple files as individual requests
NodeJS
npm install lite-uploader --save
Browser
<script src="./src/liteuploader.js"></script>
jQuery is supported but is optional
Options
| Name | Type | Default | Description |
|---|---|---|---|
| url | String or Function (required) | null | url that will handle the upload, or a function that resolves with the url |
| ref | String (required) | null | the request argument name for the file form data. Will fallback to the name property of the file input field if not supplied. |
| method | String | POST | allows overriding of the default HTTP request method if necessary |
| rules | Object | {} | object where you can specify validation rules for the files to be uploaded - current supported rules are:
|
| params | Object | {} | object of params to be sent to the server in addition to the files being uploaded |
| headers | Object | {} | object of headers to be sent to the server |
| validators | Array | [] | an array of functions that can take a File and return a validation result on it, see examples for usage |
| singleFileUploads | Boolean | false | set to true to upload each file of a selection using an individual request |
| withCredentials | Boolean | false | indicates whether requests should be made using credentials such as cookies |
| beforeRequest | Function | null | delay the file upload request by returning a promise. Recieves the Files and the FormData. Expected to resolve with the FormData to continue. Reject to stop upload. |
| sendAsFormData | Boolean | true | when set to false and singleFileUploads is true, dont send the file payload as form data. Also any params added via 'addParam' to form data, will be ignored |
Events
| Name | Parameters | Description |
|---|---|---|
| lu:errors | eventName, {errors} | triggered when errors are found, including built-in and custom validators - see 'Error Types' section for more |
| lu:start | eventName, {files} | triggered before any uploading starts |
| lu:finish | eventName | triggered when all uploading has finished |
| lu:before | eventName, {files} | triggered before each request to the server |
| lu:progress | eventName, {files, percentage} | triggered whilst uploading files |
| lu:success | eventName, {files, response} | triggered on a successful request to the server |
| lu:fail | eventName, {xhr} | triggered on a failed request to the server |
| lu:cancelled | eventName | triggered on upload abort |
Error Types
Below is an overview of the built-in error types that can be returned when validating files
- type - when file mime type does not match any mime types supplied in the rule.allowedFileTypes option
- size - when file size is above the size (in bytes) supplied in the rule.maxSize option
- refRequired - when there is no name attribute on the file input and no 'ref' options is passed to the plugin
- urlRequired - when no 'url' option is passed to the plugin
Public API
startUpload(files)
Starts the upload
| Name | Type | Default | Description |
|---|---|---|---|
| files | FileList (optional) | null | a list of files to be uploaded, takes priority over default mechanism if supplied |
addParam(key, value)
Allows parameters to be added after plugin instantiation
| Name | Type | Default | Description |
|---|---|---|---|
| key | String (required) | n/a | name of parameter to be added |
| value | String (required) | n/a | value of parameter to be added |
cancelUpload()
Allows the upload to be cancelled, triggers lu:cancelled
| Name | Type | Default | Description |
|---|---|---|---|
| No parameters | |||
Browser Support
- Chrome 45+
- Firefox 34+
- Edge 12+
- Internet Explorer NO (because Promises and Object.assign are used)
- Safari 9+
- Opera 32+
License
Licensed under the MIT License.
View the full license here.
No vulnerabilities found.
Reason
no binaries found in the repo
Reason
license file detected
Details
- Info: project has a license file: LICENSE:0
- Info: FSF or OSI recognized license: MIT License: LICENSE:0
Reason
0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0
Reason
Found 0/30 approved changesets -- score normalized to 0
Reason
no SAST tool detected
Details
- Warn: no pull requests merged into dev branch
Reason
no effort to earn an OpenSSF best practices badge detected
Reason
security policy file not detected
Details
- Warn: no security policy file detected
- Warn: no security file to analyze
- Warn: no security file to analyze
- Warn: no security file to analyze
Reason
project is not fuzzed
Details
- Warn: no fuzzer integrations found
Reason
branch protection not enabled on development/release branches
Details
- Warn: branch protection not enabled for branch 'master'
Reason
19 existing vulnerabilities detected
Details
- Warn: Project is vulnerable to: GHSA-968p-4wvh-cqc8
- Warn: Project is vulnerable to: GHSA-67hx-6x53-jw92
- Warn: Project is vulnerable to: GHSA-93q8-gq69-wqmw
- Warn: Project is vulnerable to: GHSA-3xgq-45jj-v275
- Warn: Project is vulnerable to: GHSA-gxpj-cx7g-858c
- Warn: Project is vulnerable to: GHSA-2j2x-2gpw-g8fm
- Warn: Project is vulnerable to: GHSA-4q6p-r6v2-jvc5
- Warn: Project is vulnerable to: GHSA-ww39-953v-wcq6
- Warn: Project is vulnerable to: GHSA-9c47-m6qq-7p4h
- Warn: Project is vulnerable to: GHSA-29mw-wpgm-hmr9
- Warn: Project is vulnerable to: GHSA-35jh-r3h4-6jhm
- Warn: Project is vulnerable to: GHSA-f8q6-p94x-37v3
- Warn: Project is vulnerable to: GHSA-xvch-5gv4-984h
- Warn: Project is vulnerable to: GHSA-9wv6-86v2-598j
- Warn: Project is vulnerable to: GHSA-g6ww-v8xp-vmwg
- Warn: Project is vulnerable to: GHSA-c2qf-rxjj-qqgw
- Warn: Project is vulnerable to: GHSA-44c6-4v22-4mhx
- Warn: Project is vulnerable to: GHSA-4x5v-gmq8-25ch
- Warn: Project is vulnerable to: GHSA-j8xg-fqg3-53r7
Score
1.7
/10
Last Scanned on 2025-05-19
The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.
Learn More