FormData #335

MaskeZen · 2020-08-06T01:12:33Z

No description provided.

CLAassistant · 2020-08-06T01:13:13Z

All committers have signed the CLA.

joaquinelio

Cambios sugeridos.

Estás mandando PR desde tu master.
No afecta envio y revision, pero:

Lo que se hace con GIT es mantener tu master intacto.
Cuando quieras hacer modificaciones, creas un "branch", lo modificas y haces el PR desde ahí.
🧉

joaquinelio · 2020-08-06T06:59:06Z

5-network/02-formdata/article.md


-From the server point of view, that looks like a usual form submission.
+Desde el punto de vista del servidor, se vé como una entrega normal.


Suggested change

Desde el punto de vista del servidor, se vé como una entrega normal.

Desde el punto de vista del servidor, se ve como una entrega normal.

joaquinelio · 2020-08-06T07:08:01Z

5-network/02-formdata/article.md

- `formData.has(name)` - if there exists a field with the given `name`, returns `true`, otherwise `false`
+- `formData.append(name, value)` - agrega un campo al formulario con el nombre `name` y el valor `value`,
+- `formData.append(name, blob, fileName)` - agrega un campo tal como si se tratara de un `<input type="file">`, el tercer argumento `fileName` establece el nombre del archivo (no el nombre del campo), tal como si se tratara del nombre del archivo en el sistema de archivos del usuario,
+- `formData.delete(name)` - remove el campo de nombre `name`,


Suggested change

- `formData.delete(name)` - remove el campo de nombre `name`,

- `formData.delete(name)` - elimina el campo de nombre `name`,

joaquinelio · 2020-08-06T07:11:26Z

5-network/02-formdata/article.md

+- `formData.append(name, blob, fileName)` - agrega un campo tal como si se tratara de un `<input type="file">`, el tercer argumento `fileName` establece el nombre del archivo (no el nombre del campo), tal como si se tratara del nombre del archivo en el sistema de archivos del usuario,
+- `formData.delete(name)` - remove el campo de nombre `name`,
+- `formData.get(name)` - obtiene el valor del campo con el nombre `name`,
+- `formData.has(name)` - en caso de que exista el campo con el nombre `name`, retorna `true`, de lo contrario `false`


Solemos traducir "devuelve"
"retorna" está bien, pero por consistencia con el resto de los art preferimos devuelve

Suggested change

- `formData.has(name)` - en caso de que exista el campo con el nombre `name`, retorna `true`, de lo contrario `false`

- `formData.has(name)` - en caso de que exista el campo con el nombre `name`, devuelve `true`, de lo contrario `false`

joaquinelio · 2020-08-06T07:19:29Z

5-network/02-formdata/article.md


 ```html run autorun
 <form id="formElem">
-  <input type="text" name="name" value="John">
-  <input type="text" name="surname" value="Smith">
+  <input type="text" name="nombre" value="John">


Solamente como nota:
No traducimos nombres de variables, htm clases o id,
(incluso debemos ser cuidadosos al traducir contenido entre comillas)
en HTML ' name="xxx" ', xxx es un nombre referenciable por codigo como "class="
Lo dejamos a criterio del traductor, pero recomendamos cuidado y probarlo la página con un server local.

En este caso no importa porque es un ej y no se referencia en todo el articulo,
lo comento para futuras traducciones

De acuerdo con @joaquinelio

joaquinelio · 2020-08-06T07:21:21Z

5-network/02-formdata/article.md


-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`:
+Por otra parte existe un método `set`, con la misma sintáxis que `append`. La diferencia está en que `.set` remueve todos los campos con el `name` que se le ha pasado, y luego agrega el nuevo campo. De este modo nos aseguramos de que sólo un campo éxiste con determinado `name`, el resto es tal cómo en `append`:


Suggested change

Por otra parte existe un método `set`, con la misma sintáxis que `append`. La diferencia está en que `.set` remueve todos los campos con el `name` que se le ha pasado, y luego agrega el nuevo campo. De este modo nos aseguramos de que sólo un campo éxiste con determinado `name`, el resto es tal cómo en `append`:

