From 6d266887eb3c65eaff6a990d492b9d5b7d191506 Mon Sep 17 00:00:00 2001 From: Dago <34744883+d4g0@users.noreply.github.com> Date: Sun, 26 Jul 2020 01:31:33 -0400 Subject: [PATCH 01/23] Update article.md Spanish translation --- 4-binary/04-file/article.md | 120 +++++++++++++++++++----------------- 1 file changed, 62 insertions(+), 58 deletions(-) diff --git a/4-binary/04-file/article.md b/4-binary/04-file/article.md index 20878b650..749b66c85 100644 --- a/4-binary/04-file/article.md +++ b/4-binary/04-file/article.md @@ -1,27 +1,27 @@ -# File and FileReader +# Archivo y Lector de Archivos (File and FileReader en inglés) -A [File](https://www.w3.org/TR/FileAPI/#dfn-file) object inherits from `Blob` and is extended with filesystem-related capabilities. +Un [Archivo](https://www.w3.org/TR/FileAPI/#dfn-file) hereda de `Blob` y es extendido con capacidades relacionadas con el sistema de archivos. -There are two ways to obtain it. +Hay dos maneras de obtenerlo -First, there's a constructor, similar to `Blob`: +Primero, hay un constructor, similar al de `Blob`: ```js new File(fileParts, fileName, [options]) ``` -- **`fileParts`** -- is an array of Blob/BufferSource/String values. -- **`fileName`** -- file name string. -- **`options`** -- optional object: - - **`lastModified`** -- the timestamp (integer date) of last modification. +- **`fileParts`** -- es un arary de valores Blob/BufferSource/String. +- **`fileName`** -- la cadena del nombre del archivo. +- **`options`** -- objeto opcional: + - **`lastModified`** -- la timestamp (fecha en enteros) de la última modificación. -Second, more often we get a file from `` or drag'n'drop or other browser interfaces. In that case, the file gets this information from OS. +Segundo, a menudo obetenemos un archivo mediante un `` o un drag'n'drop, u otra interfaz del navegador. En este caso el archivo obtiene la información del Sistema Operativos. -As `File` inherits from `Blob`, `File` objects have the same properties, plus: -- `name` -- the file name, -- `lastModified` -- the timestamp of last modification. +Como `File` (Archivo) hereda de `Blob`, objetos de tipo `File` tienen las mismas propiedades, mas: +- `name` -- el nombre del archivo, +- `lastModified` -- la timestamp de la última modificación. -That's how we can get a `File` object from ``: +Así es como obtenemos un objeto `File` desde `` ```html run @@ -37,49 +37,50 @@ function showFile(input) { ``` ```smart -The input may select multiple files, so `input.files` is an array-like object with them. Here we have only one file, so we just take `input.files[0]`. +Como un input puede seleccionar varios archivos,`input.files` es objeto parecido a un array, que los contiene. En este caso tenemos un solo archivo, por eso solo nesecitamos tomar `input.files[0]`. ``` -## FileReader +## Lector de Archivos -[FileReader](https://www.w3.org/TR/FileAPI/#dfn-filereader) is an object with the sole purpose of reading data from `Blob` (and hence `File` too) objects. +[Lector de Archivos](https://www.w3.org/TR/FileAPI/#dfn-filereader) es un objeto con el único porpósito de leer datos desde objetos de tipo `Blob` (y entonces `File` también) -It delivers the data using events, as reading from disk may take time. +El entrega los datos usando evetos, debido a que leerlos desde el disco puede tomar tiempo -The constructor: +El constructor: ```js -let reader = new FileReader(); // no arguments +let reader = new FileReader(); // sin argumentos ``` -The main methods: +Los métodos principales: -- **`readAsArrayBuffer(blob)`** -- read the data in binary format `ArrayBuffer`. -- **`readAsText(blob, [encoding])`** -- read the data as a text string with the given encoding (`utf-8` by default). -- **`readAsDataURL(blob)`** -- read the binary data and encode it as base64 data url. -- **`abort()`** -- cancel the operation. +- **`readAsArrayBuffer(blob)`** -- lee los datos en el formato binario `ArrayBuffer`. +- **`readAsText(blob, [encoding])`** -- lee los datos como una cadena de texto con el formato especificado (`utf-8` por defecto). +- **`readAsDataURL(blob)`** -- lee los datos binarios y los codifica como [Datos URIs](https://developer.mozilla.org/es/docs/Web/HTTP/Basics_of_HTTP/Datos_URIs) -The choice of `read*` method depends on which format we prefer, how we're going to use the data. +- **`abort()`** -- cancela la operación. -- `readAsArrayBuffer` -- for binary files, to do low-level binary operations. For high-level operations, like slicing, `File` inherits from `Blob`, so we can call them directly, without reading. -- `readAsText` -- for text files, when we'd like to get a string. -- `readAsDataURL` -- when we'd like to use this data in `src` for `img` or another tag. There's an alternative to reading a file for that, as discussed in chapter : `URL.createObjectURL(file)`. +La opción de `read*` metodo depende de que formato preferimos, como vamos a usar los datos. -As the reading proceeds, there are events: -- `loadstart` -- loading started. -- `progress` -- occurs during reading. -- `load` -- no errors, reading complete. -- `abort` -- `abort()` called. -- `error` -- error has occurred. -- `loadend` -- reading finished with either success or failure. +- `readAsArrayBuffer` -- para archivos binarios, para hacer operaciones binarias de bajo nivel. Para operaciones de alto nivel, como slicing, `File` hereda de `Blob`, entonces podemos llamarlas directamente, sin tener que leer. +- `readAsText` -- para archivos de texto, cuando nesecitamos obtener una cadena. +- `readAsDataURL` -- cuando nesecitamos usar estos datos valores de `src` en `img` o otras etiquetas html. Hay otra alternativa para leer archivos con este último fin, como es discutido en el capítulo : `URL.createObjectURL(file)`. -When the reading is finished, we can access the result as: -- `reader.result` is the result (if successful) -- `reader.error` is the error (if failed). +En la medida que la lectura procede, suceden varios eventos: +- `loadstart` -- lectura iniciada. +- `progress` -- ocurre mientras se lee. +- `load` -- lectura completada, sin errores. +- `abort` -- `abort()` ha sido llamado. +- `error` -- ha ocurrido un error . +- `loadend` -- lectura termindada tanto exitosa como fallidamente. -The most widely used events are for sure `load` and `error`. +Cuando la lectura finaliza, podemos acceder al resultado como: +- `reader.result` el resultado (si fue exitoso) +- `reader.error` el error (si hubo fallo). -Here's an example of reading a file: +Los mas ampliamente usados son seguramente `load` y `error`. + +Un ejemplo de como leer un archivo: ```html run @@ -104,35 +105,38 @@ function readFile(input) { ``` -```smart header="`FileReader` for blobs" -As mentioned in the chapter , `FileReader` can read not just files, but any blobs. +```smart header="`FileReader` para blobs" +Como mencionamos en el capítulo , `FileReader` no solo lee archivos, sino también cualquier blob. -We can use it to convert a blob to another format: -- `readAsArrayBuffer(blob)` -- to `ArrayBuffer`, -- `readAsText(blob, [encoding])` -- to string (an alternative to `TextDecoder`), -- `readAsDataURL(blob)` -- to base64 data url. +Podemos usarlo para convertir un blob a otro formato: +- `readAsArrayBuffer(blob)` -- a `ArrayBuffer`, +- `readAsText(blob, [encoding])` -- a cadena (una alternativa al `TextDecoder`), +- `readAsDataURL(blob)` -- a Dato Uri. ``` -```smart header="`FileReaderSync` is available inside Web Workers" -For Web Workers, there also exists a synchronous variant of `FileReader`, called [FileReaderSync](https://www.w3.org/TR/FileAPI/#FileReaderSync). +```smart header="`FileReaderSync` está disponible dentro de Web Workers" +Para Web Workers, también existe una variante síncrona de `FileReader`, llamada [FileReaderSync](https://www.w3.org/TR/FileAPI/#FileReaderSync). + +Sus metodos`read*` no generan eventos, sino que devuelven un resultado, como las funciones regulares. -Its reading methods `read*` do not generate events, but rather return a result, as regular functions do. +Esto es solo dentro de un Web Worker, debido a que demoras en llamadas síncronas mientras se lee el archivo en Web Worker no son tan importantes. No afectan la página. -That's only inside a Web Worker though, because delays in synchronous calls, that are possible while reading from files, in Web Workers are less important. They do not affect the page. ``` -## Summary +## Sumario + +Los objetos `File` heredan de `Blob`. -`File` objects inherit from `Blob`. +En adición a los métodos y porpiedades de `Blob`, los objetos `File` también tienen `name` and `lastModified` mas la habilidad interna de leer del sistema de archivos. Usualmente obtenemos los objetos `File` mediante la entrada por el usuario con `` o un evento Drag'n'Drop (`ondragend`). -In addition to `Blob` methods and properties, `File` objects also have `name` and `lastModified` properties, plus the internal ability to read from filesystem. We usually get `File` objects from user input, like `` or Drag'n'Drop events (`ondragend`). -`FileReader` objects can read from a file or a blob, in one of three formats: -- String (`readAsText`). +Objetos `FileReader` pueden leer desde un archivo o un blob, en uno de estos tres formatos: +- String (`readAsText`) . - `ArrayBuffer` (`readAsArrayBuffer`). -- Data url, base-64 encoded (`readAsDataURL`). +- Datos Uri (`readAsDataURL`). -In many cases though, we don't have to read the file contents. Just as we did with blobs, we can create a short url with `URL.createObjectURL(file)` and assign it to `` or ``. This way the file can be downloaded or shown up as an image, as a part of canvas etc. +En muchos casos, no nesecitamos leer el contenido de un archivo. Como hicimos con blobs, podemos crear +un url corto con `URL.createObjectURL(file)` y asignárselo a un `` o ``. De esta manera el archivo puede ser descargado o ser mostrado como una imagen, o como parte de un canvas etc. -And if we're going to send a `File` over a network, that's also easy: network API like `XMLHttpRequest` or `fetch` natively accepts `File` objects. +Y si vamos a mandar un `File` por la red, es también fácil: APIs como `XMLHttpRequest` o `fetch` acceptan nativamente objetos `File` From e740ed2965a7a24b27bdaebe887e2b2533e42ed3 Mon Sep 17 00:00:00 2001 From: Dago <34744883+d4g0@users.noreply.github.com> Date: Sun, 26 Jul 2020 02:08:46 -0400 Subject: [PATCH 02/23] Update article.md correcciones --- 4-binary/04-file/article.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/4-binary/04-file/article.md b/4-binary/04-file/article.md index 749b66c85..4c3d57bf2 100644 --- a/4-binary/04-file/article.md +++ b/4-binary/04-file/article.md @@ -10,18 +10,18 @@ Primero, hay un constructor, similar al de `Blob`: new File(fileParts, fileName, [options]) ``` -- **`fileParts`** -- es un arary de valores Blob/BufferSource/String. +- **`fileParts`** -- es un array de valores Blob/BufferSource/String. - **`fileName`** -- la cadena del nombre del archivo. - **`options`** -- objeto opcional: - **`lastModified`** -- la timestamp (fecha en enteros) de la última modificación. -Segundo, a menudo obetenemos un archivo mediante un `` o un drag'n'drop, u otra interfaz del navegador. En este caso el archivo obtiene la información del Sistema Operativos. +Segundo, a menudo obetenemos un archivo mediante un `` o un drag'n'drop, u otra interfaz del navegador. En este caso el archivo obtiene la información del Sistema Operativo. Como `File` (Archivo) hereda de `Blob`, objetos de tipo `File` tienen las mismas propiedades, mas: - `name` -- el nombre del archivo, - `lastModified` -- la timestamp de la última modificación. -Así es como obtenemos un objeto `File` desde `` +Así es como obtenemos un objeto `File` desde `` : ```html run @@ -42,9 +42,9 @@ Como un input puede seleccionar varios archivos,`input.files` es objeto parecido ## Lector de Archivos -[Lector de Archivos](https://www.w3.org/TR/FileAPI/#dfn-filereader) es un objeto con el único porpósito de leer datos desde objetos de tipo `Blob` (y entonces `File` también) +[Lector de Archivos](https://www.w3.org/TR/FileAPI/#dfn-filereader) es un objeto con el único porpósito de leer datos desde objetos de tipo `Blob` (y entonces `File` también). -El entrega los datos usando evetos, debido a que leerlos desde el disco puede tomar tiempo +El entrega los datos usando evetos, debido a que leerlos desde el disco puede tomar tiempo. El constructor: @@ -139,4 +139,4 @@ Objetos `FileReader` pueden leer desde un archivo o un blob, en uno de estos tre En muchos casos, no nesecitamos leer el contenido de un archivo. Como hicimos con blobs, podemos crear un url corto con `URL.createObjectURL(file)` y asignárselo a un `` o ``. De esta manera el archivo puede ser descargado o ser mostrado como una imagen, o como parte de un canvas etc. -Y si vamos a mandar un `File` por la red, es también fácil: APIs como `XMLHttpRequest` o `fetch` acceptan nativamente objetos `File` +Y si vamos a mandar un `File` por la red, es también fácil: APIs como `XMLHttpRequest` o `fetch` acceptan nativamente objetos `File` . From 77db0a0aab96e23c891fbc36bae17769d30629fc Mon Sep 17 00:00:00 2001 From: Dago <34744883+d4g0@users.noreply.github.com> Date: Wed, 29 Jul 2020 10:17:05 -0400 Subject: [PATCH 03/23] File and FileReader sugested changes applied --- 4-binary/04-file/article.md | 43 +++++++++++++++++++------------------ 1 file changed, 22 insertions(+), 21 deletions(-) diff --git a/4-binary/04-file/article.md b/4-binary/04-file/article.md index 4c3d57bf2..af1209d34 100644 --- a/4-binary/04-file/article.md +++ b/4-binary/04-file/article.md @@ -1,25 +1,25 @@ -# Archivo y Lector de Archivos (File and FileReader en inglés) +# File y FileReader -Un [Archivo](https://www.w3.org/TR/FileAPI/#dfn-file) hereda de `Blob` y es extendido con capacidades relacionadas con el sistema de archivos. +Un [File](https://www.w3.org/TR/FileAPI/#dfn-file) hereda de `Blob` y extiende las capacidades relacionadas con el sistema de archivos. Hay dos maneras de obtenerlo Primero, hay un constructor, similar al de `Blob`: ```js -new File(fileParts, fileName, [options]) +new File(partesDelArchivo, nombreDelArchivo, [opciones]) ``` - **`fileParts`** -- es un array de valores Blob/BufferSource/String. -- **`fileName`** -- la cadena del nombre del archivo. +- **`fileName`** -- el nombre del archivo.. - **`options`** -- objeto opcional: - - **`lastModified`** -- la timestamp (fecha en enteros) de la última modificación. + - **`lastModified`** -- la marca de tiempo (fecha en mili-segundos) de la última modificación. Segundo, a menudo obetenemos un archivo mediante un `` o un drag'n'drop, u otra interfaz del navegador. En este caso el archivo obtiene la información del Sistema Operativo. Como `File` (Archivo) hereda de `Blob`, objetos de tipo `File` tienen las mismas propiedades, mas: - `name` -- el nombre del archivo, -- `lastModified` -- la timestamp de la última modificación. +- `lastModified` -- la marca de tiempo de la última modificación. Así es como obtenemos un objeto `File` desde `` : @@ -37,7 +37,7 @@ function showFile(input) { ``` ```smart -Como un input puede seleccionar varios archivos,`input.files` es objeto parecido a un array, que los contiene. En este caso tenemos un solo archivo, por eso solo nesecitamos tomar `input.files[0]`. +El input puede seleccionar varios archivos, por lo que `input.files` es una lista de dichos archivos . En este caso tenemos un solo archivo por lo que solo es necesario usar `input.files[0]`. ``` ## Lector de Archivos @@ -54,25 +54,25 @@ let reader = new FileReader(); // sin argumentos Los métodos principales: -- **`readAsArrayBuffer(blob)`** -- lee los datos en el formato binario `ArrayBuffer`. -- **`readAsText(blob, [encoding])`** -- lee los datos como una cadena de texto con el formato especificado (`utf-8` por defecto). -- **`readAsDataURL(blob)`** -- lee los datos binarios y los codifica como [Datos URIs](https://developer.mozilla.org/es/docs/Web/HTTP/Basics_of_HTTP/Datos_URIs) +- **`readAsArrayBuffer(blob)`** -- lee los datos en formato binario `ArrayBuffer`. +- **`readAsText(blob, [codificación])`** -- lee los datos como una cadena de texto con la codificación dada (por defecto es `utf-8`). +- **`readAsDataURL(blob)`** -- lee los datos binarios y los codifica como [Datos URIs] en base 64 (https://developer.mozilla.org/es/docs/Web/HTTP/Basics_of_HTTP/Datos_URIs). - **`abort()`** -- cancela la operación. -La opción de `read*` metodo depende de que formato preferimos, como vamos a usar los datos. +La opción de `read*` método depende de que formato preferimos y como vamos a usar los datos. -- `readAsArrayBuffer` -- para archivos binarios, para hacer operaciones binarias de bajo nivel. Para operaciones de alto nivel, como slicing, `File` hereda de `Blob`, entonces podemos llamarlas directamente, sin tener que leer. +- `readAsArrayBuffer` -- para archivos binarios, en donde se hacen operaciones binarias de bajo nivel. Para operaciones de alto nivel, como slicing, `File` hereda de `Blob` por lo que podemos llamarlas directamente sin tener que leer. - `readAsText` -- para archivos de texto, cuando nesecitamos obtener una cadena. -- `readAsDataURL` -- cuando nesecitamos usar estos datos valores de `src` en `img` o otras etiquetas html. Hay otra alternativa para leer archivos con este último fin, como es discutido en el capítulo : `URL.createObjectURL(file)`. +- `readAsDataURL` -- cuando necesitamos usar estos datos como valores de `src` en `img` u otras etiquetas html. Hay otra alternativa para leer archivos para eso como discutimos en el capítulo : `URL.createObjectURL(file)`. En la medida que la lectura procede, suceden varios eventos: -- `loadstart` -- lectura iniciada. +- `loadstart` -- la carga comenzó. - `progress` -- ocurre mientras se lee. - `load` -- lectura completada, sin errores. - `abort` -- `abort()` ha sido llamado. - `error` -- ha ocurrido un error . -- `loadend` -- lectura termindada tanto exitosa como fallidamente. +- `loadend` -- la lectura finalizó exitosa o no . Cuando la lectura finaliza, podemos acceder al resultado como: - `reader.result` el resultado (si fue exitoso) @@ -106,7 +106,7 @@ function readFile(input) { ``` ```smart header="`FileReader` para blobs" -Como mencionamos en el capítulo , `FileReader` no solo lee archivos, sino también cualquier blob. +Como mencionamos en el capítulo , `FileReader` no solo lee archivos sino también cualquier blob. Podemos usarlo para convertir un blob a otro formato: - `readAsArrayBuffer(blob)` -- a `ArrayBuffer`, @@ -124,19 +124,20 @@ Esto es solo dentro de un Web Worker, debido a que demoras en llamadas síncro ``` -## Sumario +## Resumen Los objetos `File` heredan de `Blob`. En adición a los métodos y porpiedades de `Blob`, los objetos `File` también tienen `name` and `lastModified` mas la habilidad interna de leer del sistema de archivos. Usualmente obtenemos los objetos `File` mediante la entrada por el usuario con `` o un evento Drag'n'Drop (`ondragend`). -Objetos `FileReader` pueden leer desde un archivo o un blob, en uno de estos tres formatos: +Los objetos `FileReader` pueden leer desde un archivo o un blob en uno de estos tres formatos: - String (`readAsText`) . - `ArrayBuffer` (`readAsArrayBuffer`). -- Datos Uri (`readAsDataURL`). +- Datos URI codificado en base 64 (`readAsDataURL`). + +En muchos casos no necesitamos leer el contenido de un archivo como hicimos con blobs, podemos crear un enlace corto con `URL.createObjectURL(file)` y asignárselo a un `` o ``. De esta manera el archivo puede ser descargado o ser mostrado como una imagen o como parte de un canvas, etc. + -En muchos casos, no nesecitamos leer el contenido de un archivo. Como hicimos con blobs, podemos crear -un url corto con `URL.createObjectURL(file)` y asignárselo a un `` o ``. De esta manera el archivo puede ser descargado o ser mostrado como una imagen, o como parte de un canvas etc. Y si vamos a mandar un `File` por la red, es también fácil: APIs como `XMLHttpRequest` o `fetch` acceptan nativamente objetos `File` . From e5dc34e98c91ff16194477aa2728731f04218a17 Mon Sep 17 00:00:00 2001 From: Valentina VP <34555644+vplentinax@users.noreply.github.com> Date: Fri, 31 Jul 2020 12:47:21 -0400 Subject: [PATCH 04/23] Update 4-binary/04-file/article.md Co-authored-by: Danilo Britto --- 4-binary/04-file/article.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/4-binary/04-file/article.md b/4-binary/04-file/article.md index af1209d34..8f43424b0 100644 --- a/4-binary/04-file/article.md +++ b/4-binary/04-file/article.md @@ -15,7 +15,7 @@ new File(partesDelArchivo, nombreDelArchivo, [opciones]) - **`options`** -- objeto opcional: - **`lastModified`** -- la marca de tiempo (fecha en mili-segundos) de la última modificación. -Segundo, a menudo obetenemos un archivo mediante un `` o un drag'n'drop, u otra interfaz del navegador. En este caso el archivo obtiene la información del Sistema Operativo. +Segundo, a menudo obtenemos un archivo mediante un `` o arrastrar y soltar u otras interfaces del navegador. En este caso el archivo obtiene la información del Sistema Operativo. Como `File` (Archivo) hereda de `Blob`, objetos de tipo `File` tienen las mismas propiedades, mas: - `name` -- el nombre del archivo, From 143cfe37a6fae85ce319a8548e306cbd1ae329a7 Mon Sep 17 00:00:00 2001 From: Valentina VP <34555644+vplentinax@users.noreply.github.com> Date: Fri, 31 Jul 2020 17:39:50 -0400 Subject: [PATCH 05/23] Update 4-binary/04-file/article.md Co-authored-by: Danilo Britto --- 4-binary/04-file/article.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/4-binary/04-file/article.md b/4-binary/04-file/article.md index 8f43424b0..65f0b226c 100644 --- a/4-binary/04-file/article.md +++ b/4-binary/04-file/article.md @@ -44,7 +44,7 @@ El input puede seleccionar varios archivos, por lo que `input.files` es una list [Lector de Archivos](https://www.w3.org/TR/FileAPI/#dfn-filereader) es un objeto con el único porpósito de leer datos desde objetos de tipo `Blob` (y entonces `File` también). -El entrega los datos usando evetos, debido a que leerlos desde el disco puede tomar tiempo. +El entrega los datos usando eventos debido a que leerlos desde el disco puede tomar un tiempo. El constructor: From ace97ffe9d9952056ad51c8a6c7e498e70756922 Mon Sep 17 00:00:00 2001 From: Dago <34744883+d4g0@users.noreply.github.com> Date: Fri, 31 Jul 2020 22:43:44 -0400 Subject: [PATCH 06/23] Update 4-binary/04-file/article.md Co-authored-by: Valentina VP <34555644+vplentinax@users.noreply.github.com> --- 4-binary/04-file/article.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/4-binary/04-file/article.md b/4-binary/04-file/article.md index 65f0b226c..e7b7c78ae 100644 --- a/4-binary/04-file/article.md +++ b/4-binary/04-file/article.md @@ -10,7 +10,7 @@ Primero, hay un constructor, similar al de `Blob`: new File(partesDelArchivo, nombreDelArchivo, [opciones]) ``` -- **`fileParts`** -- es un array de valores Blob/BufferSource/String. +- **`fileParts`** -- es un array con valores de tipo Blob/BufferSource/String. - **`fileName`** -- el nombre del archivo.. - **`options`** -- objeto opcional: - **`lastModified`** -- la marca de tiempo (fecha en mili-segundos) de la última modificación. From 395da052581ab390b208a115bdb1a54468a5041d Mon Sep 17 00:00:00 2001 From: Dago <34744883+d4g0@users.noreply.github.com> Date: Fri, 31 Jul 2020 22:45:42 -0400 Subject: [PATCH 07/23] Update 4-binary/04-file/article.md /done Co-authored-by: Valentina VP <34555644+vplentinax@users.noreply.github.com> --- 4-binary/04-file/article.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/4-binary/04-file/article.md b/4-binary/04-file/article.md index e7b7c78ae..6caaaa715 100644 --- a/4-binary/04-file/article.md +++ b/4-binary/04-file/article.md @@ -7,7 +7,7 @@ Hay dos maneras de obtenerlo Primero, hay un constructor, similar al de `Blob`: ```js -new File(partesDelArchivo, nombreDelArchivo, [opciones]) +new File(fileParts, fileName, [options]) ``` - **`fileParts`** -- es un array con valores de tipo Blob/BufferSource/String. From 2b1c0a37162b4bc954b6fd34e1521e206779b382 Mon Sep 17 00:00:00 2001 From: Dago <34744883+d4g0@users.noreply.github.com> Date: Fri, 31 Jul 2020 22:46:41 -0400 Subject: [PATCH 08/23] Update 4-binary/04-file/article.md /done Co-authored-by: Valentina VP <34555644+vplentinax@users.noreply.github.com> --- 4-binary/04-file/article.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/4-binary/04-file/article.md b/4-binary/04-file/article.md index 6caaaa715..6b0336dae 100644 --- a/4-binary/04-file/article.md +++ b/4-binary/04-file/article.md @@ -13,7 +13,7 @@ new File(fileParts, fileName, [options]) - **`fileParts`** -- es un array con valores de tipo Blob/BufferSource/String. - **`fileName`** -- el nombre del archivo.. - **`options`** -- objeto opcional: - - **`lastModified`** -- la marca de tiempo (fecha en mili-segundos) de la última modificación. + - **`lastModified`** -- la marca de tiempo (fecha en mili-segundos, de tipo entero) de la última modificación. Segundo, a menudo obtenemos un archivo mediante un `` o arrastrar y soltar u otras interfaces del navegador. En este caso el archivo obtiene la información del Sistema Operativo. From 0a9e2c30972c71a70a68d1651f918989673566f7 Mon Sep 17 00:00:00 2001 From: Dago <34744883+d4g0@users.noreply.github.com> Date: Fri, 31 Jul 2020 22:51:38 -0400 Subject: [PATCH 09/23] Update 4-binary/04-file/article.md /done Co-authored-by: Valentina VP <34555644+vplentinax@users.noreply.github.com> --- 4-binary/04-file/article.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/4-binary/04-file/article.md b/4-binary/04-file/article.md index 6b0336dae..34c29b752 100644 --- a/4-binary/04-file/article.md +++ b/4-binary/04-file/article.md @@ -37,7 +37,7 @@ function showFile(input) { ``` ```smart -El input puede seleccionar varios archivos, por lo que `input.files` es una lista de dichos archivos . En este caso tenemos un solo archivo por lo que solo es necesario usar `input.files[0]`. +El input puede seleccionar varios archivos, por lo que `input.files` es un array de dichos archivos . En este caso tenemos un solo archivo por lo que solo es necesario usar `input.files[0]`. ``` ## Lector de Archivos From f695ec68f14cdc980137db2ceda1e0a48f81cbc7 Mon Sep 17 00:00:00 2001 From: Dago <34744883+d4g0@users.noreply.github.com> Date: Fri, 31 Jul 2020 22:52:44 -0400 Subject: [PATCH 10/23] Update 4-binary/04-file/article.md /done Co-authored-by: Valentina VP <34555644+vplentinax@users.noreply.github.com> --- 4-binary/04-file/article.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/4-binary/04-file/article.md b/4-binary/04-file/article.md index 34c29b752..497ecb513 100644 --- a/4-binary/04-file/article.md +++ b/4-binary/04-file/article.md @@ -140,4 +140,4 @@ En muchos casos no necesitamos leer el contenido de un archivo como hicimos con -Y si vamos a mandar un `File` por la red, es también fácil: APIs como `XMLHttpRequest` o `fetch` acceptan nativamente objetos `File` . +Y si vamos a mandar un `File` por la red, es fácil utilizando APIs como `XMLHttpRequest` o `fetch` que aceptan nativamente objetos `File` . From a182dfc48f26679f5a2374a3fc3c60f58187ca09 Mon Sep 17 00:00:00 2001 From: Dago <34744883+d4g0@users.noreply.github.com> Date: Fri, 31 Jul 2020 22:53:04 -0400 Subject: [PATCH 11/23] Update 4-binary/04-file/article.md /done Co-authored-by: Valentina VP <34555644+vplentinax@users.noreply.github.com> --- 4-binary/04-file/article.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/4-binary/04-file/article.md b/4-binary/04-file/article.md index 497ecb513..0e115b8ba 100644 --- a/4-binary/04-file/article.md +++ b/4-binary/04-file/article.md @@ -40,7 +40,7 @@ function showFile(input) { El input puede seleccionar varios archivos, por lo que `input.files` es un array de dichos archivos . En este caso tenemos un solo archivo por lo que solo es necesario usar `input.files[0]`. ``` -## Lector de Archivos +## FileReader [Lector de Archivos](https://www.w3.org/TR/FileAPI/#dfn-filereader) es un objeto con el único porpósito de leer datos desde objetos de tipo `Blob` (y entonces `File` también). From e9d25b9db70d946cda541c0b149faeb777b41822 Mon Sep 17 00:00:00 2001 From: Dago <34744883+d4g0@users.noreply.github.com> Date: Fri, 31 Jul 2020 22:53:30 -0400 Subject: [PATCH 12/23] Update 4-binary/04-file/article.md /done Co-authored-by: Valentina VP <34555644+vplentinax@users.noreply.github.com> --- 4-binary/04-file/article.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/4-binary/04-file/article.md b/4-binary/04-file/article.md index 0e115b8ba..ef19842c3 100644 --- a/4-binary/04-file/article.md +++ b/4-binary/04-file/article.md @@ -42,7 +42,7 @@ El input puede seleccionar varios archivos, por lo que `input.files` es un array ## FileReader -[Lector de Archivos](https://www.w3.org/TR/FileAPI/#dfn-filereader) es un objeto con el único porpósito de leer datos desde objetos de tipo `Blob` (y entonces `File` también). +[FileReader](https://www.w3.org/TR/FileAPI/#dfn-filereader) es un objeto con el único porpósito de leer datos desde objetos de tipo `Blob` (por lo tanto `File` también). El entrega los datos usando eventos debido a que leerlos desde el disco puede tomar un tiempo. From ad5ba12aca17c214bfab408f7076cdecfbf6aaf3 Mon Sep 17 00:00:00 2001 From: Dago <34744883+d4g0@users.noreply.github.com> Date: Fri, 31 Jul 2020 22:54:03 -0400 Subject: [PATCH 13/23] Update 4-binary/04-file/article.md /done Co-authored-by: Valentina VP <34555644+vplentinax@users.noreply.github.com> --- 4-binary/04-file/article.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/4-binary/04-file/article.md b/4-binary/04-file/article.md index ef19842c3..80a6bad05 100644 --- a/4-binary/04-file/article.md +++ b/4-binary/04-file/article.md @@ -60,7 +60,7 @@ Los métodos principales: - **`abort()`** -- cancela la operación. -La opción de `read*` método depende de que formato preferimos y como vamos a usar los datos. +La opción del método `read*` depende de qué formato preferimos y cómo vamos a usar los datos. - `readAsArrayBuffer` -- para archivos binarios, en donde se hacen operaciones binarias de bajo nivel. Para operaciones de alto nivel, como slicing, `File` hereda de `Blob` por lo que podemos llamarlas directamente sin tener que leer. - `readAsText` -- para archivos de texto, cuando nesecitamos obtener una cadena. From 7c96381e287f351c024a3542dc2045e6bb39f987 Mon Sep 17 00:00:00 2001 From: Dago <34744883+d4g0@users.noreply.github.com> Date: Fri, 31 Jul 2020 22:55:06 -0400 Subject: [PATCH 14/23] Update 4-binary/04-file/article.md /done Co-authored-by: Valentina VP <34555644+vplentinax@users.noreply.github.com> --- 4-binary/04-file/article.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/4-binary/04-file/article.md b/4-binary/04-file/article.md index 80a6bad05..6e05f8e12 100644 --- a/4-binary/04-file/article.md +++ b/4-binary/04-file/article.md @@ -64,7 +64,7 @@ La opción del método `read*` depende de qué formato preferimos y cómo vamos - `readAsArrayBuffer` -- para archivos binarios, en donde se hacen operaciones binarias de bajo nivel. Para operaciones de alto nivel, como slicing, `File` hereda de `Blob` por lo que podemos llamarlas directamente sin tener que leer. - `readAsText` -- para archivos de texto, cuando nesecitamos obtener una cadena. -- `readAsDataURL` -- cuando necesitamos usar estos datos como valores de `src` en `img` u otras etiquetas html. Hay otra alternativa para leer archivos para eso como discutimos en el capítulo : `URL.createObjectURL(file)`. +- `readAsDataURL` -- cuando necesitamos usar estos datos como valores de `src` en `img` u otras etiquetas html. Hay otra alternativa para leer archivos de ese tipo como discutimos en el capítulo : `URL.createObjectURL(file)`. En la medida que la lectura procede, suceden varios eventos: - `loadstart` -- la carga comenzó. From 8a71557c28e90c44c52481a8d686ff4821aeab02 Mon Sep 17 00:00:00 2001 From: Dago <34744883+d4g0@users.noreply.github.com> Date: Sun, 2 Aug 2020 18:20:38 -0400 Subject: [PATCH 15/23] Update 4-binary/04-file/article.md Co-authored-by: Valentina VP <34555644+vplentinax@users.noreply.github.com> --- 4-binary/04-file/article.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/4-binary/04-file/article.md b/4-binary/04-file/article.md index 6e05f8e12..ee26c0952 100644 --- a/4-binary/04-file/article.md +++ b/4-binary/04-file/article.md @@ -66,7 +66,7 @@ La opción del método `read*` depende de qué formato preferimos y cómo vamos - `readAsText` -- para archivos de texto, cuando nesecitamos obtener una cadena. - `readAsDataURL` -- cuando necesitamos usar estos datos como valores de `src` en `img` u otras etiquetas html. Hay otra alternativa para leer archivos de ese tipo como discutimos en el capítulo : `URL.createObjectURL(file)`. -En la medida que la lectura procede, suceden varios eventos: +Mientras se va realizando la lectura, suceden varios eventos: - `loadstart` -- la carga comenzó. - `progress` -- ocurre mientras se lee. - `load` -- lectura completada, sin errores. From 8d3ba573c6e703e318b6df1da1df27f7bf0dee25 Mon Sep 17 00:00:00 2001 From: joaquinelio Date: Mon, 3 Aug 2020 13:24:58 -0300 Subject: [PATCH 16/23] Update 4-binary/04-file/article.md Co-authored-by: Danilo Britto --- 4-binary/04-file/article.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/4-binary/04-file/article.md b/4-binary/04-file/article.md index ee26c0952..f8793ea0d 100644 --- a/4-binary/04-file/article.md +++ b/4-binary/04-file/article.md @@ -110,7 +110,7 @@ Como mencionamos en el capítulo , `FileReader` no solo lee archivos Podemos usarlo para convertir un blob a otro formato: - `readAsArrayBuffer(blob)` -- a `ArrayBuffer`, -- `readAsText(blob, [encoding])` -- a cadena (una alternativa al `TextDecoder`), +- `readAsText(blob, [encoding])` -- a una cadena (una alternativa al `TextDecoder`), - `readAsDataURL(blob)` -- a Dato Uri. ``` From 739302d1fb15f91311b77f8982438f38a181e0d6 Mon Sep 17 00:00:00 2001 From: joaquinelio Date: Mon, 3 Aug 2020 13:28:55 -0300 Subject: [PATCH 17/23] Update 4-binary/04-file/article.md Co-authored-by: Danilo Britto --- 4-binary/04-file/article.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/4-binary/04-file/article.md b/4-binary/04-file/article.md index f8793ea0d..a43ef8bef 100644 --- a/4-binary/04-file/article.md +++ b/4-binary/04-file/article.md @@ -116,7 +116,7 @@ Podemos usarlo para convertir un blob a otro formato: ```smart header="`FileReaderSync` está disponible dentro de Web Workers" -Para Web Workers, también existe una variante síncrona de `FileReader`, llamada [FileReaderSync](https://www.w3.org/TR/FileAPI/#FileReaderSync). +Para los Web Workers también existe una variante síncrona de `FileReader` llamada [FileReaderSync](https://www.w3.org/TR/FileAPI/#FileReaderSync). Sus metodos`read*` no generan eventos, sino que devuelven un resultado, como las funciones regulares. From fad4a145b9321127bd1740a2e565052f9bdf5ff2 Mon Sep 17 00:00:00 2001 From: joaquinelio Date: Mon, 3 Aug 2020 13:29:19 -0300 Subject: [PATCH 18/23] Update 4-binary/04-file/article.md Co-authored-by: Danilo Britto --- 4-binary/04-file/article.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/4-binary/04-file/article.md b/4-binary/04-file/article.md index a43ef8bef..674dbe196 100644 --- a/4-binary/04-file/article.md +++ b/4-binary/04-file/article.md @@ -118,7 +118,7 @@ Podemos usarlo para convertir un blob a otro formato: ```smart header="`FileReaderSync` está disponible dentro de Web Workers" Para los Web Workers también existe una variante síncrona de `FileReader` llamada [FileReaderSync](https://www.w3.org/TR/FileAPI/#FileReaderSync). -Sus metodos`read*` no generan eventos, sino que devuelven un resultado, como las funciones regulares. +Sus metodos `read*` no generan eventos sino que devuelven un resultado como las funciones regulares. Esto es solo dentro de un Web Worker, debido a que demoras en llamadas síncronas mientras se lee el archivo en Web Worker no son tan importantes. No afectan la página. From f6842f3ffcbb499a09293e2bc8b33b18923882fb Mon Sep 17 00:00:00 2001 From: joaquinelio Date: Mon, 3 Aug 2020 13:30:30 -0300 Subject: [PATCH 19/23] Update 4-binary/04-file/article.md Co-authored-by: Danilo Britto --- 4-binary/04-file/article.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/4-binary/04-file/article.md b/4-binary/04-file/article.md index 674dbe196..93698f184 100644 --- a/4-binary/04-file/article.md +++ b/4-binary/04-file/article.md @@ -136,7 +136,7 @@ Los objetos `FileReader` pueden leer desde un archivo o un blob en uno de estos - `ArrayBuffer` (`readAsArrayBuffer`). - Datos URI codificado en base 64 (`readAsDataURL`). -En muchos casos no necesitamos leer el contenido de un archivo como hicimos con blobs, podemos crear un enlace corto con `URL.createObjectURL(file)` y asignárselo a un `` o ``. De esta manera el archivo puede ser descargado o ser mostrado como una imagen o como parte de un canvas, etc. +En muchos casos no necesitamos leer el contenido de un archivo como hicimos con los blobs, podemos crear un enlace corto con `URL.createObjectURL(file)` y asignárselo a un `` o ``. De esta manera el archivo puede ser descargado, mostrado como una imagen o como parte de un canvas, etc. From 1734b551c8432b6c347da4506bb5fadef83660ba Mon Sep 17 00:00:00 2001 From: joaquinelio Date: Mon, 3 Aug 2020 13:31:28 -0300 Subject: [PATCH 20/23] Update 4-binary/04-file/article.md Co-authored-by: Danilo Britto --- 4-binary/04-file/article.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/4-binary/04-file/article.md b/4-binary/04-file/article.md index 93698f184..64736331e 100644 --- a/4-binary/04-file/article.md +++ b/4-binary/04-file/article.md @@ -128,7 +128,7 @@ Esto es solo dentro de un Web Worker, debido a que demoras en llamadas síncro Los objetos `File` heredan de `Blob`. -En adición a los métodos y porpiedades de `Blob`, los objetos `File` también tienen `name` and `lastModified` mas la habilidad interna de leer del sistema de archivos. Usualmente obtenemos los objetos `File` mediante la entrada por el usuario con `` o un evento Drag'n'Drop (`ondragend`). +Además de los métodos y propiedades de `Blob`, los objetos `File` también tienen las propiedades `name` y `lastModified` mas la habilidad interna de leer del sistema de archivos. Usualmente obtenemos los objetos `File` mediante la entrada del el usuario con `` o eventos Drag'n'Drop (`ondragend`). Los objetos `FileReader` pueden leer desde un archivo o un blob en uno de estos tres formatos: From 4d0a83a598fcd82a107f69ef28179ec73c3a5da1 Mon Sep 17 00:00:00 2001 From: joaquinelio Date: Mon, 3 Aug 2020 13:35:09 -0300 Subject: [PATCH 21/23] Update 4-binary/04-file/article.md Co-authored-by: Danilo Britto --- 4-binary/04-file/article.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/4-binary/04-file/article.md b/4-binary/04-file/article.md index 64736331e..71edbe829 100644 --- a/4-binary/04-file/article.md +++ b/4-binary/04-file/article.md @@ -111,7 +111,7 @@ Como mencionamos en el capítulo , `FileReader` no solo lee archivos Podemos usarlo para convertir un blob a otro formato: - `readAsArrayBuffer(blob)` -- a `ArrayBuffer`, - `readAsText(blob, [encoding])` -- a una cadena (una alternativa al `TextDecoder`), -- `readAsDataURL(blob)` -- a Dato Uri. +- `readAsDataURL(blob)` -- a Datos URI en base 64. ``` From 4c8eb82c5248cea9cf0503bea4707b60063ebb92 Mon Sep 17 00:00:00 2001 From: joaquinelio Date: Mon, 3 Aug 2020 13:39:45 -0300 Subject: [PATCH 22/23] Sincronizados los nros de linea --- 4-binary/04-file/article.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/4-binary/04-file/article.md b/4-binary/04-file/article.md index 71edbe829..703c122ef 100644 --- a/4-binary/04-file/article.md +++ b/4-binary/04-file/article.md @@ -57,7 +57,6 @@ Los métodos principales: - **`readAsArrayBuffer(blob)`** -- lee los datos en formato binario `ArrayBuffer`. - **`readAsText(blob, [codificación])`** -- lee los datos como una cadena de texto con la codificación dada (por defecto es `utf-8`). - **`readAsDataURL(blob)`** -- lee los datos binarios y los codifica como [Datos URIs] en base 64 (https://developer.mozilla.org/es/docs/Web/HTTP/Basics_of_HTTP/Datos_URIs). - - **`abort()`** -- cancela la operación. La opción del método `read*` depende de qué formato preferimos y cómo vamos a usar los datos. @@ -121,7 +120,6 @@ Para los Web Workers también existe una variante síncrona de `FileReader` llam Sus metodos `read*` no generan eventos sino que devuelven un resultado como las funciones regulares. Esto es solo dentro de un Web Worker, debido a que demoras en llamadas síncronas mientras se lee el archivo en Web Worker no son tan importantes. No afectan la página. - ``` ## Resumen From 73d6236965d80d06a37a0d9d9c92991d624473b3 Mon Sep 17 00:00:00 2001 From: joaquinelio Date: Mon, 3 Aug 2020 13:41:56 -0300 Subject: [PATCH 23/23] sincronizado nros linea 2da parte --- 4-binary/04-file/article.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/4-binary/04-file/article.md b/4-binary/04-file/article.md index 703c122ef..217a57432 100644 --- a/4-binary/04-file/article.md +++ b/4-binary/04-file/article.md @@ -128,7 +128,6 @@ Los objetos `File` heredan de `Blob`. Además de los métodos y propiedades de `Blob`, los objetos `File` también tienen las propiedades `name` y `lastModified` mas la habilidad interna de leer del sistema de archivos. Usualmente obtenemos los objetos `File` mediante la entrada del el usuario con `` o eventos Drag'n'Drop (`ondragend`). - Los objetos `FileReader` pueden leer desde un archivo o un blob en uno de estos tres formatos: - String (`readAsText`) . - `ArrayBuffer` (`readAsArrayBuffer`). @@ -136,6 +135,4 @@ Los objetos `FileReader` pueden leer desde un archivo o un blob en uno de estos En muchos casos no necesitamos leer el contenido de un archivo como hicimos con los blobs, podemos crear un enlace corto con `URL.createObjectURL(file)` y asignárselo a un `` o ``. De esta manera el archivo puede ser descargado, mostrado como una imagen o como parte de un canvas, etc. - - Y si vamos a mandar un `File` por la red, es fácil utilizando APIs como `XMLHttpRequest` o `fetch` que aceptan nativamente objetos `File` .