From 530985232ec2cc648c026afd6edc38e17add77b4 Mon Sep 17 00:00:00 2001 From: Diogo Marciano Date: Sat, 21 Nov 2026 15:43:26 -0300 Subject: [PATCH] Translate "FormData" article to Portuguese Translates the article text and the user-facing message strings returned by the demo server (post.view/server.js), keeping field names and other code identifiers untranslated. Co-Authored-By: Claude Sonnet 5 --- 5-network/02-formdata/article.md | 86 +++++++++++------------ 5-network/02-formdata/post.view/server.js | 6 +- 2 files changed, 46 insertions(+), 46 deletions(-) diff --git a/5-network/02-formdata/article.md b/5-network/02-formdata/article.md index a73d554b1..354d2efe7 100644 --- a/5-network/02-formdata/article.md +++ b/5-network/02-formdata/article.md @@ -1,26 +1,26 @@ # FormData -This chapter is about sending HTML forms: with or without files, with additional fields and so on. +Este capítulo é sobre o envio de formulários HTML: com ou sem arquivos, com campos adicionais e assim por diante. -[FormData](https://xhr.spec.whatwg.org/#interface-formdata) objects can help with that. As you might have guessed, it's the object to represent HTML form data. +Objetos [FormData](https://xhr.spec.whatwg.org/#interface-formdata) podem ajudar com isso. Como você deve ter imaginado, é o objeto que representa os dados de um formulário HTML. -The constructor is: +O construtor é: ```js let formData = new FormData([form]); ``` -If HTML `form` element is provided, it automatically captures its fields. +Se o elemento HTML `form` for fornecido, ele captura automaticamente seus campos. -The special thing about `FormData` is that network methods, such as `fetch`, can accept a `FormData` object as a body. It's encoded and sent out with `Content-Type: multipart/form-data`. +O que torna o `FormData` especial é que métodos de rede, como `fetch`, podem aceitar um objeto `FormData` como corpo. Ele é codificado e enviado com `Content-Type: multipart/form-data`. -From the server point of view, that looks like a usual form submission. +Do ponto de vista do servidor, isso se parece com um envio de formulário comum. -## Sending a simple form +## Enviando um formulário simples -Let's send a simple form first. +Vamos enviar um formulário simples primeiro. -As you can see, that's almost one-liner: +Como você pode ver, isso é quase uma linha só: ```html run autorun
@@ -47,48 +47,48 @@ As you can see, that's almost one-liner: ``` -In this example, the server code is not presented, as it's beyond our scope. The server accepts the POST request and replies "User saved". +Neste exemplo, o código do servidor não é apresentado, já que está fora do nosso escopo. O servidor aceita a requisição POST e responde "Usuário salvo". -## FormData Methods +## Métodos de FormData -We can modify fields in `FormData` with methods: +Podemos modificar campos em `FormData` com métodos: -- `formData.append(name, value)` - add a form field with the given `name` and `value`, -- `formData.append(name, blob, fileName)` - add a field as if it were ``, the third argument `fileName` sets file name (not form field name), as it were a name of the file in user's filesystem, -- `formData.delete(name)` - remove the field with the given `name`, -- `formData.get(name)` - get the value of the field with the given `name`, -- `formData.has(name)` - if there exists a field with the given `name`, returns `true`, otherwise `false` +- `formData.append(name, value)` - adiciona um campo de formulário com o `name` e `value` dados, +- `formData.append(name, blob, fileName)` - adiciona um campo como se fosse ``, o terceiro argumento `fileName` define o nome do arquivo (não o nome do campo do formulário), como se fosse o nome do arquivo no sistema de arquivos do usuário, +- `formData.delete(name)` - remove o campo com o `name` dado, +- `formData.get(name)` - obtém o valor do campo com o `name` dado, +- `formData.has(name)` - se existir um campo com o `name` dado, retorna `true`, caso contrário `false` -A form is technically allowed to have many fields with the same `name`, so multiple calls to `append` add more same-named fields. +Um formulário é tecnicamente autorizado a ter vários campos com o mesmo `name`, então várias chamadas a `append` adicionam mais campos com o mesmo nome. -There's also method `set`, with the same syntax as `append`. The difference is that `.set` removes all fields with the given `name`, and then appends a new field. So it makes sure there's only one field with such `name`, the rest is just like `append`: +Também existe o método `set`, com a mesma sintaxe de `append`. A diferença é que `.set` remove todos os campos com o `name` dado, e então adiciona um novo campo. Então ele garante que existe só um campo com esse `name`, o resto é igual a `append`: - `formData.set(name, value)`, - `formData.set(name, blob, fileName)`. -Also we can iterate over formData fields using `for..of` loop: +Também podemos iterar sobre os campos de formData usando o laço `for..of`: ```js run let formData = new FormData(); formData.append('key1', 'value1'); formData.append('key2', 'value2'); -// List key/value pairs +// Lista os pares chave/valor for(let [name, value] of formData) { - alert(`${name} = ${value}`); // key1 = value1, then key2 = value2 + alert(`${name} = ${value}`); // key1 = value1, depois key2 = value2 } ``` -## Sending a form with a file +## Enviando um formulário com um arquivo -The form is always sent as `Content-Type: multipart/form-data`, this encoding allows to send files. So, `` fields are sent also, similar to a usual form submission. +O formulário é sempre enviado como `Content-Type: multipart/form-data`, essa codificação permite enviar arquivos. Então, campos `` também são enviados, de forma parecida com um envio de formulário comum. -Here's an example with such form: +Aqui está um exemplo com um formulário desse tipo: ```html run autorun - Picture: + Foto:
@@ -110,21 +110,21 @@ Here's an example with such form: ``` -## Sending a form with Blob data +## Enviando um formulário com dados Blob -As we've seen in the chapter , it's easy to send dynamically generated binary data e.g. an image, as `Blob`. We can supply it directly as `fetch` parameter `body`. +Como vimos no capítulo , é fácil enviar dados binários gerados dinamicamente, por exemplo, uma imagem, como `Blob`. Podemos fornecê-lo diretamente como o parâmetro `body` do `fetch`. -In practice though, it's often convenient to send an image not separately, but as a part of the form, with additional fields, such as "name" and other metadata. +Na prática, porém, geralmente é conveniente enviar uma imagem não separadamente, mas como parte do formulário, com campos adicionais, como "nome" e outros metadados. -Also, servers are usually more suited to accept multipart-encoded forms, rather than raw binary data. +Além disso, os servidores costumam estar mais preparados para aceitar formulários codificados como multipart, em vez de dados binários crus. -This example submits an image from ``, along with some other fields, as a form, using `FormData`: +Este exemplo envia uma imagem de um ``, junto com alguns outros campos, como um formulário, usando `FormData`: ```html run autorun height="90" - +