Por otra parte existe un método `set`, con la misma sintáxis que `append`. La diferencia está en que `.set` remueve todos los campos con el `name` que se le ha pasado, y luego agrega el nuevo campo. De este modo nos aseguramos de que sólo un campo éxiste con determinado `name`, el resto es tal como en `append`:

joaquinelio · 2020-08-06T07:45:23Z

5-network/02-formdata/article.md


-As we've seen in the chapter <info:fetch>, it's easy to send dynamically generated binary data e.g. an image, as `Blob`. We can supply it directly as `fetch` parameter `body`.
+Tal como pudimos ver en el capítulo <info:fetch>, es fácil enviar datos binarios generados dinámicamente ej. una imagen, como `Blob`. Podemos  simplemente proporcionarla a `fetch` como un parametro en el `body`.


La norma de las comas encerrando un bloque.
No sé por qué el ruso se enrosca tanto explicando, fetch('ruta imagen ', { method: 'POST' , body: blob }

Tal como pudimos ver en el capítulo info:fetch, es fácil enviar datos binarios generados dinámicamente, por ej. una imagen, como Blob. Podemos proporcionarlos directamente a un fetch con el parámetro body.

Cambié de opinión. Creo que es más facil de leer.

Suggested change

Tal como pudimos ver en el capítulo <info:fetch>, es fácil enviar datos binarios generados dinámicamente ej. una imagen, como `Blob`. Podemos simplemente proporcionarla a `fetch` como un parametro en el `body`.

Tal como pudimos ver en el capítulo <info:fetch>, es fácil enviar datos binarios generados dinámicamente (por ejemplo una imagen) como `Blob`. Podemos proporcionarlos directamente en un `fetch` con el parámetro `body`.

De acuerdo con @joaquinelio

joaquinelio · 2020-08-06T07:55:07Z

5-network/02-formdata/article.md


 ```js
 formData.append("image", imageBlob, "image.png");
 ```

-That's same as if there were `<input type="file" name="image">` in the form, and the visitor submitted a file named `"image.png"` (3rd argument) with the data `imageBlob` (2nd argument) from their filesystem.
+Se obtiene el mismo resultado tal como si se tuviese un campo `<input type="file" name="image">` en el formulario, y el usuario enviara un archivo con nombre `"image.png"` (3er argumento) con los datos `imageBlob` (2do argumento) desde su sistema de archivos.


Medio denso... ¿puedo? El original es mas corto, si te parece:
(Aunque tampoco me gusta el original, lo haría más esquemático menos verboso )

Suggested change

Se obtiene el mismo resultado tal como si se tuviese un campo `<input type="file" name="image">` en el formulario, y el usuario enviara un archivo con nombre `"image.png"` (3er argumento) con los datos `imageBlob` (2do argumento) desde su sistema de archivos.

Es lo mismo que si hubiera un campo `<input type="file" name="image">` en el formulario, y el usuario enviara un archivo con nombre `"image.png"` (3er argumento) con los datos `imageBlob` (2do argumento) desde su sistema de archivos.

No olvides el exceso de comas @joaquinelio, jajajaja

Debí quitar esa coma delante de la "y"... @maksumi
No recuerdo si la noté, pero queda demasiado largo.
De acuerdo, la coma NO marca pausas al lector sino estructura, habría que reescribirlo.
Ni se me ocurre hacerlo. Good enough.

joaquinelio · 2020-08-06T08:05:30Z

5-network/02-formdata/article.md


-We can either create `new FormData(form)` from an HTML form, or create a object without a form at all, and then append fields with methods:
+Podemos de este modo utilizar `new FormData(form)` tal que from es un elemento formulario HTML, o crear un objeto sin un formulario en absoluto, y agregar los campos con los siguientes métodos:


Es inconsistente en el original pero en ingles se disimula porque usa el new como parte de la explicación.

Suggested change

Podemos de este modo utilizar `new FormData(form)` tal que from es un elemento formulario HTML, o crear un objeto sin un formulario en absoluto, y agregar los campos con los siguientes métodos:

Podemos crear el objeto con `new FormData(form)` desde un formulario HTML , o crearlo sin un formulario en absoluto y agregar los campos con los siguientes métodos:

Suggested change

Podemos de este modo utilizar `new FormData(form)` tal que from es un elemento formulario HTML, o crear un objeto sin un formulario en absoluto, y agregar los campos con los siguientes métodos:

Podemos crear el objeto con `new FormData(form)` desde un formulario HTML, o crearlo sin un formulario en absoluto y agregar los campos con los siguientes métodos:

Lo que dijo @joaquinelio pero sin ese espacio

joaquinelio · 2020-08-06T08:06:06Z

5-network/02-formdata/article.md


-1. The `set` method removes fields with the same name, `append` doesn't. That's the only difference between them.
-2. To send a file, 3-argument syntax is needed, the last argument is a file name, that normally is taken from user filesystem for `<input type="file">`.
+1. El método `set` remueve campos con el mismo nombre, mientras que `append` no. Esta es la única diferencia entre estos dos metodos.


Suggested change

1. El método `set` remueve campos con el mismo nombre, mientras que `append` no. Esta es la única diferencia entre estos dos metodos.

1. El método `set` remueve campos con el mismo nombre, mientras que `append` no. Esta es la única diferencia entre estos dos métodos.

joaquinelio · 2020-08-06T08:07:46Z

5-network/02-formdata/article.md


-That's it!
+¡Esto es todo!


that's all folks!
jeje
infancia de... mediados del siglo pasado

Pa, que te dí trabajo che...

@MaskeZen
Casi todas las revisiones son así, y ahora vino @maksumi a corregir al corrector jaja el impaciente.
Siempre pasa, nuestro cerebro es más inteligente y perezoso que nosotros y es dificil autocorregirnos porque lee lo que cree que debe leer.

javascript-translate-bot · 2020-08-06T08:17:35Z

Please make the requested changes. After it, add a comment "/done".
Then I'll ask for a new review 👻

maksumi

Excelente traducción, algunas sugerencias a tomar en cuenta, otras como una alternativa solamente y unos cuantos typos a corregir

maksumi · 2020-08-06T22:34:15Z

5-network/02-formdata/article.md

@@ -1,31 +1,31 @@

 # FormData

-This chapter is about sending HTML forms: with or without files, with additional fields and so on.
+Éste capítulo se trata del envío de formularios HTML: con o sin archivos, con campos adicionales y cosas similares.


Suggested change

Éste capítulo se trata del envío de formularios HTML: con o sin archivos, con campos adicionales y cosas similares.

Éste capítulo trata sobre el envío de formularios HTML: con o sin archivos, con campos adicionales y cosas similares.

#Opcional

maksumi · 2020-08-06T22:41:15Z

5-network/02-formdata/article.md


-## Sending a simple form
+## Enviando un simple formulario


Suggested change

## Enviando un simple formulario

## Enviando un formulario simple

Sugiero el adjetivo calificativo después, tal como lo haces en la linea 21, ya que guarda más sentido en la definición del tipo de formulario y no parece centrarse en el valor de este mismo.

maksumi · 2020-08-06T22:46:17Z

5-network/02-formdata/article.md


 ```html run autorun
 <form id="formElem">
-  <input type="text" name="name" value="John">
-  <input type="text" name="surname" value="Smith">
+  <input type="text" name="nombre" value="John">


De acuerdo con @joaquinelio

maksumi · 2020-08-06T22:47:21Z

5-network/02-formdata/article.md

@@ -1,31 +1,31 @@

 # FormData

-This chapter is about sending HTML forms: with or without files, with additional fields and so on.
+Éste capítulo se trata del envío de formularios HTML: con o sin archivos, con campos adicionales y cosas similares.


Suggested change

Éste capítulo se trata del envío de formularios HTML: con o sin archivos, con campos adicionales y cosas similares.

Éste capítulo trata sobre el envío de formularios HTML: con o sin archivos, con campos adicionales y cosas similares.

Opcional

maksumi · 2020-08-06T22:49:05Z

5-network/02-formdata/article.md


-## Sending a simple form
+## Enviando un simple formulario


Suggested change

## Enviando un simple formulario

## Enviando un formulario simple

Sugiero el calificativo al final, tal como lo haces con la linea 21, para una mejor referencia al tipo de formulario y no el valor que tiene

maksumi · 2020-08-06T23:06:54Z

5-network/02-formdata/article.md

@@ -154,36 +154,36 @@ This example submits an image from `<canvas>`, along with some other fields, as
 </body>
 ```

-Please note how the image `Blob` is added:
+Note como la imagen `Blob` es agregada:


Suggested change

Note como la imagen `Blob` es agregada:

Nota como la imagen `Blob` es agregada:

Anteriormente empezaste usando lenguaje informal así que sería bueno conservar el estilo

maksumi · 2020-08-06T23:09:05Z

5-network/02-formdata/article.md


 ```js
 formData.append("image", imageBlob, "image.png");
 ```

-That's same as if there were `<input type="file" name="image">` in the form, and the visitor submitted a file named `"image.png"` (3rd argument) with the data `imageBlob` (2nd argument) from their filesystem.
+Se obtiene el mismo resultado tal como si se tuviese un campo `<input type="file" name="image">` en el formulario, y el usuario enviara un archivo con nombre `"image.png"` (3er argumento) con los datos `imageBlob` (2do argumento) desde su sistema de archivos.


Suggested change

Se obtiene el mismo resultado tal como si se tuviese un campo `<input type="file" name="image">` en el formulario, y el usuario enviara un archivo con nombre `"image.png"` (3er argumento) con los datos `imageBlob` (2do argumento) desde su sistema de archivos.

Es lo mismo que si hubiera un campo `<input type="file" name="image">` en el formulario y el usuario enviara un archivo con nombre `"image.png"` (3er argumento) con los datos `imageBlob` (2do argumento) desde su sistema de archivos.

maksumi · 2020-08-06T23:09:39Z

5-network/02-formdata/article.md


 ```js
 formData.append("image", imageBlob, "image.png");
 ```

-That's same as if there were `<input type="file" name="image">` in the form, and the visitor submitted a file named `"image.png"` (3rd argument) with the data `imageBlob` (2nd argument) from their filesystem.
+Se obtiene el mismo resultado tal como si se tuviese un campo `<input type="file" name="image">` en el formulario, y el usuario enviara un archivo con nombre `"image.png"` (3er argumento) con los datos `imageBlob` (2do argumento) desde su sistema de archivos.


No olvides el exceso de comas @joaquinelio, jajajaja

maksumi · 2020-08-06T23:10:21Z

5-network/02-formdata/article.md


-[FormData](https://xhr.spec.whatwg.org/#interface-formdata) objects are used to capture HTML form and submit it using `fetch` or another network method.
+[FormData](https://xhr.spec.whatwg.org/#interface-formdata) objetos utilizados para capturar un formulario HTML y enviarlo utilizando `fetch` u otro método de red.


Suggested change

[FormData](https://xhr.spec.whatwg.org/#interface-formdata) objetos utilizados para capturar un formulario HTML y enviarlo utilizando `fetch` u otro método de red.

Los objetos [FormData](https://xhr.spec.whatwg.org/#interface-formdata) son utilizados para capturar un formulario HTML y enviarlo utilizando `fetch` u otro método de red.

maksumi · 2020-08-06T23:13:08Z

5-network/02-formdata/article.md


-We can either create `new FormData(form)` from an HTML form, or create a object without a form at all, and then append fields with methods:
+Podemos de este modo utilizar `new FormData(form)` tal que from es un elemento formulario HTML, o crear un objeto sin un formulario en absoluto, y agregar los campos con los siguientes métodos:


Suggested change

Podemos de este modo utilizar `new FormData(form)` tal que from es un elemento formulario HTML, o crear un objeto sin un formulario en absoluto, y agregar los campos con los siguientes métodos:

Podemos crear el objeto con `new FormData(form)` desde un formulario HTML, o crearlo sin un formulario en absoluto y agregar los campos con los siguientes métodos:

Lo que dijo @joaquinelio pero sin ese espacio

MaskeZen · 2020-08-06T23:27:48Z

/done

maksumi

Falta corregir unos puntos señalados por Joaquin, los cuáles he argumentado o simplemente señalado con un like. Una vez corregidos, ¡approve!

maksumi · 2020-08-06T23:45:06Z

5-network/02-formdata/article.md


-The form is always sent as `Content-Type: multipart/form-data`, this encoding allows to send files. So, `<input type="file">` fields are sent also, similar to a usual form submission.
+El formulario siempre es enviado como `Content-Type: multipart/form-data`, Esta codificación permite enviar archivos. Por lo tanto campos, `<input type="file">` también son enviados, tal como sucede en un envío normal.


Considera esta...

maksumi · 2020-08-06T23:48:21Z

5-network/02-formdata/article.md


-Here's an example with such form:
+Aquí un ejemplo con un formulario de éste tipo:


La RAE recomienda dejar de usar la tilde en pronombres demostrativos como este... Así que, igual, tómalo e cuenta.
@MazkeZen

MaskeZen · 2020-08-07T00:38:47Z

Bien, se me habían pasado, creo que ahora sí está todo.

maksumi · 2020-08-07T01:00:45Z

That's all!
No olvides darle una checada a la licencia que Don Bot te obliga (es broma) arriba y darle una firmada si estás de acuerdo.

joaquinelio

👍

javascript-translate-bot · 2020-08-07T02:18:30Z

Thank you 💖 I updated the Progress Issue #17 🎉 🎉 🎉

translate FormData

951179b

javascript-translate-bot added the review needed label Aug 6, 2020

joaquinelio requested changes Aug 6, 2020

View reviewed changes

javascript-translate-bot added changes requested and removed review needed labels Aug 6, 2020

maksumi reviewed Aug 6, 2020

View reviewed changes

correcciones de @joaquinelio y @maksumi

b977656

javascript-translate-bot added review needed and removed changes requested labels Aug 6, 2020

maksumi reviewed Aug 6, 2020

View reviewed changes

correcciones pendientes de @joaquinelio y @maksumi

93f7b6f

maksumi approved these changes Aug 7, 2020

View reviewed changes

javascript-translate-bot added needs +1 and removed review needed labels Aug 7, 2020

joaquinelio approved these changes Aug 7, 2020

View reviewed changes

joaquinelio merged commit f6cd4d8 into javascript-tutorial:master Aug 7, 2020

iliakan mentioned this pull request Aug 7, 2020

Spanish Translation Progress #17

Open


		From the server point of view, that looks like a usual form submission.
		Desde el punto de vista del servidor, se vé como una entrega normal.

	- `formData.delete(name)` - remove el campo de nombre `name`,
	- `formData.delete(name)` - elimina el campo de nombre `name`,

	- `formData.has(name)` - en caso de que exista el campo con el nombre `name`, retorna `true`, de lo contrario `false`
	- `formData.has(name)` - en caso de que exista el campo con el nombre `name`, devuelve `true`, de lo contrario `false`


		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`:
		Por otra parte existe un método `set`, con la misma sintáxis que `append`. La diferencia está en que `.set` remueve todos los campos con el `name` que se le ha pasado, y luego agrega el nuevo campo. De este modo nos aseguramos de que sólo un campo éxiste con determinado `name`, el resto es tal cómo en `append`:


		As we've seen in the chapter <info:fetch>, it's easy to send dynamically generated binary data e.g. an image, as `Blob`. We can supply it directly as `fetch` parameter `body`.
		Tal como pudimos ver en el capítulo <info:fetch>, es fácil enviar datos binarios generados dinámicamente ej. una imagen, como `Blob`. Podemos simplemente proporcionarla a `fetch` como un parametro en el `body`.

	Se obtiene el mismo resultado tal como si se tuviese un campo `<input type="file" name="image">` en el formulario, y el usuario enviara un archivo con nombre `"image.png"` (3er argumento) con los datos `imageBlob` (2do argumento) desde su sistema de archivos.
	Es lo mismo que si hubiera un campo `<input type="file" name="image">` en el formulario, y el usuario enviara un archivo con nombre `"image.png"` (3er argumento) con los datos `imageBlob` (2do argumento) desde su sistema de archivos.


		We can either create `new FormData(form)` from an HTML form, or create a object without a form at all, and then append fields with methods:
		Podemos de este modo utilizar `new FormData(form)` tal que from es un elemento formulario HTML, o crear un objeto sin un formulario en absoluto, y agregar los campos con los siguientes métodos:

	Podemos de este modo utilizar `new FormData(form)` tal que from es un elemento formulario HTML, o crear un objeto sin un formulario en absoluto, y agregar los campos con los siguientes métodos:
	Podemos crear el objeto con `new FormData(form)` desde un formulario HTML , o crearlo sin un formulario en absoluto y agregar los campos con los siguientes métodos:

	1. El método `set` remueve campos con el mismo nombre, mientras que `append` no. Esta es la única diferencia entre estos dos metodos.
	1. El método `set` remueve campos con el mismo nombre, mientras que `append` no. Esta es la única diferencia entre estos dos métodos.

	Éste capítulo se trata del envío de formularios HTML: con o sin archivos, con campos adicionales y cosas similares.
	Éste capítulo trata sobre el envío de formularios HTML: con o sin archivos, con campos adicionales y cosas similares.

	## Enviando un simple formulario
	## Enviando un formulario simple

	Note como la imagen `Blob` es agregada:
	Nota como la imagen `Blob` es agregada:


		[FormData](https://xhr.spec.whatwg.org/#interface-formdata) objects are used to capture HTML form and submit it using `fetch` or another network method.
		[FormData](https://xhr.spec.whatwg.org/#interface-formdata) objetos utilizados para capturar un formulario HTML y enviarlo utilizando `fetch` u otro método de red.

	[FormData](https://xhr.spec.whatwg.org/#interface-formdata) objetos utilizados para capturar un formulario HTML y enviarlo utilizando `fetch` u otro método de red.
	Los objetos [FormData](https://xhr.spec.whatwg.org/#interface-formdata) son utilizados para capturar un formulario HTML y enviarlo utilizando `fetch` u otro método de red.


		The form is always sent as `Content-Type: multipart/form-data`, this encoding allows to send files. So, `<input type="file">` fields are sent also, similar to a usual form submission.
		El formulario siempre es enviado como `Content-Type: multipart/form-data`, Esta codificación permite enviar archivos. Por lo tanto campos, `<input type="file">` también son enviados, tal como sucede en un envío normal.


		Here's an example with such form:
		Aquí un ejemplo con un formulario de éste tipo:

FormData #335

FormData #335

Conversation

MaskeZen commented Aug 6, 2020

CLAassistant commented Aug 6, 2020 • edited Loading

joaquinelio left a comment • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

javascript-translate-bot commented Aug 6, 2020

maksumi left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

MaskeZen commented Aug 6, 2020

maksumi left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

MaskeZen commented Aug 7, 2020

maksumi commented Aug 7, 2020

joaquinelio left a comment

Choose a reason for hiding this comment

javascript-translate-bot commented Aug 7, 2020

CLAassistant commented Aug 6, 2020 •

edited

Loading

joaquinelio left a comment •

edited

Loading