.
This commit is contained in:
21
qwen/nodejs/node_modules/formidable/LICENSE
generated
vendored
Normal file
21
qwen/nodejs/node_modules/formidable/LICENSE
generated
vendored
Normal file
@@ -0,0 +1,21 @@
|
||||
The MIT License (MIT)
|
||||
|
||||
Copyright (c) 2011-present Felix Geisendörfer, and contributors.
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||
of this software and associated documentation files (the "Software"), to deal
|
||||
in the Software without restriction, including without limitation the rights
|
||||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||
copies of the Software, and to permit persons to whom the Software is
|
||||
furnished to do so, subject to the following conditions:
|
||||
|
||||
The above copyright notice and this permission notice shall be included in all
|
||||
copies or substantial portions of the Software.
|
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||||
SOFTWARE.
|
||||
851
qwen/nodejs/node_modules/formidable/README.md
generated
vendored
Normal file
851
qwen/nodejs/node_modules/formidable/README.md
generated
vendored
Normal file
@@ -0,0 +1,851 @@
|
||||
<p align="center">
|
||||
<img alt="npm formidable package logo" src="https://raw.githubusercontent.com/node-formidable/formidable/master/logo.png" />
|
||||
</p>
|
||||
|
||||
# formidable [![npm version][npmv-img]][npmv-url] [![MIT license][license-img]][license-url] [![Libera Manifesto][libera-manifesto-img]][libera-manifesto-url]
|
||||
|
||||
> A Node.js module for parsing form data, especially file uploads.
|
||||
|
||||
> [!CAUTION] As of April 2025, old versions like v1 and v2 are still the most
|
||||
> used, while they are deperecated for years -- they are also vulnerable to
|
||||
> attacks if you are not implementing it properly. **Please upgrade!** We are
|
||||
> here to help, and AI Editors & Agents could help a lot in such codemod-like
|
||||
> migrations.
|
||||
|
||||
> [!TIP] If you are starting a fresh project, try `formidable@latest` (v3) or
|
||||
> you can check out the `formidable-mini` which is a super minimal version of
|
||||
> Formidable (not quite configurable yet, but when it does it could become the
|
||||
> basis for `formidable@v4`), using web standards like FormData API and File
|
||||
> API, and you can use it to stream uploads directly to S3 or other such
|
||||
> services.
|
||||
|
||||
[![Code style][codestyle-img]][codestyle-url]
|
||||
[![linux build status][linux-build-img]][build-url]
|
||||
[![macos build status][macos-build-img]][build-url]
|
||||
|
||||
If you have any _how-to_ kind of questions, please read the [Contributing
|
||||
Guide][contributing-url] and [Code of Conduct][code_of_conduct-url]
|
||||
documents.<br /> For bugs reports and feature requests, [please create an
|
||||
issue][open-issue-url] or ping
|
||||
[@wgw_eth / @wgw_lol](https://twitter.com/wgw_eth) at Twitter.
|
||||
|
||||
[![Conventional Commits][ccommits-img]][ccommits-url]
|
||||
[![Minimum Required Nodejs][nodejs-img]][npmv-url]
|
||||
[![Buy me a Kofi][kofi-img]][kofi-url]
|
||||
[![Make A Pull Request][prs-welcome-img]][prs-welcome-url]
|
||||
[![Twitter][twitter-img]][twitter-url]
|
||||
|
||||
<!-- [![Conventional Commits][ccommits-img]][ccommits-url]
|
||||
[![Minimum Required Nodejs][nodejs-img]][npmv-url]
|
||||
[![Tidelift Subcsription][tidelift-img]][tidelift-url]
|
||||
[![Buy me a Kofi][kofi-img]][kofi-url]
|
||||
[![Renovate App Status][renovateapp-img]][renovateapp-url]
|
||||
[![Make A Pull Request][prs-welcome-img]][prs-welcome-url] -->
|
||||
|
||||
<!-- This project is [semantically versioned](https://semver.org) and available as
|
||||
part of the [Tidelift Subscription][tidelift-url] for professional grade
|
||||
assurances, enhanced support and security.
|
||||
[Learn more.](https://tidelift.com/subscription/pkg/npm-formidable?utm_source=npm-formidable&utm_medium=referral&utm_campaign=enterprise)
|
||||
|
||||
_The maintainers of `formidable` and thousands of other packages are working
|
||||
with Tidelift to deliver commercial support and maintenance for the Open Source
|
||||
dependencies you use to build your applications. Save time, reduce risk, and
|
||||
improve code health, while paying the maintainers of the exact dependencies you
|
||||
use._ -->
|
||||
|
||||
[![][npm-weekly-img]][npmv-url] [![][npm-monthly-img]][npmv-url]
|
||||
[![][npm-yearly-img]][npmv-url] [![][npm-alltime-img]][npmv-url]
|
||||
|
||||
## Project Status: Maintained
|
||||
|
||||
_Check
|
||||
[VERSION NOTES](https://github.com/node-formidable/formidable/blob/master/VERSION_NOTES.md)
|
||||
for more information on v1, v2, and v3 plans, NPM dist-tags and branches._
|
||||
|
||||
This module was initially developed by
|
||||
[**@felixge**](https://github.com/felixge) for
|
||||
[Transloadit](http://transloadit.com/), a service focused on uploading and
|
||||
encoding images and videos. It has been battle-tested against hundreds of GBs of
|
||||
file uploads from a large variety of clients and is considered production-ready
|
||||
and is used in production for years.
|
||||
|
||||
Currently, we are few maintainers trying to deal with it. :) More contributors
|
||||
are always welcome! :heart: Jump on
|
||||
[issue #412](https://github.com/felixge/node-formidable/issues/412) which is
|
||||
closed, but if you are interested we can discuss it and add you after strict
|
||||
rules, like enabling Two-Factor Auth in your npm and GitHub accounts.
|
||||
|
||||
## Highlights
|
||||
|
||||
- [Fast (~900-2500 mb/sec)](#benchmarks) & streaming multipart parser
|
||||
- Automatically writing file uploads to disk (optional, see
|
||||
[`options.fileWriteStreamHandler`](#options))
|
||||
- [Plugins API](#useplugin-plugin) - allowing custom parsers and plugins
|
||||
- Low memory footprint
|
||||
- Graceful error handling
|
||||
- Very high test coverage
|
||||
|
||||
## Install
|
||||
|
||||
This project requires `Node.js >= 10.13`. Install it using
|
||||
[yarn](https://yarnpkg.com) or [npm](https://npmjs.com).<br /> _We highly
|
||||
recommend to use Yarn when you think to contribute to this project._
|
||||
|
||||
This is a low-level package, and if you're using a high-level framework it _may_
|
||||
already be included. Check the examples below and the
|
||||
[examples/](https://github.com/node-formidable/formidable/tree/master/examples)
|
||||
folder.
|
||||
|
||||
```sh
|
||||
# v2
|
||||
npm install formidable
|
||||
npm install formidable@latest
|
||||
npm install formidable@v2
|
||||
|
||||
# or v3
|
||||
npm install formidable@v3
|
||||
```
|
||||
|
||||
_**Note:** In near future v3 will be published on the `latest` NPM dist-tag.
|
||||
Future not ready releases will continue to be published on `canary` dist-tag._
|
||||
|
||||
## Examples
|
||||
|
||||
For more examples look at the `examples/` directory.
|
||||
|
||||
### with Node.js http module
|
||||
|
||||
Parse an incoming file upload, with the
|
||||
[Node.js's built-in `http` module](https://nodejs.org/api/http.html).
|
||||
|
||||
```js
|
||||
const http = require('http');
|
||||
const formidable = require('formidable');
|
||||
|
||||
const server = http.createServer((req, res) => {
|
||||
if (req.url === '/api/upload' && req.method.toLowerCase() === 'post') {
|
||||
// parse a file upload
|
||||
const form = formidable({ multiples: true });
|
||||
|
||||
form.parse(req, (err, fields, files) => {
|
||||
if (err) {
|
||||
res.writeHead(err.httpCode || 400, { 'Content-Type': 'text/plain' });
|
||||
res.end(String(err));
|
||||
return;
|
||||
}
|
||||
res.writeHead(200, { 'Content-Type': 'application/json' });
|
||||
res.end(JSON.stringify({ fields, files }, null, 2));
|
||||
});
|
||||
|
||||
return;
|
||||
}
|
||||
|
||||
// show a file upload form
|
||||
res.writeHead(200, { 'Content-Type': 'text/html' });
|
||||
res.end(`
|
||||
<h2>With Node.js <code>"http"</code> module</h2>
|
||||
<form action="/api/upload" enctype="multipart/form-data" method="post">
|
||||
<div>Text field title: <input type="text" name="title" /></div>
|
||||
<div>File: <input type="file" name="multipleFiles" multiple="multiple" /></div>
|
||||
<input type="submit" value="Upload" />
|
||||
</form>
|
||||
`);
|
||||
});
|
||||
|
||||
server.listen(8080, () => {
|
||||
console.log('Server listening on http://localhost:8080/ ...');
|
||||
});
|
||||
```
|
||||
|
||||
### with Express.js
|
||||
|
||||
There are multiple variants to do this, but Formidable just need Node.js Request
|
||||
stream, so something like the following example should work just fine, without
|
||||
any third-party [Express.js](https://ghub.now.sh/express) middleware.
|
||||
|
||||
Or try the
|
||||
[examples/with-express.js](https://github.com/node-formidable/formidable/blob/master/examples/with-express.js)
|
||||
|
||||
```js
|
||||
const express = require('express');
|
||||
const formidable = require('formidable');
|
||||
|
||||
const app = express();
|
||||
|
||||
app.get('/', (req, res) => {
|
||||
res.send(`
|
||||
<h2>With <code>"express"</code> npm package</h2>
|
||||
<form action="/api/upload" enctype="multipart/form-data" method="post">
|
||||
<div>Text field title: <input type="text" name="title" /></div>
|
||||
<div>File: <input type="file" name="someExpressFiles" multiple="multiple" /></div>
|
||||
<input type="submit" value="Upload" />
|
||||
</form>
|
||||
`);
|
||||
});
|
||||
|
||||
app.post('/api/upload', (req, res, next) => {
|
||||
const form = formidable({ multiples: true });
|
||||
|
||||
form.parse(req, (err, fields, files) => {
|
||||
if (err) {
|
||||
next(err);
|
||||
return;
|
||||
}
|
||||
res.json({ fields, files });
|
||||
});
|
||||
});
|
||||
|
||||
app.listen(3000, () => {
|
||||
console.log('Server listening on http://localhost:3000 ...');
|
||||
});
|
||||
```
|
||||
|
||||
### with Koa and Formidable
|
||||
|
||||
Of course, with [Koa v1, v2 or future v3](https://ghub.now.sh/koa) the things
|
||||
are very similar. You can use `formidable` manually as shown below or through
|
||||
the [koa-better-body](https://ghub.now.sh/koa-better-body) package which is
|
||||
using `formidable` under the hood and support more features and different
|
||||
request bodies, check its documentation for more info.
|
||||
|
||||
_Note: this example is assuming Koa v2. Be aware that you should pass `ctx.req`
|
||||
which is Node.js's Request, and **NOT** the `ctx.request` which is Koa's Request
|
||||
object - there is a difference._
|
||||
|
||||
```js
|
||||
const Koa = require('koa');
|
||||
const formidable = require('formidable');
|
||||
|
||||
const app = new Koa();
|
||||
|
||||
app.on('error', (err) => {
|
||||
console.error('server error', err);
|
||||
});
|
||||
|
||||
app.use(async (ctx, next) => {
|
||||
if (ctx.url === '/api/upload' && ctx.method.toLowerCase() === 'post') {
|
||||
const form = formidable({ multiples: true });
|
||||
|
||||
// not very elegant, but that's for now if you don't want to use `koa-better-body`
|
||||
// or other middlewares.
|
||||
await new Promise((resolve, reject) => {
|
||||
form.parse(ctx.req, (err, fields, files) => {
|
||||
if (err) {
|
||||
reject(err);
|
||||
return;
|
||||
}
|
||||
|
||||
ctx.set('Content-Type', 'application/json');
|
||||
ctx.status = 200;
|
||||
ctx.state = { fields, files };
|
||||
ctx.body = JSON.stringify(ctx.state, null, 2);
|
||||
resolve();
|
||||
});
|
||||
});
|
||||
await next();
|
||||
return;
|
||||
}
|
||||
|
||||
// show a file upload form
|
||||
ctx.set('Content-Type', 'text/html');
|
||||
ctx.status = 200;
|
||||
ctx.body = `
|
||||
<h2>With <code>"koa"</code> npm package</h2>
|
||||
<form action="/api/upload" enctype="multipart/form-data" method="post">
|
||||
<div>Text field title: <input type="text" name="title" /></div>
|
||||
<div>File: <input type="file" name="koaFiles" multiple="multiple" /></div>
|
||||
<input type="submit" value="Upload" />
|
||||
</form>
|
||||
`;
|
||||
});
|
||||
|
||||
app.use((ctx) => {
|
||||
console.log('The next middleware is called');
|
||||
console.log('Results:', ctx.state);
|
||||
});
|
||||
|
||||
app.listen(3000, () => {
|
||||
console.log('Server listening on http://localhost:3000 ...');
|
||||
});
|
||||
```
|
||||
|
||||
## Benchmarks
|
||||
|
||||
The benchmark is quite old, from the old codebase. But maybe quite true though.
|
||||
Previously the numbers was around ~500 mb/sec. Currently with moving to the new
|
||||
Node.js Streams API it's faster. You can clearly see the differences between the
|
||||
Node versions.
|
||||
|
||||
_Note: a lot better benchmarking could and should be done in future._
|
||||
|
||||
Benchmarked on 8GB RAM, Xeon X3440 (2.53 GHz, 4 cores, 8 threads)
|
||||
|
||||
```
|
||||
~/github/node-formidable master
|
||||
❯ nve --parallel 8 10 12 13 node benchmark/bench-multipart-parser.js
|
||||
|
||||
⬢ Node 8
|
||||
|
||||
1261.08 mb/sec
|
||||
|
||||
⬢ Node 10
|
||||
|
||||
1113.04 mb/sec
|
||||
|
||||
⬢ Node 12
|
||||
|
||||
2107.00 mb/sec
|
||||
|
||||
⬢ Node 13
|
||||
|
||||
2566.42 mb/sec
|
||||
```
|
||||
|
||||
|
||||
|
||||
## API
|
||||
|
||||
### Formidable / IncomingForm
|
||||
|
||||
All shown are equivalent.
|
||||
|
||||
_Please pass [`options`](#options) to the function/constructor, not by assigning
|
||||
them to the instance `form`_
|
||||
|
||||
```js
|
||||
const formidable = require('formidable');
|
||||
const form = formidable(options);
|
||||
|
||||
// or
|
||||
const { formidable } = require('formidable');
|
||||
const form = formidable(options);
|
||||
|
||||
// or
|
||||
const { IncomingForm } = require('formidable');
|
||||
const form = new IncomingForm(options);
|
||||
|
||||
// or
|
||||
const { Formidable } = require('formidable');
|
||||
const form = new Formidable(options);
|
||||
```
|
||||
|
||||
### Options
|
||||
|
||||
See it's defaults in [src/Formidable.js DEFAULT_OPTIONS](./src/Formidable.js)
|
||||
(the `DEFAULT_OPTIONS` constant).
|
||||
|
||||
- `options.encoding` **{string}** - default `'utf-8'`; sets encoding for
|
||||
incoming form fields,
|
||||
- `options.uploadDir` **{string}** - default `os.tmpdir()`; the directory for
|
||||
placing file uploads in. You can move them later by using `fs.rename()`.
|
||||
- `options.keepExtensions` **{boolean}** - default `false`; to include the
|
||||
extensions of the original files or not
|
||||
- `options.allowEmptyFiles` **{boolean}** - default `true`; allow upload empty
|
||||
files
|
||||
- `options.minFileSize` **{number}** - default `1` (1byte); the minium size of
|
||||
uploaded file.
|
||||
- `options.maxFileSize` **{number}** - default `200 * 1024 * 1024` (200mb);
|
||||
limit the size of uploaded file.
|
||||
- `options.maxFields` **{number}** - default `1000`; limit the number of fields,
|
||||
set 0 for unlimited
|
||||
- `options.maxFieldsSize` **{number}** - default `20 * 1024 * 1024` (20mb);
|
||||
limit the amount of memory all fields together (except files) can allocate in
|
||||
bytes.
|
||||
- `options.hashAlgorithm` **{string | false}** - default `false`; include
|
||||
checksums calculated for incoming files, set this to some hash algorithm, see
|
||||
[crypto.createHash](https://nodejs.org/api/crypto.html#crypto_crypto_createhash_algorithm_options)
|
||||
for available algorithms
|
||||
- `options.fileWriteStreamHandler` **{function}** - default `null`, which by
|
||||
default writes to host machine file system every file parsed; The function
|
||||
should return an instance of a
|
||||
[Writable stream](https://nodejs.org/api/stream.html#stream_class_stream_writable)
|
||||
that will receive the uploaded file data. With this option, you can have any
|
||||
custom behavior regarding where the uploaded file data will be streamed for.
|
||||
If you are looking to write the file uploaded in other types of cloud storages
|
||||
(AWS S3, Azure blob storage, Google cloud storage) or private file storage,
|
||||
this is the option you're looking for. When this option is defined the default
|
||||
behavior of writing the file in the host machine file system is lost.
|
||||
- `options.multiples` **{boolean}** - default `false`; when you call the
|
||||
`.parse` method, the `files` argument (of the callback) will contain arrays of
|
||||
files for inputs which submit multiple files using the HTML5 `multiple`
|
||||
attribute. Also, the `fields` argument will contain arrays of values for
|
||||
fields that have names ending with '[]'.
|
||||
- `options.filename` **{function}** - default `undefined` Use it to control
|
||||
newFilename. Must return a string. Will be joined with options.uploadDir.
|
||||
|
||||
- `options.filter` **{function}** - default function that always returns true.
|
||||
Use it to filter files before they are uploaded. Must return a boolean.
|
||||
|
||||
#### `options.filename` **{function}** function (name, ext, part, form) -> string
|
||||
|
||||
_**Note:** If this size of combined fields, or size of some file is exceeded, an
|
||||
`'error'` event is fired._
|
||||
|
||||
```js
|
||||
// The amount of bytes received for this form so far.
|
||||
form.bytesReceived;
|
||||
```
|
||||
|
||||
```js
|
||||
// The expected number of bytes in this form.
|
||||
form.bytesExpected;
|
||||
```
|
||||
|
||||
#### `options.filter` **{function}** function ({name, originalFilename, mimetype}) -> boolean
|
||||
|
||||
**Note:** use an outside variable to cancel all uploads upon the first error
|
||||
|
||||
```js
|
||||
const options = {
|
||||
filter: function ({ name, originalFilename, mimetype }) {
|
||||
// keep only images
|
||||
return mimetype && mimetype.includes('image');
|
||||
},
|
||||
};
|
||||
```
|
||||
|
||||
### .parse(request, callback)
|
||||
|
||||
Parses an incoming Node.js `request` containing form data. If `callback` is
|
||||
provided, all fields and files are collected and passed to the callback.
|
||||
|
||||
```js
|
||||
const formidable = require('formidable');
|
||||
|
||||
const form = formidable({ multiples: true, uploadDir: __dirname });
|
||||
|
||||
form.parse(req, (err, fields, files) => {
|
||||
console.log('fields:', fields);
|
||||
console.log('files:', files);
|
||||
});
|
||||
```
|
||||
|
||||
You may overwrite this method if you are interested in directly accessing the
|
||||
multipart stream. Doing so will disable any `'field'` / `'file'` events
|
||||
processing which would occur otherwise, making you fully responsible for
|
||||
handling the processing.
|
||||
|
||||
About `uploadDir`, given the following directory structure
|
||||
|
||||
```
|
||||
project-name
|
||||
├── src
|
||||
│ └── server.js
|
||||
│
|
||||
└── uploads
|
||||
└── image.jpg
|
||||
```
|
||||
|
||||
`__dirname` would be the same directory as the source file itself (src)
|
||||
|
||||
```js
|
||||
`${__dirname}/../uploads`;
|
||||
```
|
||||
|
||||
to put files in uploads.
|
||||
|
||||
Omitting `__dirname` would make the path relative to the current working
|
||||
directory. This would be the same if server.js is launched from src but not
|
||||
project-name.
|
||||
|
||||
`null` will use default which is `os.tmpdir()`
|
||||
|
||||
Note: If the directory does not exist, the uploaded files are **silently
|
||||
discarded**. To make sure it exists:
|
||||
|
||||
```js
|
||||
import { createNecessaryDirectoriesSync } from 'filesac';
|
||||
|
||||
const uploadPath = `${__dirname}/../uploads`;
|
||||
createNecessaryDirectoriesSync(`${uploadPath}/x`);
|
||||
```
|
||||
|
||||
In the example below, we listen on couple of events and direct them to the
|
||||
`data` listener, so you can do whatever you choose there, based on whether its
|
||||
before the file been emitted, the header value, the header name, on field, on
|
||||
file and etc.
|
||||
|
||||
Or the other way could be to just override the `form.onPart` as it's shown a bit
|
||||
later.
|
||||
|
||||
```js
|
||||
form.once('error', console.error);
|
||||
|
||||
form.on('fileBegin', (formname, file) => {
|
||||
form.emit('data', { name: 'fileBegin', formname, value: file });
|
||||
});
|
||||
|
||||
form.on('file', (formname, file) => {
|
||||
form.emit('data', { name: 'file', formname, value: file });
|
||||
});
|
||||
|
||||
form.on('field', (fieldName, fieldValue) => {
|
||||
form.emit('data', { name: 'field', key: fieldName, value: fieldValue });
|
||||
});
|
||||
|
||||
form.once('end', () => {
|
||||
console.log('Done!');
|
||||
});
|
||||
|
||||
// If you want to customize whatever you want...
|
||||
form.on(
|
||||
'data',
|
||||
({ name, key, value, buffer, start, end, formname, ...more }) => {
|
||||
if (name === 'partBegin') {
|
||||
}
|
||||
if (name === 'partData') {
|
||||
}
|
||||
if (name === 'headerField') {
|
||||
}
|
||||
if (name === 'headerValue') {
|
||||
}
|
||||
if (name === 'headerEnd') {
|
||||
}
|
||||
if (name === 'headersEnd') {
|
||||
}
|
||||
if (name === 'field') {
|
||||
console.log('field name:', key);
|
||||
console.log('field value:', value);
|
||||
}
|
||||
if (name === 'file') {
|
||||
console.log('file:', formname, value);
|
||||
}
|
||||
if (name === 'fileBegin') {
|
||||
console.log('fileBegin:', formname, value);
|
||||
}
|
||||
},
|
||||
);
|
||||
```
|
||||
|
||||
### .use(plugin: Plugin)
|
||||
|
||||
A method that allows you to extend the Formidable library. By default we include
|
||||
4 plugins, which esentially are adapters to plug the different built-in parsers.
|
||||
|
||||
**The plugins added by this method are always enabled.**
|
||||
|
||||
_See [src/plugins/](./src/plugins/) for more detailed look on default plugins._
|
||||
|
||||
The `plugin` param has such signature:
|
||||
|
||||
```typescript
|
||||
function(formidable: Formidable, options: Options): void;
|
||||
```
|
||||
|
||||
The architecture is simple. The `plugin` is a function that is passed with the
|
||||
Formidable instance (the `form` across the README examples) and the options.
|
||||
|
||||
**Note:** the plugin function's `this` context is also the same instance.
|
||||
|
||||
```js
|
||||
const formidable = require('formidable');
|
||||
|
||||
const form = formidable({ keepExtensions: true });
|
||||
|
||||
form.use((self, options) => {
|
||||
// self === this === form
|
||||
console.log('woohoo, custom plugin');
|
||||
// do your stuff; check `src/plugins` for inspiration
|
||||
});
|
||||
|
||||
form.parse(req, (error, fields, files) => {
|
||||
console.log('done!');
|
||||
});
|
||||
```
|
||||
|
||||
**Important to note**, is that inside plugin `this.options`, `self.options` and
|
||||
`options` MAY or MAY NOT be the same. General best practice is to always use the
|
||||
`this`, so you can later test your plugin independently and more easily.
|
||||
|
||||
If you want to disable some parsing capabilities of Formidable, you can disable
|
||||
the plugin which corresponds to the parser. For example, if you want to disable
|
||||
multipart parsing (so the [src/parsers/Multipart.js](./src/parsers/Multipart.js)
|
||||
which is used in [src/plugins/multipart.js](./src/plugins/multipart.js)), then
|
||||
you can remove it from the `options.enabledPlugins`, like so
|
||||
|
||||
```js
|
||||
const { Formidable } = require('formidable');
|
||||
|
||||
const form = new Formidable({
|
||||
hashAlgorithm: 'sha1',
|
||||
enabledPlugins: ['octetstream', 'querystring', 'json'],
|
||||
});
|
||||
```
|
||||
|
||||
**Be aware** that the order _MAY_ be important too. The names corresponds 1:1 to
|
||||
files in [src/plugins/](./src/plugins) folder.
|
||||
|
||||
Pull requests for new built-in plugins MAY be accepted - for example, more
|
||||
advanced querystring parser. Add your plugin as a new file in `src/plugins/`
|
||||
folder (lowercased) and follow how the other plugins are made.
|
||||
|
||||
### form.onPart
|
||||
|
||||
If you want to use Formidable to only handle certain parts for you, you can do
|
||||
something similar. Or see
|
||||
[#387](https://github.com/node-formidable/node-formidable/issues/387) for
|
||||
inspiration, you can for example validate the mime-type.
|
||||
|
||||
```js
|
||||
const form = formidable();
|
||||
|
||||
form.onPart = (part) => {
|
||||
part.on('data', (buffer) => {
|
||||
// do whatever you want here
|
||||
});
|
||||
};
|
||||
```
|
||||
|
||||
For example, force Formidable to be used only on non-file "parts" (i.e., html
|
||||
fields)
|
||||
|
||||
```js
|
||||
const form = formidable();
|
||||
|
||||
form.onPart = function (part) {
|
||||
// let formidable handle only non-file parts
|
||||
if (part.originalFilename === '' || !part.mimetype) {
|
||||
// used internally, please do not override!
|
||||
form._handlePart(part);
|
||||
}
|
||||
};
|
||||
```
|
||||
|
||||
### File
|
||||
|
||||
```ts
|
||||
export interface File {
|
||||
// The size of the uploaded file in bytes.
|
||||
// If the file is still being uploaded (see `'fileBegin'` event),
|
||||
// this property says how many bytes of the file have been written to disk yet.
|
||||
file.size: number;
|
||||
|
||||
// The path this file is being written to. You can modify this in the `'fileBegin'` event in
|
||||
// case you are unhappy with the way formidable generates a temporary path for your files.
|
||||
file.filepath: string;
|
||||
|
||||
// The name this file had according to the uploading client.
|
||||
file.originalFilename: string | null;
|
||||
|
||||
// calculated based on options provided
|
||||
file.newFilename: string | null;
|
||||
|
||||
// The mime type of this file, according to the uploading client.
|
||||
file.mimetype: string | null;
|
||||
|
||||
// A Date object (or `null`) containing the time this file was last written to.
|
||||
// Mostly here for compatibility with the [W3C File API Draft](http://dev.w3.org/2006/webapi/FileAPI/).
|
||||
file.mtime: Date | null;
|
||||
|
||||
file.hashAlgorithm: false | |'sha1' | 'md5' | 'sha256'
|
||||
// If `options.hashAlgorithm` calculation was set, you can read the hex digest out of this var (at the end it will be a string)
|
||||
file.hash: string | object | null;
|
||||
}
|
||||
```
|
||||
|
||||
#### file.toJSON()
|
||||
|
||||
This method returns a JSON-representation of the file, allowing you to
|
||||
`JSON.stringify()` the file which is useful for logging and responding to
|
||||
requests.
|
||||
|
||||
### Events
|
||||
|
||||
#### `'progress'`
|
||||
|
||||
Emitted after each incoming chunk of data that has been parsed. Can be used to
|
||||
roll your own progress bar.
|
||||
|
||||
```js
|
||||
form.on('progress', (bytesReceived, bytesExpected) => {});
|
||||
```
|
||||
|
||||
#### `'field'`
|
||||
|
||||
Emitted whenever a field / value pair has been received.
|
||||
|
||||
```js
|
||||
form.on('field', (name, value) => {});
|
||||
```
|
||||
|
||||
#### `'fileBegin'`
|
||||
|
||||
Emitted whenever a new file is detected in the upload stream. Use this event if
|
||||
you want to stream the file to somewhere else while buffering the upload on the
|
||||
file system.
|
||||
|
||||
```js
|
||||
form.on('fileBegin', (formName, file) => {
|
||||
// accessible here
|
||||
// formName the name in the form (<input name="thisname" type="file">) or http filename for octetstream
|
||||
// file.originalFilename http filename or null if there was a parsing error
|
||||
// file.newFilename generated hexoid or what options.filename returned
|
||||
// file.filepath default pathnme as per options.uploadDir and options.filename
|
||||
// file.filepath = CUSTOM_PATH // to change the final path
|
||||
});
|
||||
```
|
||||
|
||||
#### `'file'`
|
||||
|
||||
Emitted whenever a field / file pair has been received. `file` is an instance of
|
||||
`File`.
|
||||
|
||||
```js
|
||||
form.on('file', (formname, file) => {
|
||||
// same as fileBegin, except
|
||||
// it is too late to change file.filepath
|
||||
// file.hash is available if options.hash was used
|
||||
});
|
||||
```
|
||||
|
||||
#### `'error'`
|
||||
|
||||
Emitted when there is an error processing the incoming form. A request that
|
||||
experiences an error is automatically paused, you will have to manually call
|
||||
`request.resume()` if you want the request to continue firing `'data'` events.
|
||||
|
||||
May have `error.httpCode` and `error.code` attached.
|
||||
|
||||
```js
|
||||
form.on('error', (err) => {});
|
||||
```
|
||||
|
||||
#### `'aborted'`
|
||||
|
||||
Emitted when the request was aborted by the user. Right now this can be due to a
|
||||
'timeout' or 'close' event on the socket. After this event is emitted, an
|
||||
`error` event will follow. In the future there will be a separate 'timeout'
|
||||
event (needs a change in the node core).
|
||||
|
||||
```js
|
||||
form.on('aborted', () => {});
|
||||
```
|
||||
|
||||
#### `'end'`
|
||||
|
||||
Emitted when the entire request has been received, and all contained files have
|
||||
finished flushing to disk. This is a great place for you to send your response.
|
||||
|
||||
```js
|
||||
form.on('end', () => {});
|
||||
```
|
||||
|
||||
## Changelog
|
||||
|
||||
[./CHANGELOG.md](./CHANGELOG.md)
|
||||
|
||||
## Ports & Credits
|
||||
|
||||
- [multipart-parser](http://github.com/FooBarWidget/multipart-parser): a C++
|
||||
parser based on formidable
|
||||
- [Ryan Dahl](http://twitter.com/ryah) for his work on
|
||||
[http-parser](http://github.com/ry/http-parser) which heavily inspired the
|
||||
initial `multipart_parser.js`.
|
||||
|
||||
## Contributing
|
||||
|
||||
If the documentation is unclear or has a typo, please click on the page's `Edit`
|
||||
button (pencil icon) and suggest a correction. If you would like to help us fix
|
||||
a bug or add a new feature, please check our [Contributing
|
||||
Guide][contributing-url]. Pull requests are welcome!
|
||||
|
||||
Thanks goes to these wonderful people
|
||||
([emoji key](https://allcontributors.org/docs/en/emoji-key)):
|
||||
|
||||
<!-- ALL-CONTRIBUTORS-LIST:START -->
|
||||
<!-- prettier-ignore-start -->
|
||||
<!-- markdownlint-disable -->
|
||||
<table>
|
||||
<tr>
|
||||
<td align="center"><a href="https://twitter.com/felixge"><img src="https://avatars3.githubusercontent.com/u/15000?s=460&v=4" width="100px;" alt=""/><br /><sub><b>Felix Geisendörfer</b></sub></a><br /><a href="https://github.com/node-formidable/node-formidable/commits?author=felixge" title="Code">💻</a> <a href="#design-felixge" title="Design">🎨</a> <a href="#ideas-felixge" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/node-formidable/node-formidable/commits?author=felixge" title="Documentation">📖</a></td>
|
||||
<td align="center"><a href="https://tunnckoCore.com"><img src="https://avatars3.githubusercontent.com/u/5038030?v=4" width="100px;" alt=""/><br /><sub><b>Charlike Mike Reagent</b></sub></a><br /><a href="https://github.com/node-formidable/node-formidable/issues?q=author%3AtunnckoCore" title="Bug reports">🐛</a> <a href="#infra-tunnckoCore" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a> <a href="#design-tunnckoCore" title="Design">🎨</a> <a href="https://github.com/node-formidable/node-formidable/commits?author=tunnckoCore" title="Code">💻</a> <a href="https://github.com/node-formidable/node-formidable/commits?author=tunnckoCore" title="Documentation">📖</a> <a href="#example-tunnckoCore" title="Examples">💡</a> <a href="#ideas-tunnckoCore" title="Ideas, Planning, & Feedback">🤔</a> <a href="#maintenance-tunnckoCore" title="Maintenance">🚧</a> <a href="https://github.com/node-formidable/node-formidable/commits?author=tunnckoCore" title="Tests">⚠️</a></td>
|
||||
<td align="center"><a href="https://github.com/kedarv"><img src="https://avatars1.githubusercontent.com/u/1365665?v=4" width="100px;" alt=""/><br /><sub><b>Kedar</b></sub></a><br /><a href="https://github.com/node-formidable/node-formidable/commits?author=kedarv" title="Code">💻</a> <a href="https://github.com/node-formidable/node-formidable/commits?author=kedarv" title="Tests">⚠️</a> <a href="#question-kedarv" title="Answering Questions">💬</a> <a href="https://github.com/node-formidable/node-formidable/issues?q=author%3Akedarv" title="Bug reports">🐛</a></td>
|
||||
<td align="center"><a href="https://github.com/GrosSacASac"><img src="https://avatars0.githubusercontent.com/u/5721194?v=4" width="100px;" alt=""/><br /><sub><b>Walle Cyril</b></sub></a><br /><a href="#question-GrosSacASac" title="Answering Questions">💬</a> <a href="https://github.com/node-formidable/node-formidable/issues?q=author%3AGrosSacASac" title="Bug reports">🐛</a> <a href="https://github.com/node-formidable/node-formidable/commits?author=GrosSacASac" title="Code">💻</a> <a href="#financial-GrosSacASac" title="Financial">💵</a> <a href="#ideas-GrosSacASac" title="Ideas, Planning, & Feedback">🤔</a> <a href="#maintenance-GrosSacASac" title="Maintenance">🚧</a></td>
|
||||
<td align="center"><a href="https://github.com/xarguments"><img src="https://avatars2.githubusercontent.com/u/40522463?v=4" width="100px;" alt=""/><br /><sub><b>Xargs</b></sub></a><br /><a href="#question-xarguments" title="Answering Questions">💬</a> <a href="https://github.com/node-formidable/node-formidable/issues?q=author%3Axarguments" title="Bug reports">🐛</a> <a href="https://github.com/node-formidable/node-formidable/commits?author=xarguments" title="Code">💻</a> <a href="#maintenance-xarguments" title="Maintenance">🚧</a></td>
|
||||
<td align="center"><a href="https://github.com/Amit-A"><img src="https://avatars1.githubusercontent.com/u/7987238?v=4" width="100px;" alt=""/><br /><sub><b>Amit-A</b></sub></a><br /><a href="#question-Amit-A" title="Answering Questions">💬</a> <a href="https://github.com/node-formidable/node-formidable/issues?q=author%3AAmit-A" title="Bug reports">🐛</a> <a href="https://github.com/node-formidable/node-formidable/commits?author=Amit-A" title="Code">💻</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="center"><a href="https://charmander.me/"><img src="https://avatars1.githubusercontent.com/u/1889843?v=4" width="100px;" alt=""/><br /><sub><b>Charmander</b></sub></a><br /><a href="#question-charmander" title="Answering Questions">💬</a> <a href="https://github.com/node-formidable/node-formidable/issues?q=author%3Acharmander" title="Bug reports">🐛</a> <a href="https://github.com/node-formidable/node-formidable/commits?author=charmander" title="Code">💻</a> <a href="#ideas-charmander" title="Ideas, Planning, & Feedback">🤔</a> <a href="#maintenance-charmander" title="Maintenance">🚧</a></td>
|
||||
<td align="center"><a href="https://twitter.com/dylan_piercey"><img src="https://avatars2.githubusercontent.com/u/4985201?v=4" width="100px;" alt=""/><br /><sub><b>Dylan Piercey</b></sub></a><br /><a href="#ideas-DylanPiercey" title="Ideas, Planning, & Feedback">🤔</a></td>
|
||||
<td align="center"><a href="http://ochrona.jawne.info.pl"><img src="https://avatars1.githubusercontent.com/u/3618479?v=4" width="100px;" alt=""/><br /><sub><b>Adam Dobrawy</b></sub></a><br /><a href="https://github.com/node-formidable/node-formidable/issues?q=author%3Aad-m" title="Bug reports">🐛</a> <a href="https://github.com/node-formidable/node-formidable/commits?author=ad-m" title="Documentation">📖</a></td>
|
||||
<td align="center"><a href="https://github.com/amitrohatgi"><img src="https://avatars3.githubusercontent.com/u/12177021?v=4" width="100px;" alt=""/><br /><sub><b>amitrohatgi</b></sub></a><br /><a href="#ideas-amitrohatgi" title="Ideas, Planning, & Feedback">🤔</a></td>
|
||||
<td align="center"><a href="https://github.com/fengxinming"><img src="https://avatars2.githubusercontent.com/u/6262382?v=4" width="100px;" alt=""/><br /><sub><b>Jesse Feng</b></sub></a><br /><a href="https://github.com/node-formidable/node-formidable/issues?q=author%3Afengxinming" title="Bug reports">🐛</a></td>
|
||||
<td align="center"><a href="https://qtmsheep.com"><img src="https://avatars1.githubusercontent.com/u/7271496?v=4" width="100px;" alt=""/><br /><sub><b>Nathanael Demacon</b></sub></a><br /><a href="#question-quantumsheep" title="Answering Questions">💬</a> <a href="https://github.com/node-formidable/node-formidable/commits?author=quantumsheep" title="Code">💻</a> <a href="https://github.com/node-formidable/node-formidable/pulls?q=is%3Apr+reviewed-by%3Aquantumsheep" title="Reviewed Pull Requests">👀</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="center"><a href="https://github.com/MunMunMiao"><img src="https://avatars1.githubusercontent.com/u/18216142?v=4" width="100px;" alt=""/><br /><sub><b>MunMunMiao</b></sub></a><br /><a href="https://github.com/node-formidable/node-formidable/issues?q=author%3AMunMunMiao" title="Bug reports">🐛</a></td>
|
||||
<td align="center"><a href="https://github.com/gabipetrovay"><img src="https://avatars0.githubusercontent.com/u/1170398?v=4" width="100px;" alt=""/><br /><sub><b>Gabriel Petrovay</b></sub></a><br /><a href="https://github.com/node-formidable/node-formidable/issues?q=author%3Agabipetrovay" title="Bug reports">🐛</a> <a href="https://github.com/node-formidable/node-formidable/commits?author=gabipetrovay" title="Code">💻</a></td>
|
||||
<td align="center"><a href="https://github.com/Elzair"><img src="https://avatars0.githubusercontent.com/u/2352818?v=4" width="100px;" alt=""/><br /><sub><b>Philip Woods</b></sub></a><br /><a href="https://github.com/node-formidable/node-formidable/commits?author=Elzair" title="Code">💻</a> <a href="#ideas-Elzair" title="Ideas, Planning, & Feedback">🤔</a></td>
|
||||
<td align="center"><a href="https://github.com/dmolim"><img src="https://avatars2.githubusercontent.com/u/7090374?v=4" width="100px;" alt=""/><br /><sub><b>Dmitry Ivonin</b></sub></a><br /><a href="https://github.com/node-formidable/node-formidable/commits?author=dmolim" title="Documentation">📖</a></td>
|
||||
<td align="center"><a href="https://audiobox.fm"><img src="https://avatars1.githubusercontent.com/u/12844?v=4" width="100px;" alt=""/><br /><sub><b>Claudio Poli</b></sub></a><br /><a href="https://github.com/node-formidable/node-formidable/commits?author=masterkain" title="Code">💻</a></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
<!-- markdownlint-enable -->
|
||||
<!-- prettier-ignore-end -->
|
||||
|
||||
<!-- ALL-CONTRIBUTORS-LIST:END -->
|
||||
|
||||
From a [Felix blog post](https://felixge.de/2013/03/11/the-pull-request-hack/):
|
||||
|
||||
- [Sven Lito](https://github.com/svnlto) for fixing bugs and merging patches
|
||||
- [egirshov](https://github.com/egirshov) for contributing many improvements to
|
||||
the node-formidable multipart parser
|
||||
- [Andrew Kelley](https://github.com/superjoe30) for also helping with fixing
|
||||
bugs and making improvements
|
||||
- [Mike Frey](https://github.com/mikefrey) for contributing JSON support
|
||||
|
||||
## License
|
||||
|
||||
Formidable is licensed under the [MIT License][license-url].
|
||||
|
||||
<!-- badges -->
|
||||
<!-- prettier-ignore-start -->
|
||||
|
||||
[codestyle-url]: https://github.com/airbnb/javascript
|
||||
[codestyle-img]: https://badgen.net/badge/code%20style/airbnb%20%2B%20prettier/ff5a5f?icon=airbnb&cache=300
|
||||
[codecov-url]: https://codecov.io/gh/node-formidable/formidable
|
||||
[codecov-img]: https://badgen.net/codecov/c/github/node-formidable/formidable/master?icon=codecov
|
||||
[npmv-canary-img]: https://badgen.net/npm/v/formidable/canary?icon=npm
|
||||
[npmv-dev-img]: https://badgen.net/npm/v/formidable/dev?icon=npm
|
||||
[npmv-img]: https://badgen.net/npm/v/formidable?icon=npm
|
||||
[npmv-url]: https://npmjs.com/package/formidable
|
||||
[license-img]: https://badgen.net/npm/license/formidable
|
||||
[license-url]: https://github.com/node-formidable/formidable/blob/master/LICENSE
|
||||
[chat-img]: https://badgen.net/badge/chat/on%20gitter/46BC99?icon=gitter
|
||||
[chat-url]: https://gitter.im/node-formidable/Lobby
|
||||
[libera-manifesto-url]: https://liberamanifesto.com
|
||||
[libera-manifesto-img]: https://badgen.net/badge/libera/manifesto/grey
|
||||
[renovateapp-url]: https://renovatebot.com
|
||||
[renovateapp-img]: https://badgen.net/badge/renovate/enabled/green?cache=300
|
||||
[prs-welcome-img]: https://badgen.net/badge/PRs/welcome/green?cache=300
|
||||
[prs-welcome-url]: http://makeapullrequest.com
|
||||
[twitter-url]: https://twitter.com/wgw_eth
|
||||
[twitter-img]: https://badgen.net/badge/twitter/follow/wgw_eth?icon=twitter&color=1da1f2&cache=30
|
||||
|
||||
[npm-weekly-img]: https://badgen.net/npm/dw/formidable?icon=npm&cache=300
|
||||
[npm-monthly-img]: https://badgen.net/npm/dm/formidable?icon=npm&cache=300
|
||||
[npm-yearly-img]: https://badgen.net/npm/dy/formidable?icon=npm&cache=300
|
||||
[npm-alltime-img]: https://badgen.net/npm/dt/formidable?icon=npm&cache=300&label=total%20downloads
|
||||
|
||||
[nodejs-img]: https://badgen.net/badge/node/>=%2010.13/green?cache=300
|
||||
|
||||
[ccommits-url]: https://conventionalcommits.org/
|
||||
[ccommits-img]: https://badgen.net/badge/conventional%20commits/v1.0.0/green?cache=300
|
||||
|
||||
[contributing-url]: https://github.com/node-formidable/.github/blob/master/CONTRIBUTING.md
|
||||
[code_of_conduct-url]: https://github.com/node-formidable/.github/blob/master/CODE_OF_CONDUCT.md
|
||||
|
||||
[open-issue-url]: https://github.com/node-formidable/formidable/issues/new
|
||||
|
||||
[tidelift-url]: https://tidelift.com/subscription/pkg/npm-formidable?utm_source=npm-formidable&utm_medium=referral&utm_campaign=enterprise
|
||||
[tidelift-img]: https://badgen.net/badge/tidelift/subscription/4B5168?labelColor=F6914D
|
||||
|
||||
[kofi-url]: https://ko-fi.com/tunnckoCore/commissions
|
||||
[kofi-img]: https://badgen.net/badge/ko-fi/support/29abe0c2?cache=300&icon=https://rawcdn.githack.com/tunnckoCore/badgen-icons/f8264c6414e0bec449dd86f2241d50a9b89a1203/icons/kofi.svg
|
||||
|
||||
[linux-build-img]: https://badgen.net/github/checks/node-formidable/formidable/master?label=linux%20build&icon=github
|
||||
[macos-build-img]: https://badgen.net/github/checks/node-formidable/formidable/master?label=macos%20build&icon=github
|
||||
[windows-build-img]: https://badgen.net/github/checks/node-formidable/formidable/master/windows?cache=300&label=windows%20build&icon=github
|
||||
[build-url]: https://github.com/node-formidable/formidable/actions
|
||||
<!-- prettier-ignore-end -->
|
||||
67
qwen/nodejs/node_modules/formidable/package.json
generated
vendored
Normal file
67
qwen/nodejs/node_modules/formidable/package.json
generated
vendored
Normal file
@@ -0,0 +1,67 @@
|
||||
{
|
||||
"name": "formidable",
|
||||
"version": "2.1.5",
|
||||
"license": "MIT",
|
||||
"description": "A node.js module for parsing form data, especially file uploads.",
|
||||
"homepage": "https://github.com/node-formidable/formidable",
|
||||
"funding": "https://ko-fi.com/tunnckoCore/commissions",
|
||||
"repository": "node-formidable/formidable",
|
||||
"main": "./src/index.js",
|
||||
"files": [
|
||||
"src"
|
||||
],
|
||||
"publishConfig": {
|
||||
"access": "public",
|
||||
"tag": "v2-latest"
|
||||
},
|
||||
"scripts": {
|
||||
"bench": "node benchmark",
|
||||
"fmt": "yarn run fmt:prepare '**/*'",
|
||||
"fmt:prepare": "prettier --write",
|
||||
"lint": "yarn run lint:prepare .",
|
||||
"lint:prepare": "eslint --cache --fix --quiet --format codeframe",
|
||||
"reinstall": "rm -rf ./node_modules ./yarn.lock",
|
||||
"postreinstall": "yarn setup",
|
||||
"setup": "yarn",
|
||||
"pretest": "rm -rf ./test/tmp && mkdir -p ./test/tmp",
|
||||
"test:local": "jest --coverage",
|
||||
"pretest:ci": "yarn run pretest",
|
||||
"test": "nyc jest --coverage"
|
||||
},
|
||||
"dependencies": {
|
||||
"@paralleldrive/cuid2": "^2.2.2",
|
||||
"dezalgo": "^1.0.4",
|
||||
"once": "^1.4.0",
|
||||
"qs": "^6.11.0"
|
||||
},
|
||||
"devDependencies": {
|
||||
"@tunnckocore/prettier-config": "1.3.8",
|
||||
"eslint": "6.8.0",
|
||||
"eslint-config-airbnb-base": "14.1.0",
|
||||
"eslint-config-prettier": "6.11.0",
|
||||
"eslint-plugin-import": "2.20.2",
|
||||
"eslint-plugin-prettier": "3.1.3",
|
||||
"express": "4.17.1",
|
||||
"husky": "4.2.5",
|
||||
"jest": "27.2.4",
|
||||
"koa": "2.11.0",
|
||||
"nyc": "15.0.1",
|
||||
"prettier": "2.0.5",
|
||||
"prettier-plugin-pkgjson": "0.2.8",
|
||||
"request": "2.88.2",
|
||||
"supertest": "4.0.2"
|
||||
},
|
||||
"jest": {
|
||||
"verbose": true
|
||||
},
|
||||
"keywords": [
|
||||
"multipart",
|
||||
"form",
|
||||
"data",
|
||||
"querystring",
|
||||
"www",
|
||||
"json",
|
||||
"ulpoad",
|
||||
"file"
|
||||
]
|
||||
}
|
||||
623
qwen/nodejs/node_modules/formidable/src/Formidable.js
generated
vendored
Normal file
623
qwen/nodejs/node_modules/formidable/src/Formidable.js
generated
vendored
Normal file
@@ -0,0 +1,623 @@
|
||||
/* eslint-disable class-methods-use-this */
|
||||
/* eslint-disable no-underscore-dangle */
|
||||
|
||||
'use strict';
|
||||
|
||||
const os = require('os');
|
||||
const path = require('path');
|
||||
const cuid2 = require('@paralleldrive/cuid2');
|
||||
const once = require('once');
|
||||
const dezalgo = require('dezalgo');
|
||||
const { EventEmitter } = require('events');
|
||||
const { StringDecoder } = require('string_decoder');
|
||||
const qs = require('qs');
|
||||
|
||||
const CUID2_FINGERPRINT = `${
|
||||
process.env.NODE_ENV
|
||||
}-${os.platform()}-${os.hostname()}`;
|
||||
const createId = cuid2.init({
|
||||
length: 25,
|
||||
fingerprint: CUID2_FINGERPRINT.toLowerCase(),
|
||||
});
|
||||
|
||||
const DEFAULT_OPTIONS = {
|
||||
maxFields: 1000,
|
||||
maxFieldsSize: 20 * 1024 * 1024,
|
||||
maxFileSize: 200 * 1024 * 1024,
|
||||
minFileSize: 1,
|
||||
allowEmptyFiles: true,
|
||||
keepExtensions: false,
|
||||
encoding: 'utf-8',
|
||||
hashAlgorithm: false,
|
||||
uploadDir: os.tmpdir(),
|
||||
multiples: false,
|
||||
enabledPlugins: ['octetstream', 'querystring', 'multipart', 'json'],
|
||||
fileWriteStreamHandler: null,
|
||||
defaultInvalidName: 'invalid-name',
|
||||
filter() {
|
||||
return true;
|
||||
},
|
||||
};
|
||||
|
||||
const PersistentFile = require('./PersistentFile');
|
||||
const VolatileFile = require('./VolatileFile');
|
||||
const DummyParser = require('./parsers/Dummy');
|
||||
const MultipartParser = require('./parsers/Multipart');
|
||||
const errors = require('./FormidableError.js');
|
||||
|
||||
const { FormidableError } = errors;
|
||||
|
||||
function hasOwnProp(obj, key) {
|
||||
return Object.prototype.hasOwnProperty.call(obj, key);
|
||||
}
|
||||
|
||||
class IncomingForm extends EventEmitter {
|
||||
constructor(options = {}) {
|
||||
super();
|
||||
|
||||
this.options = { ...DEFAULT_OPTIONS, ...options };
|
||||
|
||||
const dir = path.resolve(
|
||||
this.options.uploadDir || this.options.uploaddir || os.tmpdir(),
|
||||
);
|
||||
|
||||
this.uploaddir = dir;
|
||||
this.uploadDir = dir;
|
||||
|
||||
// initialize with null
|
||||
[
|
||||
'error',
|
||||
'headers',
|
||||
'type',
|
||||
'bytesExpected',
|
||||
'bytesReceived',
|
||||
'_parser',
|
||||
].forEach((key) => {
|
||||
this[key] = null;
|
||||
});
|
||||
|
||||
this._setUpRename();
|
||||
|
||||
this._flushing = 0;
|
||||
this._fieldsSize = 0;
|
||||
this._fileSize = 0;
|
||||
this._plugins = [];
|
||||
this.openedFiles = [];
|
||||
|
||||
this.options.enabledPlugins = []
|
||||
.concat(this.options.enabledPlugins)
|
||||
.filter(Boolean);
|
||||
|
||||
if (this.options.enabledPlugins.length === 0) {
|
||||
throw new FormidableError(
|
||||
'expect at least 1 enabled builtin plugin, see options.enabledPlugins',
|
||||
errors.missingPlugin,
|
||||
);
|
||||
}
|
||||
|
||||
this.options.enabledPlugins.forEach((pluginName) => {
|
||||
const plgName = pluginName.toLowerCase();
|
||||
// eslint-disable-next-line import/no-dynamic-require, global-require
|
||||
this.use(require(path.join(__dirname, 'plugins', `${plgName}.js`)));
|
||||
});
|
||||
|
||||
this._setUpMaxFields();
|
||||
}
|
||||
|
||||
use(plugin) {
|
||||
if (typeof plugin !== 'function') {
|
||||
throw new FormidableError(
|
||||
'.use: expect `plugin` to be a function',
|
||||
errors.pluginFunction,
|
||||
);
|
||||
}
|
||||
this._plugins.push(plugin.bind(this));
|
||||
return this;
|
||||
}
|
||||
|
||||
parse(req, cb) {
|
||||
this.pause = () => {
|
||||
try {
|
||||
req.pause();
|
||||
} catch (err) {
|
||||
// the stream was destroyed
|
||||
if (!this.ended) {
|
||||
// before it was completed, crash & burn
|
||||
this._error(err);
|
||||
}
|
||||
return false;
|
||||
}
|
||||
return true;
|
||||
};
|
||||
|
||||
this.resume = () => {
|
||||
try {
|
||||
req.resume();
|
||||
} catch (err) {
|
||||
// the stream was destroyed
|
||||
if (!this.ended) {
|
||||
// before it was completed, crash & burn
|
||||
this._error(err);
|
||||
}
|
||||
return false;
|
||||
}
|
||||
|
||||
return true;
|
||||
};
|
||||
|
||||
// Setup callback first, so we don't miss anything from data events emitted immediately.
|
||||
if (cb) {
|
||||
const callback = once(dezalgo(cb));
|
||||
const fields = {};
|
||||
let mockFields = '';
|
||||
const files = {};
|
||||
|
||||
this.on('field', (name, value) => {
|
||||
if (
|
||||
this.options.multiples &&
|
||||
(this.type === 'multipart' || this.type === 'urlencoded')
|
||||
) {
|
||||
const mObj = { [name]: value };
|
||||
mockFields = mockFields
|
||||
? `${mockFields}&${qs.stringify(mObj)}`
|
||||
: `${qs.stringify(mObj)}`;
|
||||
} else {
|
||||
fields[name] = value;
|
||||
}
|
||||
});
|
||||
this.on('file', (name, file) => {
|
||||
// TODO: too much nesting
|
||||
if (this.options.multiples) {
|
||||
if (hasOwnProp(files, name)) {
|
||||
if (!Array.isArray(files[name])) {
|
||||
files[name] = [files[name]];
|
||||
}
|
||||
files[name].push(file);
|
||||
} else {
|
||||
files[name] = file;
|
||||
}
|
||||
} else {
|
||||
files[name] = file;
|
||||
}
|
||||
});
|
||||
this.on('error', (err) => {
|
||||
callback(err, fields, files);
|
||||
});
|
||||
this.on('end', () => {
|
||||
if (this.options.multiples) {
|
||||
Object.assign(fields, qs.parse(mockFields));
|
||||
}
|
||||
callback(null, fields, files);
|
||||
});
|
||||
}
|
||||
|
||||
// Parse headers and setup the parser, ready to start listening for data.
|
||||
this.writeHeaders(req.headers);
|
||||
|
||||
// Start listening for data.
|
||||
req
|
||||
.on('error', (err) => {
|
||||
this._error(err);
|
||||
})
|
||||
.on('aborted', () => {
|
||||
this.emit('aborted');
|
||||
this._error(new FormidableError('Request aborted', errors.aborted));
|
||||
})
|
||||
.on('data', (buffer) => {
|
||||
try {
|
||||
this.write(buffer);
|
||||
} catch (err) {
|
||||
this._error(err);
|
||||
}
|
||||
})
|
||||
.on('end', () => {
|
||||
if (this.error) {
|
||||
return;
|
||||
}
|
||||
if (this._parser) {
|
||||
this._parser.end();
|
||||
}
|
||||
this._maybeEnd();
|
||||
});
|
||||
|
||||
return this;
|
||||
}
|
||||
|
||||
writeHeaders(headers) {
|
||||
this.headers = headers;
|
||||
this._parseContentLength();
|
||||
this._parseContentType();
|
||||
|
||||
if (!this._parser) {
|
||||
this._error(
|
||||
new FormidableError(
|
||||
'no parser found',
|
||||
errors.noParser,
|
||||
415, // Unsupported Media Type
|
||||
),
|
||||
);
|
||||
return;
|
||||
}
|
||||
|
||||
this._parser.once('error', (error) => {
|
||||
this._error(error);
|
||||
});
|
||||
}
|
||||
|
||||
write(buffer) {
|
||||
if (this.error) {
|
||||
return null;
|
||||
}
|
||||
if (!this._parser) {
|
||||
this._error(
|
||||
new FormidableError('uninitialized parser', errors.uninitializedParser),
|
||||
);
|
||||
return null;
|
||||
}
|
||||
|
||||
this.bytesReceived += buffer.length;
|
||||
this.emit('progress', this.bytesReceived, this.bytesExpected);
|
||||
|
||||
this._parser.write(buffer);
|
||||
|
||||
return this.bytesReceived;
|
||||
}
|
||||
|
||||
pause() {
|
||||
// this does nothing, unless overwritten in IncomingForm.parse
|
||||
return false;
|
||||
}
|
||||
|
||||
resume() {
|
||||
// this does nothing, unless overwritten in IncomingForm.parse
|
||||
return false;
|
||||
}
|
||||
|
||||
onPart(part) {
|
||||
// this method can be overwritten by the user
|
||||
this._handlePart(part);
|
||||
}
|
||||
|
||||
_handlePart(part) {
|
||||
if (part.originalFilename && typeof part.originalFilename !== 'string') {
|
||||
this._error(
|
||||
new FormidableError(
|
||||
`the part.originalFilename should be string when it exists`,
|
||||
errors.filenameNotString,
|
||||
),
|
||||
);
|
||||
return;
|
||||
}
|
||||
|
||||
// This MUST check exactly for undefined. You can not change it to !part.originalFilename.
|
||||
|
||||
// todo: uncomment when switch tests to Jest
|
||||
// console.log(part);
|
||||
|
||||
// ? NOTE(@tunnckocore): no it can be any falsey value, it most probably depends on what's returned
|
||||
// from somewhere else. Where recently I changed the return statements
|
||||
// and such thing because code style
|
||||
// ? NOTE(@tunnckocore): or even better, if there is no mimetype, then it's for sure a field
|
||||
// ? NOTE(@tunnckocore): originalFilename is an empty string when a field?
|
||||
if (!part.mimetype) {
|
||||
let value = '';
|
||||
const decoder = new StringDecoder(
|
||||
part.transferEncoding || this.options.encoding,
|
||||
);
|
||||
|
||||
part.on('data', (buffer) => {
|
||||
this._fieldsSize += buffer.length;
|
||||
if (this._fieldsSize > this.options.maxFieldsSize) {
|
||||
this._error(
|
||||
new FormidableError(
|
||||
`options.maxFieldsSize (${this.options.maxFieldsSize} bytes) exceeded, received ${this._fieldsSize} bytes of field data`,
|
||||
errors.maxFieldsSizeExceeded,
|
||||
413, // Payload Too Large
|
||||
),
|
||||
);
|
||||
return;
|
||||
}
|
||||
value += decoder.write(buffer);
|
||||
});
|
||||
|
||||
part.on('end', () => {
|
||||
this.emit('field', part.name, value);
|
||||
});
|
||||
return;
|
||||
}
|
||||
|
||||
if (!this.options.filter(part)) {
|
||||
return;
|
||||
}
|
||||
|
||||
this._flushing += 1;
|
||||
|
||||
const newFilename = this._getNewName(part);
|
||||
const filepath = this._joinDirectoryName(newFilename);
|
||||
const file = this._newFile({
|
||||
newFilename,
|
||||
filepath,
|
||||
originalFilename: part.originalFilename,
|
||||
mimetype: part.mimetype,
|
||||
});
|
||||
file.on('error', (err) => {
|
||||
this._error(err);
|
||||
});
|
||||
this.emit('fileBegin', part.name, file);
|
||||
|
||||
file.open();
|
||||
this.openedFiles.push(file);
|
||||
|
||||
part.on('data', (buffer) => {
|
||||
this._fileSize += buffer.length;
|
||||
if (this._fileSize < this.options.minFileSize) {
|
||||
this._error(
|
||||
new FormidableError(
|
||||
`options.minFileSize (${this.options.minFileSize} bytes) inferior, received ${this._fileSize} bytes of file data`,
|
||||
errors.smallerThanMinFileSize,
|
||||
400,
|
||||
),
|
||||
);
|
||||
return;
|
||||
}
|
||||
if (this._fileSize > this.options.maxFileSize) {
|
||||
this._error(
|
||||
new FormidableError(
|
||||
`options.maxFileSize (${this.options.maxFileSize} bytes) exceeded, received ${this._fileSize} bytes of file data`,
|
||||
errors.biggerThanMaxFileSize,
|
||||
413,
|
||||
),
|
||||
);
|
||||
return;
|
||||
}
|
||||
if (buffer.length === 0) {
|
||||
return;
|
||||
}
|
||||
this.pause();
|
||||
file.write(buffer, () => {
|
||||
this.resume();
|
||||
});
|
||||
});
|
||||
|
||||
part.on('end', () => {
|
||||
if (!this.options.allowEmptyFiles && this._fileSize === 0) {
|
||||
this._error(
|
||||
new FormidableError(
|
||||
`options.allowEmptyFiles is false, file size should be greather than 0`,
|
||||
errors.noEmptyFiles,
|
||||
400,
|
||||
),
|
||||
);
|
||||
return;
|
||||
}
|
||||
|
||||
file.end(() => {
|
||||
this._flushing -= 1;
|
||||
this.emit('file', part.name, file);
|
||||
this._maybeEnd();
|
||||
});
|
||||
});
|
||||
}
|
||||
|
||||
// eslint-disable-next-line max-statements
|
||||
_parseContentType() {
|
||||
if (this.bytesExpected === 0) {
|
||||
this._parser = new DummyParser(this, this.options);
|
||||
return;
|
||||
}
|
||||
|
||||
if (!this.headers['content-type']) {
|
||||
this._error(
|
||||
new FormidableError(
|
||||
'bad content-type header, no content-type',
|
||||
errors.missingContentType,
|
||||
400,
|
||||
),
|
||||
);
|
||||
return;
|
||||
}
|
||||
|
||||
const results = [];
|
||||
const _dummyParser = new DummyParser(this, this.options);
|
||||
|
||||
// eslint-disable-next-line no-plusplus
|
||||
for (let idx = 0; idx < this._plugins.length; idx++) {
|
||||
const plugin = this._plugins[idx];
|
||||
|
||||
let pluginReturn = null;
|
||||
|
||||
try {
|
||||
pluginReturn = plugin(this, this.options) || this;
|
||||
} catch (err) {
|
||||
// directly throw from the `form.parse` method;
|
||||
// there is no other better way, except a handle through options
|
||||
const error = new FormidableError(
|
||||
`plugin on index ${idx} failed with: ${err.message}`,
|
||||
errors.pluginFailed,
|
||||
500,
|
||||
);
|
||||
error.idx = idx;
|
||||
throw error;
|
||||
}
|
||||
|
||||
Object.assign(this, pluginReturn);
|
||||
|
||||
// todo: use Set/Map and pass plugin name instead of the `idx` index
|
||||
this.emit('plugin', idx, pluginReturn);
|
||||
results.push(pluginReturn);
|
||||
}
|
||||
|
||||
this.emit('pluginsResults', results);
|
||||
|
||||
// NOTE: probably not needed, because we check options.enabledPlugins in the constructor
|
||||
// if (results.length === 0 /* && results.length !== this._plugins.length */) {
|
||||
// this._error(
|
||||
// new Error(
|
||||
// `bad content-type header, unknown content-type: ${this.headers['content-type']}`,
|
||||
// ),
|
||||
// );
|
||||
// }
|
||||
}
|
||||
|
||||
_error(err, eventName = 'error') {
|
||||
// if (!err && this.error) {
|
||||
// this.emit('error', this.error);
|
||||
// return;
|
||||
// }
|
||||
if (this.error || this.ended) {
|
||||
return;
|
||||
}
|
||||
|
||||
this.error = err;
|
||||
this.emit(eventName, err);
|
||||
|
||||
if (Array.isArray(this.openedFiles)) {
|
||||
this.openedFiles.forEach((file) => {
|
||||
file.destroy();
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
_parseContentLength() {
|
||||
this.bytesReceived = 0;
|
||||
if (this.headers['content-length']) {
|
||||
this.bytesExpected = parseInt(this.headers['content-length'], 10);
|
||||
} else if (this.headers['transfer-encoding'] === undefined) {
|
||||
this.bytesExpected = 0;
|
||||
}
|
||||
|
||||
if (this.bytesExpected !== null) {
|
||||
this.emit('progress', this.bytesReceived, this.bytesExpected);
|
||||
}
|
||||
}
|
||||
|
||||
_newParser() {
|
||||
return new MultipartParser(this.options);
|
||||
}
|
||||
|
||||
_newFile({ filepath, originalFilename, mimetype, newFilename }) {
|
||||
return this.options.fileWriteStreamHandler
|
||||
? new VolatileFile({
|
||||
newFilename,
|
||||
filepath,
|
||||
originalFilename,
|
||||
mimetype,
|
||||
createFileWriteStream: this.options.fileWriteStreamHandler,
|
||||
hashAlgorithm: this.options.hashAlgorithm,
|
||||
})
|
||||
: new PersistentFile({
|
||||
newFilename,
|
||||
filepath,
|
||||
originalFilename,
|
||||
mimetype,
|
||||
hashAlgorithm: this.options.hashAlgorithm,
|
||||
});
|
||||
}
|
||||
|
||||
_getFileName(headerValue) {
|
||||
// matches either a quoted-string or a token (RFC 2616 section 19.5.1)
|
||||
const m = headerValue.match(
|
||||
/\bfilename=("(.*?)"|([^()<>{}[\]@,;:"?=\s/\t]+))($|;\s)/i,
|
||||
);
|
||||
if (!m) return null;
|
||||
|
||||
const match = m[2] || m[3] || '';
|
||||
let originalFilename = match.substr(match.lastIndexOf('\\') + 1);
|
||||
originalFilename = originalFilename.replace(/%22/g, '"');
|
||||
originalFilename = originalFilename.replace(/&#([\d]{4});/g, (_, code) =>
|
||||
String.fromCharCode(code),
|
||||
);
|
||||
|
||||
return originalFilename;
|
||||
}
|
||||
|
||||
_getExtension(str) {
|
||||
if (!str) {
|
||||
return '';
|
||||
}
|
||||
|
||||
const basename = path.basename(str);
|
||||
const firstDot = basename.indexOf('.');
|
||||
const lastDot = basename.lastIndexOf('.');
|
||||
const extname = path.extname(basename).replace(/(\.[a-z0-9]+).*/i, '$1');
|
||||
|
||||
if (firstDot === lastDot) {
|
||||
return extname;
|
||||
}
|
||||
|
||||
return basename.slice(firstDot, lastDot) + extname;
|
||||
}
|
||||
|
||||
_joinDirectoryName(name) {
|
||||
const newPath = path.join(this.uploadDir, name);
|
||||
|
||||
// prevent directory traversal attacks
|
||||
if (!newPath.startsWith(this.uploadDir)) {
|
||||
return path.join(this.uploadDir, this.options.defaultInvalidName);
|
||||
}
|
||||
|
||||
return newPath;
|
||||
}
|
||||
|
||||
_setUpRename() {
|
||||
const hasRename = typeof this.options.filename === 'function';
|
||||
if (hasRename) {
|
||||
this._getNewName = (part) => {
|
||||
let ext = '';
|
||||
let name = this.options.defaultInvalidName;
|
||||
if (part.originalFilename) {
|
||||
// can be null
|
||||
({ ext, name } = path.parse(part.originalFilename));
|
||||
if (this.options.keepExtensions !== true) {
|
||||
ext = '';
|
||||
}
|
||||
}
|
||||
return this.options.filename.call(this, name, ext, part, this);
|
||||
};
|
||||
} else {
|
||||
this._getNewName = (part) => {
|
||||
const name = createId();
|
||||
|
||||
if (part && this.options.keepExtensions) {
|
||||
const originalFilename =
|
||||
typeof part === 'string' ? part : part.originalFilename;
|
||||
return `${name}${this._getExtension(originalFilename)}`;
|
||||
}
|
||||
|
||||
return name;
|
||||
};
|
||||
}
|
||||
}
|
||||
|
||||
_setUpMaxFields() {
|
||||
if (this.options.maxFields !== 0) {
|
||||
let fieldsCount = 0;
|
||||
this.on('field', () => {
|
||||
fieldsCount += 1;
|
||||
if (fieldsCount > this.options.maxFields) {
|
||||
this._error(
|
||||
new FormidableError(
|
||||
`options.maxFields (${this.options.maxFields}) exceeded`,
|
||||
errors.maxFieldsExceeded,
|
||||
413,
|
||||
),
|
||||
);
|
||||
}
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
_maybeEnd() {
|
||||
// console.log('ended', this.ended);
|
||||
// console.log('_flushing', this._flushing);
|
||||
// console.log('error', this.error);
|
||||
if (!this.ended || this._flushing || this.error) {
|
||||
return;
|
||||
}
|
||||
|
||||
this.emit('end');
|
||||
}
|
||||
}
|
||||
|
||||
IncomingForm.DEFAULT_OPTIONS = DEFAULT_OPTIONS;
|
||||
module.exports = IncomingForm;
|
||||
45
qwen/nodejs/node_modules/formidable/src/FormidableError.js
generated
vendored
Normal file
45
qwen/nodejs/node_modules/formidable/src/FormidableError.js
generated
vendored
Normal file
@@ -0,0 +1,45 @@
|
||||
/* eslint-disable no-plusplus */
|
||||
|
||||
const missingPlugin = 1000;
|
||||
const pluginFunction = 1001;
|
||||
const aborted = 1002;
|
||||
const noParser = 1003;
|
||||
const uninitializedParser = 1004;
|
||||
const filenameNotString = 1005;
|
||||
const maxFieldsSizeExceeded = 1006;
|
||||
const maxFieldsExceeded = 1007;
|
||||
const smallerThanMinFileSize = 1008;
|
||||
const biggerThanMaxFileSize = 1009;
|
||||
const noEmptyFiles = 1010;
|
||||
const missingContentType = 1011;
|
||||
const malformedMultipart = 1012;
|
||||
const missingMultipartBoundary = 1013;
|
||||
const unknownTransferEncoding = 1014;
|
||||
|
||||
const FormidableError = class extends Error {
|
||||
constructor(message, internalCode, httpCode = 500) {
|
||||
super(message);
|
||||
this.code = internalCode;
|
||||
this.httpCode = httpCode;
|
||||
}
|
||||
};
|
||||
|
||||
module.exports = {
|
||||
missingPlugin,
|
||||
pluginFunction,
|
||||
aborted,
|
||||
noParser,
|
||||
uninitializedParser,
|
||||
filenameNotString,
|
||||
maxFieldsSizeExceeded,
|
||||
maxFieldsExceeded,
|
||||
smallerThanMinFileSize,
|
||||
biggerThanMaxFileSize,
|
||||
noEmptyFiles,
|
||||
missingContentType,
|
||||
malformedMultipart,
|
||||
missingMultipartBoundary,
|
||||
unknownTransferEncoding,
|
||||
|
||||
FormidableError,
|
||||
};
|
||||
87
qwen/nodejs/node_modules/formidable/src/PersistentFile.js
generated
vendored
Normal file
87
qwen/nodejs/node_modules/formidable/src/PersistentFile.js
generated
vendored
Normal file
@@ -0,0 +1,87 @@
|
||||
/* eslint-disable no-underscore-dangle */
|
||||
|
||||
'use strict';
|
||||
|
||||
const fs = require('fs');
|
||||
const crypto = require('crypto');
|
||||
const { EventEmitter } = require('events');
|
||||
|
||||
class PersistentFile extends EventEmitter {
|
||||
constructor({ filepath, newFilename, originalFilename, mimetype, hashAlgorithm }) {
|
||||
super();
|
||||
|
||||
this.lastModifiedDate = null;
|
||||
Object.assign(this, { filepath, newFilename, originalFilename, mimetype, hashAlgorithm });
|
||||
|
||||
this.size = 0;
|
||||
this._writeStream = null;
|
||||
|
||||
if (typeof this.hashAlgorithm === 'string') {
|
||||
this.hash = crypto.createHash(this.hashAlgorithm);
|
||||
} else {
|
||||
this.hash = null;
|
||||
}
|
||||
}
|
||||
|
||||
open() {
|
||||
this._writeStream = new fs.WriteStream(this.filepath);
|
||||
this._writeStream.on('error', (err) => {
|
||||
this.emit('error', err);
|
||||
});
|
||||
}
|
||||
|
||||
toJSON() {
|
||||
const json = {
|
||||
size: this.size,
|
||||
filepath: this.filepath,
|
||||
newFilename: this.newFilename,
|
||||
mimetype: this.mimetype,
|
||||
mtime: this.lastModifiedDate,
|
||||
length: this.length,
|
||||
originalFilename: this.originalFilename,
|
||||
};
|
||||
if (this.hash && this.hash !== '') {
|
||||
json.hash = this.hash;
|
||||
}
|
||||
return json;
|
||||
}
|
||||
|
||||
toString() {
|
||||
return `PersistentFile: ${this.newFilename}, Original: ${this.originalFilename}, Path: ${this.filepath}`;
|
||||
}
|
||||
|
||||
write(buffer, cb) {
|
||||
if (this.hash) {
|
||||
this.hash.update(buffer);
|
||||
}
|
||||
|
||||
if (this._writeStream.closed) {
|
||||
cb();
|
||||
return;
|
||||
}
|
||||
|
||||
this._writeStream.write(buffer, () => {
|
||||
this.lastModifiedDate = new Date();
|
||||
this.size += buffer.length;
|
||||
this.emit('progress', this.size);
|
||||
cb();
|
||||
});
|
||||
}
|
||||
|
||||
end(cb) {
|
||||
if (this.hash) {
|
||||
this.hash = this.hash.digest('hex');
|
||||
}
|
||||
this._writeStream.end(() => {
|
||||
this.emit('end');
|
||||
cb();
|
||||
});
|
||||
}
|
||||
|
||||
destroy() {
|
||||
this._writeStream.destroy();
|
||||
fs.unlink(this.filepath, () => {});
|
||||
}
|
||||
}
|
||||
|
||||
module.exports = PersistentFile;
|
||||
82
qwen/nodejs/node_modules/formidable/src/VolatileFile.js
generated
vendored
Normal file
82
qwen/nodejs/node_modules/formidable/src/VolatileFile.js
generated
vendored
Normal file
@@ -0,0 +1,82 @@
|
||||
/* eslint-disable no-underscore-dangle */
|
||||
|
||||
'use strict';
|
||||
|
||||
const crypto = require('crypto');
|
||||
const { EventEmitter } = require('events');
|
||||
|
||||
class VolatileFile extends EventEmitter {
|
||||
constructor({ filepath, newFilename, originalFilename, mimetype, hashAlgorithm, createFileWriteStream }) {
|
||||
super();
|
||||
|
||||
this.lastModifiedDate = null;
|
||||
Object.assign(this, { filepath, newFilename, originalFilename, mimetype, hashAlgorithm, createFileWriteStream });
|
||||
|
||||
this.size = 0;
|
||||
this._writeStream = null;
|
||||
|
||||
if (typeof this.hashAlgorithm === 'string') {
|
||||
this.hash = crypto.createHash(this.hashAlgorithm);
|
||||
} else {
|
||||
this.hash = null;
|
||||
}
|
||||
}
|
||||
|
||||
open() {
|
||||
this._writeStream = this.createFileWriteStream(this);
|
||||
this._writeStream.on('error', (err) => {
|
||||
this.emit('error', err);
|
||||
});
|
||||
}
|
||||
|
||||
destroy() {
|
||||
this._writeStream.destroy();
|
||||
}
|
||||
|
||||
toJSON() {
|
||||
const json = {
|
||||
size: this.size,
|
||||
newFilename: this.newFilename,
|
||||
length: this.length,
|
||||
originalFilename: this.originalFilename,
|
||||
mimetype: this.mimetype,
|
||||
};
|
||||
if (this.hash && this.hash !== '') {
|
||||
json.hash = this.hash;
|
||||
}
|
||||
return json;
|
||||
}
|
||||
|
||||
toString() {
|
||||
return `VolatileFile: ${this.originalFilename}`;
|
||||
}
|
||||
|
||||
write(buffer, cb) {
|
||||
if (this.hash) {
|
||||
this.hash.update(buffer);
|
||||
}
|
||||
|
||||
if (this._writeStream.closed || this._writeStream.destroyed) {
|
||||
cb();
|
||||
return;
|
||||
}
|
||||
|
||||
this._writeStream.write(buffer, () => {
|
||||
this.size += buffer.length;
|
||||
this.emit('progress', this.size);
|
||||
cb();
|
||||
});
|
||||
}
|
||||
|
||||
end(cb) {
|
||||
if (this.hash) {
|
||||
this.hash = this.hash.digest('hex');
|
||||
}
|
||||
this._writeStream.end(() => {
|
||||
this.emit('end');
|
||||
cb();
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
module.exports = VolatileFile;
|
||||
38
qwen/nodejs/node_modules/formidable/src/index.js
generated
vendored
Normal file
38
qwen/nodejs/node_modules/formidable/src/index.js
generated
vendored
Normal file
@@ -0,0 +1,38 @@
|
||||
'use strict';
|
||||
|
||||
const PersistentFile = require('./PersistentFile');
|
||||
const VolatileFile = require('./VolatileFile');
|
||||
const Formidable = require('./Formidable');
|
||||
const FormidableError = require('./FormidableError');
|
||||
|
||||
const plugins = require('./plugins/index');
|
||||
const parsers = require('./parsers/index');
|
||||
|
||||
// make it available without requiring the `new` keyword
|
||||
// if you want it access `const formidable.IncomingForm` as v1
|
||||
const formidable = (...args) => new Formidable(...args);
|
||||
|
||||
module.exports = Object.assign(formidable, {
|
||||
errors: FormidableError,
|
||||
File: PersistentFile,
|
||||
PersistentFile,
|
||||
VolatileFile,
|
||||
Formidable,
|
||||
formidable,
|
||||
|
||||
// alias
|
||||
IncomingForm: Formidable,
|
||||
|
||||
// parsers
|
||||
...parsers,
|
||||
parsers,
|
||||
|
||||
// misc
|
||||
defaultOptions: Formidable.DEFAULT_OPTIONS,
|
||||
enabledPlugins: Formidable.DEFAULT_OPTIONS.enabledPlugins,
|
||||
|
||||
// plugins
|
||||
plugins: {
|
||||
...plugins,
|
||||
},
|
||||
});
|
||||
21
qwen/nodejs/node_modules/formidable/src/parsers/Dummy.js
generated
vendored
Normal file
21
qwen/nodejs/node_modules/formidable/src/parsers/Dummy.js
generated
vendored
Normal file
@@ -0,0 +1,21 @@
|
||||
/* eslint-disable no-underscore-dangle */
|
||||
|
||||
'use strict';
|
||||
|
||||
const { Transform } = require('stream');
|
||||
|
||||
class DummyParser extends Transform {
|
||||
constructor(incomingForm, options = {}) {
|
||||
super();
|
||||
this.globalOptions = { ...options };
|
||||
this.incomingForm = incomingForm;
|
||||
}
|
||||
|
||||
_flush(callback) {
|
||||
this.incomingForm.ended = true;
|
||||
this.incomingForm._maybeEnd();
|
||||
callback();
|
||||
}
|
||||
}
|
||||
|
||||
module.exports = DummyParser;
|
||||
35
qwen/nodejs/node_modules/formidable/src/parsers/JSON.js
generated
vendored
Normal file
35
qwen/nodejs/node_modules/formidable/src/parsers/JSON.js
generated
vendored
Normal file
@@ -0,0 +1,35 @@
|
||||
/* eslint-disable no-underscore-dangle */
|
||||
|
||||
'use strict';
|
||||
|
||||
const { Transform } = require('stream');
|
||||
|
||||
class JSONParser extends Transform {
|
||||
constructor(options = {}) {
|
||||
super({ readableObjectMode: true });
|
||||
this.chunks = [];
|
||||
this.globalOptions = { ...options };
|
||||
}
|
||||
|
||||
_transform(chunk, encoding, callback) {
|
||||
this.chunks.push(String(chunk)); // todo consider using a string decoder
|
||||
callback();
|
||||
}
|
||||
|
||||
_flush(callback) {
|
||||
try {
|
||||
const fields = JSON.parse(this.chunks.join(''));
|
||||
Object.keys(fields).forEach((key) => {
|
||||
const value = fields[key];
|
||||
this.push({ key, value });
|
||||
});
|
||||
} catch (e) {
|
||||
callback(e);
|
||||
return;
|
||||
}
|
||||
this.chunks = null;
|
||||
callback();
|
||||
}
|
||||
}
|
||||
|
||||
module.exports = JSONParser;
|
||||
347
qwen/nodejs/node_modules/formidable/src/parsers/Multipart.js
generated
vendored
Normal file
347
qwen/nodejs/node_modules/formidable/src/parsers/Multipart.js
generated
vendored
Normal file
@@ -0,0 +1,347 @@
|
||||
/* eslint-disable no-fallthrough */
|
||||
/* eslint-disable no-bitwise */
|
||||
/* eslint-disable no-plusplus */
|
||||
/* eslint-disable no-underscore-dangle */
|
||||
|
||||
'use strict';
|
||||
|
||||
const { Transform } = require('stream');
|
||||
const errors = require('../FormidableError.js');
|
||||
|
||||
const { FormidableError } = errors;
|
||||
|
||||
let s = 0;
|
||||
const STATE = {
|
||||
PARSER_UNINITIALIZED: s++,
|
||||
START: s++,
|
||||
START_BOUNDARY: s++,
|
||||
HEADER_FIELD_START: s++,
|
||||
HEADER_FIELD: s++,
|
||||
HEADER_VALUE_START: s++,
|
||||
HEADER_VALUE: s++,
|
||||
HEADER_VALUE_ALMOST_DONE: s++,
|
||||
HEADERS_ALMOST_DONE: s++,
|
||||
PART_DATA_START: s++,
|
||||
PART_DATA: s++,
|
||||
PART_END: s++,
|
||||
END: s++,
|
||||
};
|
||||
|
||||
let f = 1;
|
||||
const FBOUNDARY = { PART_BOUNDARY: f, LAST_BOUNDARY: (f *= 2) };
|
||||
|
||||
const LF = 10;
|
||||
const CR = 13;
|
||||
const SPACE = 32;
|
||||
const HYPHEN = 45;
|
||||
const COLON = 58;
|
||||
const A = 97;
|
||||
const Z = 122;
|
||||
|
||||
function lower(c) {
|
||||
return c | 0x20;
|
||||
}
|
||||
|
||||
exports.STATES = {};
|
||||
|
||||
Object.keys(STATE).forEach((stateName) => {
|
||||
exports.STATES[stateName] = STATE[stateName];
|
||||
});
|
||||
|
||||
class MultipartParser extends Transform {
|
||||
constructor(options = {}) {
|
||||
super({ readableObjectMode: true });
|
||||
this.boundary = null;
|
||||
this.boundaryChars = null;
|
||||
this.lookbehind = null;
|
||||
this.bufferLength = 0;
|
||||
this.state = STATE.PARSER_UNINITIALIZED;
|
||||
|
||||
this.globalOptions = { ...options };
|
||||
this.index = null;
|
||||
this.flags = 0;
|
||||
}
|
||||
|
||||
_flush(done) {
|
||||
if (
|
||||
(this.state === STATE.HEADER_FIELD_START && this.index === 0) ||
|
||||
(this.state === STATE.PART_DATA && this.index === this.boundary.length)
|
||||
) {
|
||||
this._handleCallback('partEnd');
|
||||
this._handleCallback('end');
|
||||
done();
|
||||
} else if (this.state !== STATE.END) {
|
||||
done(
|
||||
new FormidableError(
|
||||
`MultipartParser.end(): stream ended unexpectedly: ${this.explain()}`,
|
||||
errors.malformedMultipart,
|
||||
400,
|
||||
),
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
initWithBoundary(str) {
|
||||
this.boundary = Buffer.from(`\r\n--${str}`);
|
||||
this.lookbehind = Buffer.alloc(this.boundary.length + 8);
|
||||
this.state = STATE.START;
|
||||
this.boundaryChars = {};
|
||||
|
||||
for (let i = 0; i < this.boundary.length; i++) {
|
||||
this.boundaryChars[this.boundary[i]] = true;
|
||||
}
|
||||
}
|
||||
|
||||
// eslint-disable-next-line max-params
|
||||
_handleCallback(name, buf, start, end) {
|
||||
if (start !== undefined && start === end) {
|
||||
return;
|
||||
}
|
||||
this.push({ name, buffer: buf, start, end });
|
||||
}
|
||||
|
||||
// eslint-disable-next-line max-statements
|
||||
_transform(buffer, _, done) {
|
||||
let i = 0;
|
||||
let prevIndex = this.index;
|
||||
let { index, state, flags } = this;
|
||||
const { lookbehind, boundary, boundaryChars } = this;
|
||||
const boundaryLength = boundary.length;
|
||||
const boundaryEnd = boundaryLength - 1;
|
||||
this.bufferLength = buffer.length;
|
||||
let c = null;
|
||||
let cl = null;
|
||||
|
||||
const setMark = (name, idx) => {
|
||||
this[`${name}Mark`] = typeof idx === 'number' ? idx : i;
|
||||
};
|
||||
|
||||
const clearMarkSymbol = (name) => {
|
||||
delete this[`${name}Mark`];
|
||||
};
|
||||
|
||||
const dataCallback = (name, shouldClear) => {
|
||||
const markSymbol = `${name}Mark`;
|
||||
if (!(markSymbol in this)) {
|
||||
return;
|
||||
}
|
||||
|
||||
if (!shouldClear) {
|
||||
this._handleCallback(name, buffer, this[markSymbol], buffer.length);
|
||||
setMark(name, 0);
|
||||
} else {
|
||||
this._handleCallback(name, buffer, this[markSymbol], i);
|
||||
clearMarkSymbol(name);
|
||||
}
|
||||
};
|
||||
|
||||
for (i = 0; i < this.bufferLength; i++) {
|
||||
c = buffer[i];
|
||||
switch (state) {
|
||||
case STATE.PARSER_UNINITIALIZED:
|
||||
return i;
|
||||
case STATE.START:
|
||||
index = 0;
|
||||
state = STATE.START_BOUNDARY;
|
||||
case STATE.START_BOUNDARY:
|
||||
if (index === boundary.length - 2) {
|
||||
if (c === HYPHEN) {
|
||||
flags |= FBOUNDARY.LAST_BOUNDARY;
|
||||
} else if (c !== CR) {
|
||||
return i;
|
||||
}
|
||||
index++;
|
||||
break;
|
||||
} else if (index - 1 === boundary.length - 2) {
|
||||
if (flags & FBOUNDARY.LAST_BOUNDARY && c === HYPHEN) {
|
||||
this._handleCallback('end');
|
||||
state = STATE.END;
|
||||
flags = 0;
|
||||
} else if (!(flags & FBOUNDARY.LAST_BOUNDARY) && c === LF) {
|
||||
index = 0;
|
||||
this._handleCallback('partBegin');
|
||||
state = STATE.HEADER_FIELD_START;
|
||||
} else {
|
||||
return i;
|
||||
}
|
||||
break;
|
||||
}
|
||||
|
||||
if (c !== boundary[index + 2]) {
|
||||
index = -2;
|
||||
}
|
||||
if (c === boundary[index + 2]) {
|
||||
index++;
|
||||
}
|
||||
break;
|
||||
case STATE.HEADER_FIELD_START:
|
||||
state = STATE.HEADER_FIELD;
|
||||
setMark('headerField');
|
||||
index = 0;
|
||||
case STATE.HEADER_FIELD:
|
||||
if (c === CR) {
|
||||
clearMarkSymbol('headerField');
|
||||
state = STATE.HEADERS_ALMOST_DONE;
|
||||
break;
|
||||
}
|
||||
|
||||
index++;
|
||||
if (c === HYPHEN) {
|
||||
break;
|
||||
}
|
||||
|
||||
if (c === COLON) {
|
||||
if (index === 1) {
|
||||
// empty header field
|
||||
return i;
|
||||
}
|
||||
dataCallback('headerField', true);
|
||||
state = STATE.HEADER_VALUE_START;
|
||||
break;
|
||||
}
|
||||
|
||||
cl = lower(c);
|
||||
if (cl < A || cl > Z) {
|
||||
return i;
|
||||
}
|
||||
break;
|
||||
case STATE.HEADER_VALUE_START:
|
||||
if (c === SPACE) {
|
||||
break;
|
||||
}
|
||||
|
||||
setMark('headerValue');
|
||||
state = STATE.HEADER_VALUE;
|
||||
case STATE.HEADER_VALUE:
|
||||
if (c === CR) {
|
||||
dataCallback('headerValue', true);
|
||||
this._handleCallback('headerEnd');
|
||||
state = STATE.HEADER_VALUE_ALMOST_DONE;
|
||||
}
|
||||
break;
|
||||
case STATE.HEADER_VALUE_ALMOST_DONE:
|
||||
if (c !== LF) {
|
||||
return i;
|
||||
}
|
||||
state = STATE.HEADER_FIELD_START;
|
||||
break;
|
||||
case STATE.HEADERS_ALMOST_DONE:
|
||||
if (c !== LF) {
|
||||
return i;
|
||||
}
|
||||
|
||||
this._handleCallback('headersEnd');
|
||||
state = STATE.PART_DATA_START;
|
||||
break;
|
||||
case STATE.PART_DATA_START:
|
||||
state = STATE.PART_DATA;
|
||||
setMark('partData');
|
||||
case STATE.PART_DATA:
|
||||
prevIndex = index;
|
||||
|
||||
if (index === 0) {
|
||||
// boyer-moore derrived algorithm to safely skip non-boundary data
|
||||
i += boundaryEnd;
|
||||
while (i < this.bufferLength && !(buffer[i] in boundaryChars)) {
|
||||
i += boundaryLength;
|
||||
}
|
||||
i -= boundaryEnd;
|
||||
c = buffer[i];
|
||||
}
|
||||
|
||||
if (index < boundary.length) {
|
||||
if (boundary[index] === c) {
|
||||
if (index === 0) {
|
||||
dataCallback('partData', true);
|
||||
}
|
||||
index++;
|
||||
} else {
|
||||
index = 0;
|
||||
}
|
||||
} else if (index === boundary.length) {
|
||||
index++;
|
||||
if (c === CR) {
|
||||
// CR = part boundary
|
||||
flags |= FBOUNDARY.PART_BOUNDARY;
|
||||
} else if (c === HYPHEN) {
|
||||
// HYPHEN = end boundary
|
||||
flags |= FBOUNDARY.LAST_BOUNDARY;
|
||||
} else {
|
||||
index = 0;
|
||||
}
|
||||
} else if (index - 1 === boundary.length) {
|
||||
if (flags & FBOUNDARY.PART_BOUNDARY) {
|
||||
index = 0;
|
||||
if (c === LF) {
|
||||
// unset the PART_BOUNDARY flag
|
||||
flags &= ~FBOUNDARY.PART_BOUNDARY;
|
||||
this._handleCallback('partEnd');
|
||||
this._handleCallback('partBegin');
|
||||
state = STATE.HEADER_FIELD_START;
|
||||
break;
|
||||
}
|
||||
} else if (flags & FBOUNDARY.LAST_BOUNDARY) {
|
||||
if (c === HYPHEN) {
|
||||
this._handleCallback('partEnd');
|
||||
this._handleCallback('end');
|
||||
state = STATE.END;
|
||||
flags = 0;
|
||||
} else {
|
||||
index = 0;
|
||||
}
|
||||
} else {
|
||||
index = 0;
|
||||
}
|
||||
}
|
||||
|
||||
if (index > 0) {
|
||||
// when matching a possible boundary, keep a lookbehind reference
|
||||
// in case it turns out to be a false lead
|
||||
lookbehind[index - 1] = c;
|
||||
} else if (prevIndex > 0) {
|
||||
// if our boundary turned out to be rubbish, the captured lookbehind
|
||||
// belongs to partData
|
||||
this._handleCallback('partData', lookbehind, 0, prevIndex);
|
||||
prevIndex = 0;
|
||||
setMark('partData');
|
||||
|
||||
// reconsider the current character even so it interrupted the sequence
|
||||
// it could be the beginning of a new sequence
|
||||
i--;
|
||||
}
|
||||
|
||||
break;
|
||||
case STATE.END:
|
||||
break;
|
||||
default:
|
||||
return i;
|
||||
}
|
||||
}
|
||||
|
||||
dataCallback('headerField');
|
||||
dataCallback('headerValue');
|
||||
dataCallback('partData');
|
||||
|
||||
this.index = index;
|
||||
this.state = state;
|
||||
this.flags = flags;
|
||||
|
||||
done();
|
||||
return this.bufferLength;
|
||||
}
|
||||
|
||||
explain() {
|
||||
return `state = ${MultipartParser.stateToString(this.state)}`;
|
||||
}
|
||||
}
|
||||
|
||||
// eslint-disable-next-line consistent-return
|
||||
MultipartParser.stateToString = (stateNumber) => {
|
||||
// eslint-disable-next-line no-restricted-syntax, guard-for-in
|
||||
for (const stateName in STATE) {
|
||||
const number = STATE[stateName];
|
||||
if (number === stateNumber) return stateName;
|
||||
}
|
||||
};
|
||||
|
||||
module.exports = Object.assign(MultipartParser, { STATES: exports.STATES });
|
||||
12
qwen/nodejs/node_modules/formidable/src/parsers/OctetStream.js
generated
vendored
Normal file
12
qwen/nodejs/node_modules/formidable/src/parsers/OctetStream.js
generated
vendored
Normal file
@@ -0,0 +1,12 @@
|
||||
'use strict';
|
||||
|
||||
const { PassThrough } = require('stream');
|
||||
|
||||
class OctetStreamParser extends PassThrough {
|
||||
constructor(options = {}) {
|
||||
super();
|
||||
this.globalOptions = { ...options };
|
||||
}
|
||||
}
|
||||
|
||||
module.exports = OctetStreamParser;
|
||||
38
qwen/nodejs/node_modules/formidable/src/parsers/Querystring.js
generated
vendored
Normal file
38
qwen/nodejs/node_modules/formidable/src/parsers/Querystring.js
generated
vendored
Normal file
@@ -0,0 +1,38 @@
|
||||
/* eslint-disable no-underscore-dangle */
|
||||
|
||||
'use strict';
|
||||
|
||||
const { Transform } = require('stream');
|
||||
const querystring = require('querystring');
|
||||
|
||||
// This is a buffering parser, not quite as nice as the multipart one.
|
||||
// If I find time I'll rewrite this to be fully streaming as well
|
||||
class QuerystringParser extends Transform {
|
||||
constructor(options = {}) {
|
||||
super({ readableObjectMode: true });
|
||||
this.globalOptions = { ...options };
|
||||
this.buffer = '';
|
||||
this.bufferLength = 0;
|
||||
}
|
||||
|
||||
_transform(buffer, encoding, callback) {
|
||||
this.buffer += buffer.toString('ascii');
|
||||
this.bufferLength = this.buffer.length;
|
||||
callback();
|
||||
}
|
||||
|
||||
_flush(callback) {
|
||||
const fields = querystring.parse(this.buffer, '&', '=');
|
||||
// eslint-disable-next-line no-restricted-syntax, guard-for-in
|
||||
for (const key in fields) {
|
||||
this.push({
|
||||
key,
|
||||
value: fields[key],
|
||||
});
|
||||
}
|
||||
this.buffer = '';
|
||||
callback();
|
||||
}
|
||||
}
|
||||
|
||||
module.exports = QuerystringParser;
|
||||
121
qwen/nodejs/node_modules/formidable/src/parsers/StreamingQuerystring.js
generated
vendored
Normal file
121
qwen/nodejs/node_modules/formidable/src/parsers/StreamingQuerystring.js
generated
vendored
Normal file
@@ -0,0 +1,121 @@
|
||||
// not used
|
||||
/* eslint-disable no-underscore-dangle */
|
||||
|
||||
'use strict';
|
||||
|
||||
const { Transform } = require('stream');
|
||||
const errors = require('../FormidableError.js');
|
||||
|
||||
const { FormidableError } = errors;
|
||||
|
||||
const AMPERSAND = 38;
|
||||
const EQUALS = 61;
|
||||
|
||||
class QuerystringParser extends Transform {
|
||||
constructor(options = {}) {
|
||||
super({ readableObjectMode: true });
|
||||
|
||||
const { maxFieldSize } = options;
|
||||
this.maxFieldLength = maxFieldSize;
|
||||
this.buffer = Buffer.from('');
|
||||
this.fieldCount = 0;
|
||||
this.sectionStart = 0;
|
||||
this.key = '';
|
||||
this.readingKey = true;
|
||||
}
|
||||
|
||||
_transform(buffer, encoding, callback) {
|
||||
let len = buffer.length;
|
||||
if (this.buffer && this.buffer.length) {
|
||||
// we have some data left over from the last write which we are in the middle of processing
|
||||
len += this.buffer.length;
|
||||
buffer = Buffer.concat([this.buffer, buffer], len);
|
||||
}
|
||||
|
||||
for (let i = this.buffer.length || 0; i < len; i += 1) {
|
||||
const c = buffer[i];
|
||||
if (this.readingKey) {
|
||||
// KEY, check for =
|
||||
if (c === EQUALS) {
|
||||
this.key = this.getSection(buffer, i);
|
||||
this.readingKey = false;
|
||||
this.sectionStart = i + 1;
|
||||
} else if (c === AMPERSAND) {
|
||||
// just key, no value. Prepare to read another key
|
||||
this.emitField(this.getSection(buffer, i));
|
||||
this.sectionStart = i + 1;
|
||||
}
|
||||
// VALUE, check for &
|
||||
} else if (c === AMPERSAND) {
|
||||
this.emitField(this.key, this.getSection(buffer, i));
|
||||
this.sectionStart = i + 1;
|
||||
}
|
||||
|
||||
if (
|
||||
this.maxFieldLength &&
|
||||
i - this.sectionStart === this.maxFieldLength
|
||||
) {
|
||||
callback(
|
||||
new FormidableError(
|
||||
`${
|
||||
this.readingKey ? 'Key' : `Value for ${this.key}`
|
||||
} longer than maxFieldLength`,
|
||||
),
|
||||
errors.maxFieldsSizeExceeded,
|
||||
413,
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
// Prepare the remaining key or value (from sectionStart to the end) for the next write() or for end()
|
||||
len -= this.sectionStart;
|
||||
if (len) {
|
||||
// i.e. Unless the last character was a & or =
|
||||
this.buffer = Buffer.from(this.buffer, 0, this.sectionStart);
|
||||
} else this.buffer = null;
|
||||
|
||||
this.sectionStart = 0;
|
||||
callback();
|
||||
}
|
||||
|
||||
_flush(callback) {
|
||||
// Emit the last field
|
||||
if (this.readingKey) {
|
||||
// we only have a key if there's something in the buffer. We definitely have no value
|
||||
if (this.buffer && this.buffer.length){
|
||||
this.emitField(this.buffer.toString('ascii'));
|
||||
}
|
||||
} else {
|
||||
// We have a key, we may or may not have a value
|
||||
this.emitField(
|
||||
this.key,
|
||||
this.buffer && this.buffer.length && this.buffer.toString('ascii'),
|
||||
);
|
||||
}
|
||||
this.buffer = '';
|
||||
callback();
|
||||
}
|
||||
|
||||
getSection(buffer, i) {
|
||||
if (i === this.sectionStart) return '';
|
||||
|
||||
return buffer.toString('ascii', this.sectionStart, i);
|
||||
}
|
||||
|
||||
emitField(key, val) {
|
||||
this.key = '';
|
||||
this.readingKey = true;
|
||||
this.push({ key, value: val || '' });
|
||||
}
|
||||
}
|
||||
|
||||
module.exports = QuerystringParser;
|
||||
|
||||
// const q = new QuerystringParser({maxFieldSize: 100});
|
||||
// (async function() {
|
||||
// for await (const chunk of q) {
|
||||
// console.log(chunk);
|
||||
// }
|
||||
// })();
|
||||
// q.write("a=b&c=d")
|
||||
// q.end()
|
||||
17
qwen/nodejs/node_modules/formidable/src/parsers/index.js
generated
vendored
Normal file
17
qwen/nodejs/node_modules/formidable/src/parsers/index.js
generated
vendored
Normal file
@@ -0,0 +1,17 @@
|
||||
'use strict';
|
||||
|
||||
const JSONParser = require('./JSON');
|
||||
const DummyParser = require('./Dummy');
|
||||
const MultipartParser = require('./Multipart');
|
||||
const OctetStreamParser = require('./OctetStream');
|
||||
const QueryStringParser = require('./Querystring');
|
||||
|
||||
Object.assign(exports, {
|
||||
JSONParser,
|
||||
DummyParser,
|
||||
MultipartParser,
|
||||
OctetStreamParser,
|
||||
OctetstreamParser: OctetStreamParser,
|
||||
QueryStringParser,
|
||||
QuerystringParser: QueryStringParser,
|
||||
});
|
||||
13
qwen/nodejs/node_modules/formidable/src/plugins/index.js
generated
vendored
Normal file
13
qwen/nodejs/node_modules/formidable/src/plugins/index.js
generated
vendored
Normal file
@@ -0,0 +1,13 @@
|
||||
'use strict';
|
||||
|
||||
const octetstream = require('./octetstream');
|
||||
const querystring = require('./querystring');
|
||||
const multipart = require('./multipart');
|
||||
const json = require('./json');
|
||||
|
||||
Object.assign(exports, {
|
||||
octetstream,
|
||||
querystring,
|
||||
multipart,
|
||||
json,
|
||||
});
|
||||
38
qwen/nodejs/node_modules/formidable/src/plugins/json.js
generated
vendored
Normal file
38
qwen/nodejs/node_modules/formidable/src/plugins/json.js
generated
vendored
Normal file
@@ -0,0 +1,38 @@
|
||||
/* eslint-disable no-underscore-dangle */
|
||||
|
||||
'use strict';
|
||||
|
||||
const JSONParser = require('../parsers/JSON');
|
||||
|
||||
// the `options` is also available through the `this.options` / `formidable.options`
|
||||
module.exports = function plugin(formidable, options) {
|
||||
// the `this` context is always formidable, as the first argument of a plugin
|
||||
// but this allows us to customize/test each plugin
|
||||
|
||||
/* istanbul ignore next */
|
||||
const self = this || formidable;
|
||||
|
||||
if (/json/i.test(self.headers['content-type'])) {
|
||||
init.call(self, self, options);
|
||||
}
|
||||
};
|
||||
|
||||
// Note that it's a good practice (but it's up to you) to use the `this.options` instead
|
||||
// of the passed `options` (second) param, because when you decide
|
||||
// to test the plugin you can pass custom `this` context to it (and so `this.options`)
|
||||
function init(_self, _opts) {
|
||||
this.type = 'json';
|
||||
|
||||
const parser = new JSONParser(this.options);
|
||||
|
||||
parser.on('data', ({ key, value }) => {
|
||||
this.emit('field', key, value);
|
||||
});
|
||||
|
||||
parser.once('end', () => {
|
||||
this.ended = true;
|
||||
this._maybeEnd();
|
||||
});
|
||||
|
||||
this._parser = parser;
|
||||
}
|
||||
173
qwen/nodejs/node_modules/formidable/src/plugins/multipart.js
generated
vendored
Normal file
173
qwen/nodejs/node_modules/formidable/src/plugins/multipart.js
generated
vendored
Normal file
@@ -0,0 +1,173 @@
|
||||
/* eslint-disable no-underscore-dangle */
|
||||
|
||||
'use strict';
|
||||
|
||||
const { Stream } = require('stream');
|
||||
const MultipartParser = require('../parsers/Multipart');
|
||||
const errors = require('../FormidableError.js');
|
||||
|
||||
const { FormidableError } = errors;
|
||||
|
||||
// the `options` is also available through the `options` / `formidable.options`
|
||||
module.exports = function plugin(formidable, options) {
|
||||
// the `this` context is always formidable, as the first argument of a plugin
|
||||
// but this allows us to customize/test each plugin
|
||||
|
||||
/* istanbul ignore next */
|
||||
const self = this || formidable;
|
||||
|
||||
// NOTE: we (currently) support both multipart/form-data and multipart/related
|
||||
const multipart = /multipart/i.test(self.headers['content-type']);
|
||||
|
||||
if (multipart) {
|
||||
const m = self.headers['content-type'].match(
|
||||
/boundary=(?:"([^"]+)"|([^;]+))/i,
|
||||
);
|
||||
if (m) {
|
||||
const initMultipart = createInitMultipart(m[1] || m[2]);
|
||||
initMultipart.call(self, self, options); // lgtm [js/superfluous-trailing-arguments]
|
||||
} else {
|
||||
const err = new FormidableError(
|
||||
'bad content-type header, no multipart boundary',
|
||||
errors.missingMultipartBoundary,
|
||||
400,
|
||||
);
|
||||
self._error(err);
|
||||
}
|
||||
}
|
||||
};
|
||||
|
||||
// Note that it's a good practice (but it's up to you) to use the `this.options` instead
|
||||
// of the passed `options` (second) param, because when you decide
|
||||
// to test the plugin you can pass custom `this` context to it (and so `this.options`)
|
||||
function createInitMultipart(boundary) {
|
||||
return function initMultipart() {
|
||||
this.type = 'multipart';
|
||||
|
||||
const parser = new MultipartParser(this.options);
|
||||
let headerField;
|
||||
let headerValue;
|
||||
let part;
|
||||
|
||||
parser.initWithBoundary(boundary);
|
||||
|
||||
// eslint-disable-next-line max-statements, consistent-return
|
||||
parser.on('data', ({ name, buffer, start, end }) => {
|
||||
if (name === 'partBegin') {
|
||||
part = new Stream();
|
||||
part.readable = true;
|
||||
part.headers = {};
|
||||
part.name = null;
|
||||
part.originalFilename = null;
|
||||
part.mimetype = null;
|
||||
|
||||
part.transferEncoding = this.options.encoding;
|
||||
part.transferBuffer = '';
|
||||
|
||||
headerField = '';
|
||||
headerValue = '';
|
||||
} else if (name === 'headerField') {
|
||||
headerField += buffer.toString(this.options.encoding, start, end);
|
||||
} else if (name === 'headerValue') {
|
||||
headerValue += buffer.toString(this.options.encoding, start, end);
|
||||
} else if (name === 'headerEnd') {
|
||||
headerField = headerField.toLowerCase();
|
||||
part.headers[headerField] = headerValue;
|
||||
|
||||
// matches either a quoted-string or a token (RFC 2616 section 19.5.1)
|
||||
const m = headerValue.match(
|
||||
// eslint-disable-next-line no-useless-escape
|
||||
/\bname=("([^"]*)"|([^\(\)<>@,;:\\"\/\[\]\?=\{\}\s\t/]+))/i,
|
||||
);
|
||||
if (headerField === 'content-disposition') {
|
||||
if (m) {
|
||||
part.name = m[2] || m[3] || '';
|
||||
}
|
||||
|
||||
part.originalFilename = this._getFileName(headerValue);
|
||||
} else if (headerField === 'content-type') {
|
||||
part.mimetype = headerValue;
|
||||
} else if (headerField === 'content-transfer-encoding') {
|
||||
part.transferEncoding = headerValue.toLowerCase();
|
||||
}
|
||||
|
||||
headerField = '';
|
||||
headerValue = '';
|
||||
} else if (name === 'headersEnd') {
|
||||
switch (part.transferEncoding) {
|
||||
case 'binary':
|
||||
case '7bit':
|
||||
case '8bit':
|
||||
case 'utf-8': {
|
||||
const dataPropagation = (ctx) => {
|
||||
if (ctx.name === 'partData') {
|
||||
part.emit('data', ctx.buffer.slice(ctx.start, ctx.end));
|
||||
}
|
||||
};
|
||||
const dataStopPropagation = (ctx) => {
|
||||
if (ctx.name === 'partEnd') {
|
||||
part.emit('end');
|
||||
parser.off('data', dataPropagation);
|
||||
parser.off('data', dataStopPropagation);
|
||||
}
|
||||
};
|
||||
parser.on('data', dataPropagation);
|
||||
parser.on('data', dataStopPropagation);
|
||||
break;
|
||||
}
|
||||
case 'base64': {
|
||||
const dataPropagation = (ctx) => {
|
||||
if (ctx.name === 'partData') {
|
||||
part.transferBuffer += ctx.buffer
|
||||
.slice(ctx.start, ctx.end)
|
||||
.toString('ascii');
|
||||
|
||||
/*
|
||||
four bytes (chars) in base64 converts to three bytes in binary
|
||||
encoding. So we should always work with a number of bytes that
|
||||
can be divided by 4, it will result in a number of buytes that
|
||||
can be divided vy 3.
|
||||
*/
|
||||
const offset = parseInt(part.transferBuffer.length / 4, 10) * 4;
|
||||
part.emit(
|
||||
'data',
|
||||
Buffer.from(
|
||||
part.transferBuffer.substring(0, offset),
|
||||
'base64',
|
||||
),
|
||||
);
|
||||
part.transferBuffer = part.transferBuffer.substring(offset);
|
||||
}
|
||||
};
|
||||
const dataStopPropagation = (ctx) => {
|
||||
if (ctx.name === 'partEnd') {
|
||||
part.emit('data', Buffer.from(part.transferBuffer, 'base64'));
|
||||
part.emit('end');
|
||||
parser.off('data', dataPropagation);
|
||||
parser.off('data', dataStopPropagation);
|
||||
}
|
||||
};
|
||||
parser.on('data', dataPropagation);
|
||||
parser.on('data', dataStopPropagation);
|
||||
break;
|
||||
}
|
||||
default:
|
||||
return this._error(
|
||||
new FormidableError(
|
||||
'unknown transfer-encoding',
|
||||
errors.unknownTransferEncoding,
|
||||
501,
|
||||
),
|
||||
);
|
||||
}
|
||||
|
||||
this.onPart(part);
|
||||
} else if (name === 'end') {
|
||||
this.ended = true;
|
||||
this._maybeEnd();
|
||||
}
|
||||
});
|
||||
|
||||
this._parser = parser;
|
||||
};
|
||||
}
|
||||
86
qwen/nodejs/node_modules/formidable/src/plugins/octetstream.js
generated
vendored
Normal file
86
qwen/nodejs/node_modules/formidable/src/plugins/octetstream.js
generated
vendored
Normal file
@@ -0,0 +1,86 @@
|
||||
/* eslint-disable no-underscore-dangle */
|
||||
|
||||
'use strict';
|
||||
|
||||
const OctetStreamParser = require('../parsers/OctetStream');
|
||||
|
||||
// the `options` is also available through the `options` / `formidable.options`
|
||||
module.exports = function plugin(formidable, options) {
|
||||
// the `this` context is always formidable, as the first argument of a plugin
|
||||
// but this allows us to customize/test each plugin
|
||||
|
||||
/* istanbul ignore next */
|
||||
const self = this || formidable;
|
||||
|
||||
if (/octet-stream/i.test(self.headers['content-type'])) {
|
||||
init.call(self, self, options);
|
||||
}
|
||||
|
||||
return self;
|
||||
};
|
||||
|
||||
// Note that it's a good practice (but it's up to you) to use the `this.options` instead
|
||||
// of the passed `options` (second) param, because when you decide
|
||||
// to test the plugin you can pass custom `this` context to it (and so `this.options`)
|
||||
function init(_self, _opts) {
|
||||
this.type = 'octet-stream';
|
||||
const originalFilename = this.headers['x-file-name'];
|
||||
const mimetype = this.headers['content-type'];
|
||||
|
||||
const thisPart = {
|
||||
originalFilename,
|
||||
mimetype,
|
||||
};
|
||||
const newFilename = this._getNewName(thisPart);
|
||||
const filepath = this._joinDirectoryName(newFilename);
|
||||
const file = this._newFile({
|
||||
newFilename,
|
||||
filepath,
|
||||
originalFilename,
|
||||
mimetype,
|
||||
});
|
||||
|
||||
this.emit('fileBegin', originalFilename, file);
|
||||
file.open();
|
||||
this.openedFiles.push(file);
|
||||
this._flushing += 1;
|
||||
|
||||
this._parser = new OctetStreamParser(this.options);
|
||||
|
||||
// Keep track of writes that haven't finished so we don't emit the file before it's done being written
|
||||
let outstandingWrites = 0;
|
||||
|
||||
this._parser.on('data', (buffer) => {
|
||||
this.pause();
|
||||
outstandingWrites += 1;
|
||||
|
||||
file.write(buffer, () => {
|
||||
outstandingWrites -= 1;
|
||||
this.resume();
|
||||
|
||||
if (this.ended) {
|
||||
this._parser.emit('doneWritingFile');
|
||||
}
|
||||
});
|
||||
});
|
||||
|
||||
this._parser.on('end', () => {
|
||||
this._flushing -= 1;
|
||||
this.ended = true;
|
||||
|
||||
const done = () => {
|
||||
file.end(() => {
|
||||
this.emit('file', 'file', file);
|
||||
this._maybeEnd();
|
||||
});
|
||||
};
|
||||
|
||||
if (outstandingWrites === 0) {
|
||||
done();
|
||||
} else {
|
||||
this._parser.once('doneWritingFile', done);
|
||||
}
|
||||
});
|
||||
|
||||
return this;
|
||||
}
|
||||
42
qwen/nodejs/node_modules/formidable/src/plugins/querystring.js
generated
vendored
Normal file
42
qwen/nodejs/node_modules/formidable/src/plugins/querystring.js
generated
vendored
Normal file
@@ -0,0 +1,42 @@
|
||||
/* eslint-disable no-underscore-dangle */
|
||||
|
||||
'use strict';
|
||||
|
||||
const QuerystringParser = require('../parsers/Querystring');
|
||||
|
||||
// the `options` is also available through the `this.options` / `formidable.options`
|
||||
module.exports = function plugin(formidable, options) {
|
||||
// the `this` context is always formidable, as the first argument of a plugin
|
||||
// but this allows us to customize/test each plugin
|
||||
|
||||
/* istanbul ignore next */
|
||||
const self = this || formidable;
|
||||
|
||||
if (/urlencoded/i.test(self.headers['content-type'])) {
|
||||
init.call(self, self, options);
|
||||
}
|
||||
|
||||
return self;
|
||||
};
|
||||
|
||||
// Note that it's a good practice (but it's up to you) to use the `this.options` instead
|
||||
// of the passed `options` (second) param, because when you decide
|
||||
// to test the plugin you can pass custom `this` context to it (and so `this.options`)
|
||||
function init(_self, _opts) {
|
||||
this.type = 'urlencoded';
|
||||
|
||||
const parser = new QuerystringParser(this.options);
|
||||
|
||||
parser.on('data', ({ key, value }) => {
|
||||
this.emit('field', key, value);
|
||||
});
|
||||
|
||||
parser.once('end', () => {
|
||||
this.ended = true;
|
||||
this._maybeEnd();
|
||||
});
|
||||
|
||||
this._parser = parser;
|
||||
|
||||
return this;
|
||||
}
|
||||
Reference in New Issue
Block a user