Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -322,7 +322,7 @@ See it's defaults in [src/Formidable.js DEFAULT_OPTIONS](./src/Formidable.js)
extensions of the original files or not
- `options.allowEmptyFiles` **{boolean}** - default `false`; allow upload empty
files
- `options.minFileSize` **{number}** - default `1` (1byte); the minium size of
- `options.minFileSize` **{number}** - default `1` (1byte); the minimum size of
uploaded file.
- `options.maxFiles` **{number}** - default `Infinity`;
limit the amount of uploaded files, set Infinity for unlimited
Expand Down
58 changes: 29 additions & 29 deletions README_pt_BR.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,12 +25,12 @@ no Twitter.
[![Make A Pull Request][prs-welcome-img]][prs-welcome-url]

Este projeto é [semanticamente versionado](https://semver.org) e está disponível como
parte da [Assinatura Tidelift][tidelift-url] para nível profissional
parte da [Assinatura Tidelift][tidelift-url] para nível professional
garantias, suporte aprimorado e segurança.
[Saiba mais.](https://tidelift.com/subscription/pkg/npm-formidable?utm_source=npm-formidable&utm_medium=referral&utm_campaign=enterprise)

_Os mantenedores do `formidable` e milhares de outros pacotes estão trabalhando
com Tidelift para fornecer suporte comercial e manutenção para o Open Source
com Tidelift para fornecer suporte commercial e manutenção para o Open Source
dependências que você usa para construir seus aplicativos. Economize tempo, reduza riscos e
melhorar a integridade do código, enquanto paga aos mantenedores das dependências exatas que você
usar._
Expand Down Expand Up @@ -61,7 +61,7 @@ fechado, mas se você estiver interessado, podemos discuti-lo e adicioná-lo ap
[`options.fileWriteStreamHandler`](#options))
- [API de plug-ins](#useplugin-plugin) - permitindo analisadores e plug-ins personalizados
- Baixo consumo de memória
- Tratamento de erros gracioso
- Tratamento de errors gracioso
- Cobertura de teste muito alta

## Instalar
Expand Down Expand Up @@ -106,7 +106,7 @@ const server = http.createServer((req, res) => {

form.parse(req, (err, fields, files) => {
if (err) {
// exemplo para verificar um erro muito específico
// exemplo para verificar um error muito específico
if (err.code === formidableErrors.maxFieldsExceeded) {

}
Expand Down Expand Up @@ -256,7 +256,7 @@ Anteriormente, os números giravam em torno de ~ 500 mb/s. Atualmente com a muda
Node.js Streams API, é mais rápido. Você pode ver claramente as diferenças entre as
versões do Node.

_Observação: um benchmarking muito melhor pode e deve ser feito no futuro._
_Observação: um benchmarking muito melhor pode e deve set feito no futuro._

Benchmark realizado em 8 GB de RAM, Xeon X3440 (2,53 GHz, 4 núcleos, 8 threads)

Expand Down Expand Up @@ -289,8 +289,8 @@ Benchmark realizado em 8 GB de RAM, Xeon X3440 (2,53 GHz, 4 núcleos, 8 threads)

Todos os mostrados são equivalentes.

_Por favor, passe [`options`](#options) para a função/construtor, não atribuindo
eles para a instância `form`_
_Por favor, passe [`options`](#options) para a função/constructor, não atribuindo
else para a instância `form`_

```js
import formidable from 'formidable';
Expand All @@ -313,7 +313,7 @@ Veja seus padrões em [src/Formidable.js DEFAULT_OPTIONS](./src/Formidable.js)
limitar o tamanho de cada arquivo carregado.
- `options.maxTotalFileSize` **{number}** - padrão `options.maxFileSize`;
limitar o tamanho do lote de arquivos carregados.
- `options.maxFields` **{number}** - padrão `1000`; limite o número de campos, defina Infinity para ilimitado
- `options.maxFields` **{number}** - padrão `1000`; limit o número de campos, defina Infinity para ilimitado
- `options.maxFieldsSize` **{number}** - padrão `20 * 1024 * 1024` (20mb);
limitar a quantidade de memória que todos os campos juntos (exceto arquivos) podem alocar em
bytes.
Expand All @@ -337,7 +337,7 @@ Veja seus padrões em [src/Formidable.js DEFAULT_OPTIONS](./src/Formidable.js)

#### `options.filename` **{function}** function (name, ext, part, form) -> string

onde a parte pode ser decomposta como
onde a parte pode set decomposta como

```js
const { originalFilename, mimetype} = part;
Expand All @@ -358,7 +358,7 @@ form.bytesExpected;

#### `options.filter` **{function}** function ({name, originalFilename, mimetype}) -> boolean

**Observação:** use uma variável externa para cancelar todos os uploads no primeiro erro
**Observação:** use uma variável externa para cancelar todos os uploads no primeiro error

```js
const options = {
Expand Down Expand Up @@ -407,7 +407,7 @@ project-name

para colocar arquivos em uploads.

Omitir `__dirname` tornaria o caminho relativo ao diretório de trabalho atual. Isso seria o mesmo se server.js fosse iniciado a partir de src, mas não de project-name.
Omitir `__dirname` tornaria o caminho relativo ao diretório de trabalho actual. Isso seria o mesmo se server.js fosse iniciado a partir de src, mas não de project-name.


`null` usará o padrão que é `os.tmpdir()`
Expand All @@ -424,10 +424,10 @@ createNecessaryDirectoriesSync(`${uploadPath}/x`);


No exemplo abaixo, escutamos alguns eventos e os direcionamos para o ouvinte `data`, para
que você possa fazer o que quiser lá, com base em se é antes do arquivo ser emitido, o valor do
cabeçalho, o nome do cabeçalho, no campo , em arquivo e etc.
que você possa fazer o que quiser lá, com base em se é antes do arquivo set emitido, o valor do
cabeçalho, o gnome do cabeçalho, no campo , em arquivo e etc.

Ou a outra maneira poderia ser apenas substituir o `form.onPart` como é mostrado um pouco
Ou a outra maneira poderia set apenas substituir o `form.onPart` como é mostrado um pouco
mais tarde.

```js
Expand Down Expand Up @@ -509,7 +509,7 @@ form.parse(req, (error, fields, files) => {
});
```
**Importante observar**, é que dentro do plugin `this.options`, `self.options` e
`options` PODEM ou NÃO ser iguais. A melhor prática geral é sempre usar o
`options` PODEM ou NÃO set iguais. A melhor prática geral é sempre usar o
`this`, para que você possa testar seu plugin mais tarde de forma independente e mais fácil.

Se você quiser desabilitar alguns recursos de análise do Formidable, você pode desabilitar
Expand All @@ -526,10 +526,10 @@ const form = formidable({
});
```

**Esteja ciente** de que a ordem _PODE_ ser importante também. Os nomes correspondem 1:1 a
**Esteja ciente** de que a ordem _PODE_ set importante também. Os gnomes correspondem 1:1 a
arquivos na pasta [src/plugins/](./src/plugins).

Solicitações pull para novos plug-ins integrados PODEM ser aceitas - por exemplo, analisador de
Solicitações pull para novos plug-ins integrados PODEM set aceitas - por exemplo, analisador de
querystring mais avançado. Adicione seu plugin como um novo arquivo na pasta `src/plugins/` (em letras minúsculas) e
siga como os outros plugins são feitos.

Expand All @@ -550,7 +550,7 @@ form.onPart = (part) => {
};
```

Por exemplo, force Formidable a ser usado apenas em "partes" que não sejam de arquivo (ou seja, html
Por exemplo, force Formidable a set usado apenas em "partes" que não sejam de arquivo (ou seja, html
Campos)

```js
Expand Down Expand Up @@ -578,7 +578,7 @@ export interface File {
// caso você esteja insatisfeito com a forma como o formidable gera um caminho temporário para seus arquivos.
file.filepath: string;

// O nome que este arquivo tinha de acordo com o cliente de upload.
// O gnome que este arquivo tinha de acordo com o cliente de upload.
file.originalFilename: string | null;

// calculado com base nas opções fornecidas.
Expand All @@ -605,7 +605,7 @@ o arquivo que é útil para registrar e responder a solicitações.
### Eventos

#### `'progress'`
Emitido após cada bloco de entrada de dados que foi analisado. Pode ser usado para rolar sua própria barra de progresso. **Aviso** Use isso
Emitido após cada bloco de entrada de dados que foi analisado. Pode set usado para rolar sua própria barra de progresso. **Aviso** Use isso
apenas para a barra de progresso do lado do servidor. No lado do cliente, é melhor usar `XMLHttpRequest` com `xhr.upload.onprogress =`

```js
Expand All @@ -628,10 +628,10 @@ Use este evento se desejar transmitir o arquivo para outro lugar enquanto armaze
```js
form.on('fileBegin', (formName, file) => {
// acessível aqui
// formName o nome no formulário (<input name="thisname" type="file">) ou http filename para octetstream
// file.originalFilename http filename ou null se houver um erro de análise
// formName o gnome no formulário (<input name="thisname" type="file">) ou http filename para octetstream
// file.originalFilename http filename ou null se houver um error de análise
// file.newFilename gerou hexoid ou o que options.filename retornou
// file.filepath nome do caminho padrão de acordo com options.uploadDir e options.filename
// file.filepath gnome do caminho padrão de acordo com options.uploadDir e options.filename
// file.filepath = CUSTOM_PATH // para alterar o caminho final
});
```
Expand All @@ -651,8 +651,8 @@ form.on('file', (formname, file) => {

#### `'error'`

Emitido quando há um erro no processamento do formulário recebido. Uma solicitação que
apresenta um erro é pausada automaticamente, você terá que chamar manualmente
Emitido quando há um error no processamento do formulário recebido. Uma solicitação que
apresenta um error é pausada automaticamente, você terá que chamar manualmente
`request.resume()` se você quiser que a requisição continue disparando eventos `'data'`.

Pode ter `error.httpCode` e `error.code` anexados.
Expand All @@ -663,8 +663,8 @@ form.on('error', (err) => {});

#### `'aborted'`

Emitido quando a requisição foi abortada pelo usuário. Agora isso pode ser devido a um
evento 'timeout' ou 'close' no soquete. Após este evento ser emitido, um
Emitido quando a requisição foi abortada pelo usuário. Agora isso pode set devido a um
evento 'timeout' ou 'close' no soquete. Após este evento set emitido, um
O evento `error` seguirá. No futuro, haverá um 'timeout' separado
evento (precisa de uma mudança no núcleo do nó).

Expand Down Expand Up @@ -705,7 +705,7 @@ form.parse(request, async (error, fieldsMultiple, files) => {
#### readBooleans

Html form input type="checkbox" envia apenas o valor "on" se marcado,
converta-o em booleanos para cada entrada que deve ser enviada como uma caixa de seleção, use somente após a chamada de firstValues ou similar.
converta-o em booleanos para cada entrada que deve set enviada como uma caixa de seleção, use somente após a chamada de firstValues ou similar.

```js
import { firstValues } from 'formidable/src/helpers/firstValues.js';
Expand Down Expand Up @@ -735,7 +735,7 @@ form.parse(request, async (error, fieldsMultiple, files) => {

## Contribuindo

Se a documentação não estiver clara ou tiver um erro de digitação, clique no botão `Edit` da página (ícone de lápis) e sugira uma correção.
Se a documentação não estiver clara ou tiver um error de digitação, clique no botão `Edit` da página (ícone de lápis) e sugira uma correção.
Se você gostaria de nos ajudar a corrigir
um bug ou adicionar um novo recurso, verifique nosso [Contributing
Guide][contribuindo-url]. Pull requests são bem-vindos!
Expand Down
2 changes: 1 addition & 1 deletion benchmark/server.js
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
// inital copy of with-http.js
// initial copy of with-http.js
// made a copy so that examples can be changed without impacting tests
import http from 'node:http';
import slugify from '@sindresorhus/slugify';
Expand Down
2 changes: 1 addition & 1 deletion examples/forceBuffer.js
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
// warning: forcing file into a Buffer elminates the benefits of using streams and may cause memory overflow
// warning: forcing file into a Buffer eliminates the benefits of using streams and may cause memory overflow
import http from 'node:http';
import { Buffer } from 'node:buffer'
import { Writable } from 'node:stream';
Expand Down
2 changes: 1 addition & 1 deletion examples/with-http.js
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ const server = http.createServer((req, res) => {
return 'invalid';
}

// return 'yo.txt'; // or completly different name
// return 'yo.txt'; // or completely different name
// return 'z/yo.txt'; // subdirectory
return originalFilename.split("/").map((subdir) => {
return slugify(subdir, {separator: ''}); // slugify to avoid invalid filenames
Expand Down