diff --git a/README.md b/README.md index 0efe3ec0..076207df 100644 --- a/README.md +++ b/README.md @@ -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 diff --git a/README_pt_BR.md b/README_pt_BR.md index 06977371..f802ea86 100644 --- a/README_pt_BR.md +++ b/README_pt_BR.md @@ -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._ @@ -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 @@ -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) { } @@ -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) @@ -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'; @@ -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. @@ -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; @@ -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 = { @@ -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()` @@ -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 @@ -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 @@ -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. @@ -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 @@ -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. @@ -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 @@ -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 () ou http filename para octetstream - // file.originalFilename http filename ou null se houver um erro de análise + // formName o gnome no formulário () 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 }); ``` @@ -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. @@ -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ó). @@ -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'; @@ -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! diff --git a/benchmark/server.js b/benchmark/server.js index f99f176b..e3bf46c4 100644 --- a/benchmark/server.js +++ b/benchmark/server.js @@ -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'; diff --git a/examples/forceBuffer.js b/examples/forceBuffer.js index 47411499..d46fe7a7 100644 --- a/examples/forceBuffer.js +++ b/examples/forceBuffer.js @@ -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'; diff --git a/examples/with-http.js b/examples/with-http.js index 91d61a3b..7f53e125 100644 --- a/examples/with-http.js +++ b/examples/with-http.js @@ -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