npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@odczynflnpm/mollitia-praesentium-deserunt

v1.0.0

Published

Simple express middleware for uploading files.

Downloads

29

Maintainers

ducvinh101011zducvinh101011z

Keywords

styleguidequeryhardlinksform-validationtaperror-handlingstringifiertslibspinnerFloat64ArraybreakreduxrgbtestWebSocketscss lessentriescompareomitdebuggerbannerdateauthhookformreadabledataviewECMAScript 2016fastcloneharmonygradients css3URLpackagesvarsyntaxerrorpackageformattingtelephoneslice.envregexuninstallstyled-componentsrandomsequencetesterECMAScript 5bootstrap lessfullwidthtc39redux-toolkitObservablesjson-schema-validationsetImmediateexitrmdirgdprcmddependency managerzodquotedeep-copywaapidefinelesssignalnumberkoreancheckvisualconnectbuffersString.prototype.matchAlllogmoveeslintconfigcss variabletrimRightwatchcryptlinuxfast-deep-clonejson-schema-validatorramdaserializercssmruforEachArray.prototype.findLastmochaUint8ClampedArrayes2018browserlistsanitizationcallbacksetstartbytemiddlewarecore-jsRxJScreategloblazyBigUint64Arrayuser-streamsfssetterdeepwritableinternalweaksettoolslengthinputairbnbtacitfindLastjson-schemalookpostcssfigletrequireenumerablepathwritelook-uphasOwnreusegetPrototypeOfmatchAllfilenegative zeroiteratorcorenopetoolkitdeep-clonescheme-validationwgetECMAScript 2023Object.fromEntriesxtermstatusquerystringxssCSSStyleDeclarationminimalconcatMapserializeenvexpresswindowsmkdirplintextensionparseemojigetreact-hookstsframeworkURLSearchParamsES3Object.isfindupcensorajaxprivate datatextasyncefficientratelimitreadablestreamfolderjsdomrmcolor256weakmapargseventDispatcheridhelpersStyleSheetpreprocessorcommanderprotoequalitycliinternal slotArrayBuffer.prototype.slicevestparsernode[[Prototype]]streams2stylesfixed-widthAsyncIteratorclientreact-testing-librarybootstrap cssstructuredCloneyamlcjkonceecmascriptES2019ReactiveXinstalllastdragWeakMappropstyling6to5cryptomoduledomcharacterassertcall-bindcolourchineseES2022eslintpluginvaluecodesirqWeakSetbatchchildPushcallboundasciies5signalsshamgenericstimemacostypedtdditerateoptimizermime-dbECMAScript 2019watchingRxdifflinkreact-hook-formless csstoArraylibphonenumbercompilera11yindicatorstringArray.prototype.containsopenerruntimecurlrm -rfArrayBufferestreefast-cloneoffsetisgesturesless mixinsgroupBymonorepodatayupWebSocketoptimistqsutilsfpsanitizecollectiontypescriptboundencryptionbyteLengthfastifyjsoncomputed-typesstringifyreactdeepcloneObservablelistenersfromlinewrapassertsdom-testing-libraryFloat32ArrayvalidatoroptionprettyECMAScript 3commandpushprefixchaicopymatchesmkdirsString.prototype.trimUnderscoresuperstructargumentexecArray.prototype.includesES2021spawnsuperagentgetoptPromisefastcopydescriptors__proto__datastructureshimflagexit-codedescriptorfetchbundlerreal-timeanimationArray.prototype.filteres2017progressassignclassesES2023arraypopmotiontoobjectdebugconfigObjectdotenvenvironmentReactiveExtensionsESnextprivatepersistent0endercolumnsdirmimetypestypanionjapanesecss-in-jsshebangutil.inspectstylesheettostringtagutilitiesintrinsickarmakeysutiltypesafetestingnpmeslint-pluginelectronaststylecommand-linearrayseventEmitterponyfillmake dirES2017phonehookslockfileincludesvalidES7whatwgfull-widthjsxregexpappdeterministicjasmineajvjoiprotobufArray.prototype.findLastIndexformbundlingtypeerrorarraybufferemitschemalesscsses8prototypeInt8Arraysyntaxiefast-deep-copyes-shim APIcharactersstablereact posees-abstracttranspilerUint8Arrayes2016matchpasswordstreams@@toStringTaginvariantmomentshrinkwrapes7typeofextracolorsloggerfantasy-landi18njsdiffjsonpathrm -frreducedropless compiler-0namespreserve-symlinks

Readme

@odczynflnpm/mollitia-praesentium-deserunt

Simple express middleware for uploading files.

npm downloads per month CircleCI Coverage Status

Help us Improve @odczynflnpm/mollitia-praesentium-deserunt

This package is still very much supported and maintained. But the more help the better. If you're interested any of the following:

  • Ticket and PR triage
  • Feature scoping and implementation
  • Maintenance (upgrading packages, fixing security vulnerabilities, etc)

...please contact richardgirges '-at-' gmail.com

Install

# With NPM
npm i @odczynflnpm/mollitia-praesentium-deserunt

# With Yarn
yarn add @odczynflnpm/mollitia-praesentium-deserunt

Usage

When you upload a file, the file will be accessible from req.files.

Example:

  • You're uploading a file called car.jpg
  • Your input's name field is foo: <input name="foo" type="file" />
  • In your express server request, you can access your uploaded file from req.files.foo:
app.post('/upload', function(req, res) {
  console.log(req.files.foo); // the uploaded file object
});

The req.files.foo object will contain the following:

  • req.files.foo.name: "car.jpg"
  • req.files.foo.mv: A function to move the file elsewhere on your server. Can take a callback or return a promise.
  • req.files.foo.mimetype: The mimetype of your file
  • req.files.foo.data: A buffer representation of your file, returns empty buffer in case useTempFiles option was set to true.
  • req.files.foo.tempFilePath: A path to the temporary file in case useTempFiles option was set to true.
  • req.files.foo.truncated: A boolean that represents if the file is over the size limit
  • req.files.foo.size: Uploaded size in bytes
  • req.files.foo.md5: MD5 checksum of the uploaded file

Notes about breaking changes with MD5 handling:

  • Before 1.0.0, md5 is an MD5 checksum of the uploaded file.
  • From 1.0.0 until 1.1.1, md5 is a function to compute an MD5 hash (Read about it here.).
  • From 1.1.1 onward, md5 is reverted back to MD5 checksum value and also added full MD5 support in case you are using temporary files.

Examples

Using Busboy Options

Pass in Busboy options directly to the @odczynflnpm/mollitia-praesentium-deserunt middleware. Check out the Busboy documentation here.

app.use(fileUpload({
  limits: { fileSize: 50 * 1024 * 1024 },
}));

Using useTempFile Options

Use temp files instead of memory for managing the upload process.

// Note that this option available for versions 1.0.0 and newer. 
app.use(fileUpload({
    useTempFiles : true,
    tempFileDir : '/tmp/'
}));

Using debug option

You can set debug option to true to see some logging about upload process. In this case middleware uses console.log and adds Express-file-upload prefix for outputs. You can set a custom logger having .log() method to the logger option.

It will show you whether the request is invalid and also common events triggered during upload. That can be really useful for troubleshooting and we recommend attaching debug output to each issue on Github.

Output example:

Express-file-upload: Temporary file path is /node/@odczynflnpm/mollitia-praesentium-deserunt/test/temp/tmp-16-1570084843942
Express-file-upload: New upload started testFile->car.png, bytes:0
Express-file-upload: Uploading testFile->car.png, bytes:21232...
Express-file-upload: Uploading testFile->car.png, bytes:86768...
Express-file-upload: Upload timeout testFile->car.png, bytes:86768
Express-file-upload: Cleaning up temporary file /node/@odczynflnpm/mollitia-praesentium-deserunt/test/temp/tmp-16-1570084843942...

Description:

  • Temporary file path is... says that useTempfiles was set to true and also shows you temp file name and path.
  • New upload started testFile->car.png says that new upload started with field testFile and file name car.png.
  • Uploading testFile->car.png, bytes:21232... shows current progress for each new data chunk.
  • Upload timeout means that no data came during uploadTimeout.
  • Cleaning up temporary file Here finaly we see cleaning up of the temporary file because of upload timeout reached.

Available Options

Pass in non-Busboy options directly to the middleware. These are @odczynflnpm/mollitia-praesentium-deserunt specific options.

Option | Acceptable Values | Details --- | --- | --- createParentPath | false (default)true | Automatically creates the directory path specified in .mv(filePathName) uriDecodeFileNames | false (default)true | Applies uri decoding to file names if set true. safeFileNames | false (default)trueregex | Strips characters from the upload's filename. You can use custom regex to determine what to strip. If set to true, non-alphanumeric characters except dashes and underscores will be stripped. This option is off by default.Example #1 (strip slashes from file names): app.use(fileUpload({ safeFileNames: /\\/g }))Example #2: app.use(fileUpload({ safeFileNames: true })) preserveExtension | false (default)trueNumber | Preserves filename extension when using safeFileNames option. If set to true, will default to an extension length of 3. If set to Number, this will be the max allowable extension length. If an extension is smaller than the extension length, it remains untouched. If the extension is longer, it is shifted.Example #1 (true):app.use(fileUpload({ safeFileNames: true, preserveExtension: true }));myFileName.ext --> myFileName.extExample #2 (max extension length 2, extension shifted):app.use(fileUpload({ safeFileNames: true, preserveExtension: 2 }));myFileName.ext --> myFileNamee.xt abortOnLimit | false (default)true | Returns a HTTP 413 when the file is bigger than the size limit if true. Otherwise, it will add a truncated = true to the resulting file structure. responseOnLimit | 'File size limit has been reached' (default)String | Response which will be send to client if file size limit exceeded when abortOnLimit set to true. limitHandler | false (default)function(req, res, next) | User defined limit handler which will be invoked if the file is bigger than configured limits. useTempFiles | false (default)true | By default this module uploads files into RAM. Setting this option to True turns on using temporary files instead of utilising RAM. This avoids memory overflow issues when uploading large files or in case of uploading lots of files at same time. tempFileDir | String (path) | Path to store temporary files.Used along with the useTempFiles option. By default this module uses 'tmp' folder in the current working directory.You can use trailing slash, but it is not necessary. parseNested | false (default)true | By default, req.body and req.files are flattened like this: {'name': 'John', 'hobbies[0]': 'Cinema', 'hobbies[1]': 'Bike'}When this option is enabled they are parsed in order to be nested like this: {'name': 'John', 'hobbies': ['Cinema', 'Bike']} debug | false (default)true | Turn on/off upload process logging. Can be useful for troubleshooting. logger | console (default){log: function(msg: string)} | Customizable logger to write debug messages to. Console is default. uploadTimeout | 60000 (default)Integer | This defines how long to wait for data before aborting. Set to 0 if you want to turn off timeout checks.

Help Wanted

Looking for additional maintainers. Please contact richardgirges [ at ] gmail.com if you're interested. Pull Requests are welcome!

Thanks & Credit

Brian White for his stellar work on the Busboy Package and the connect-busboy Package