correzione articolo e scripts

Author: pierangelomiceli

5-network/09-resume-upload/article.md

@@ -2,49 +2,49 @@
 
 Con il metodo `fetch` è abbastanza semplice eseguire l'upload di un file.
 
-Come ripristinare l'upload di un file dopo avere perso la connessione? Non esistono opzioni built-in per questa operazione, ma abbiamo dei pezzi di codice per implementarla.
+Come possiamo ripristinare l'upload di un file dopo avere perso la connessione? Non esistono opzioni built-in per questa operazione, ma abbiamo dei pezzi di codice per implementarlo.
 
-Il ripristino degli upload dovrebbero andare a braccetto con la possibilità di tenerne traccia durante il trasferimento, come ci aspetteremmo per files di grosse dimensioni (se abbiamo bisogno di ripristinare l'operazione). Dal momento che `fetch` non permette di tenere traccia dell'upload, allora dovremmo rifarci all'uso di [XMLHttpRequest](info:xmlhttprequest).
+Il ripristino degli upload dovrebbero andare a braccetto con la possibilità di tenerne traccia durante il trasferimento, come ci aspetteremmo per files di grosse dimensioni (se abbiamo bisogno di ripristinare l'operazione). Dal momento che `fetch` non permette di tenere traccia dell'upload, allora dobbiamo rifarci all'uso di [XMLHttpRequest](info:xmlhttprequest).
 
 ## Evento di progresso non-così-utile
 
-Per ripristinare un upload, dobbiamo conoscere quanto è stato trasferito prima che la connessione si fosse interrotta.
+Per ripristinare un upload, dobbiamo conoscere la quantità di dato trasferito prima che la connessione si interrompesse.
 
-C'è `xhr.upload.onprogress` per tenere traccia del progresso di upload.
+Per tenere traccia del progresso di upload possiamo usare `xhr.upload.onprogress`.
 
-Sfortunatamene, non ci aiuta nel ripristinare l'upload, dal momento che qeusto viene scatenato quando il dato è stato *inviato*, ma è stato ricevuto dal server? Il browser non lo sa.
+Sfortunatamente, quest non ci aiuta nel ripristinare l'upload, dal momento che questo evento viene scatenato solamente quando il dato è stato *inviato*. Ma è stato ricevuto dal server? Il browser non lo sa.
 
-Magari è stato bufferizzato da qualche proxy di rete locale, o magari il processo del server remoto è stato terminato e non può più processarlo, oppure è stato perso nel bel mezzo del trasferiemnto e non raggiunge il ricevente.
+Magari potrebbe essere stato bufferizzato da qualche proxy di rete locale, o magari il processo del server remoto è stato terminato e non è più in grado di processarlo, oppure è stato perso nel bel mezzo del trasferimento e non raggiunge il ricevente.
 
-Questo è il motivo per il quale è utile solo a mostrare una carinissaima barra di caricamento.
+Questo è il motivo per il quale la sua utilità si limita a mostrare una carinissima barra di caricamento.
 
-Per riprisitnare l'upload, abbiamo bisogno di conoscere *esattamente* il numero di bytes ricevuti dal server. e solo il server può dircelo, quindi creeremo una richiesta aggiuntiva.
+Per ripristinare l'upload, abbiamo bisogno di conoscere *esattamente* il numero di bytes ricevuti dal server. E questa informazione può darcela solamente il server, motivo per il quale andiamo a creare una richiesta aggiuntiva.
 
 ## Algoritmo
 
-1. Per prima cosa, creiamo un id del file, per identificare univocamente il file che stiamo andando a trasferire:
+1. Per prima cosa, creiamo un id del file, per identificare univocamente ciò che stiamo andando a trasferire:
     ```js
     let fileId = file.name + '-' + file.size + '-' + file.lastModified;
     ```
     Ciò è necessario per ripristinare l'upload, per dire al server cosa stiamo ripristinando.
 
-    Se il nome, la dimensione oppure la data di ultima modifica sono differenti, allora ci sarà un altro `fileId`.
+    Se il nome, la dimensione, oppure la data di ultima modifica sono differenti, allora ci sarà un `fileId` differente.
 
-2. Inviamo una richiesta al server, chiedendo quanti bytes possiede già:
+2. Inviamo una richiesta al server, chiedendo quanti bytes possiede già di quel file:
     ```js
     let response = await fetch('status', {
       headers: {
         'X-File-Id': fileId
       }
     });
 
-    // Il serve possiede questo numero di bytes
+    // Il server possiede questo numero di bytes
     let startByte = +await response.text();
     ```
 
-    Questo presume che il server tiene traccia degli upload dei files tramite l'header `X-File-Id`. Dovrebbe essere implmentato lato server.
+    Questo presume che il server tenga traccia degli upload dei files tramite l'header `X-File-Id`. Dovrebbe essere implementato lato server.
 
-    Se il file non essite ancora nel server, allora la risposta del server dovrebbe essere `0`
+    Se il file non esiste ancora nel server, il valore della risposta dovrebbe essere `0`
 
 3. Quindi, possiamo usare il metodo `slice` di `Blob` per inviare il file partendo da `startByte`:
     ```js
@@ -53,20 +53,20 @@ Per riprisitnare l'upload, abbiamo bisogno di conoscere *esattamente* il numero
     // File id, in modo tale che il server possa sapere di quale file stiamo eseguendo l'upload
     xhr.setRequestHeader('X-File-Id', fileId);
 
-    // Il byte a partire dal quale stiamo eseguendo il ripristino, in moda da consentire al server di sapre da che punto stiamo cominciando a ripristinare
+    // Il byte a partire dal quale stiamo eseguendo il ripristino, in modo da consentire al server di sapere da che punto stiamo cominciando a ripristinare
     xhr.setRequestHeader('X-Start-Byte', startByte);
 
     xhr.upload.onprogress = (e) => {
       console.log(`Uploaded ${startByte + e.loaded} of ${startByte + e.total}`);
     };
 
-    // il file può provenire da input.files[0] o altra fonte
+    // il file puo' provenire da input.files[0] o da altra fonte
     xhr.send(file.slice(startByte));
     ```
 
-    Qui inviamo al server sia il file id come `X-File-Id`, di modo che sappia quae file stiamo trasferendo, e da quale byte staimo ripartendo tramite `X-Start-Byte`, cosicché sappia che non stiamo partendo dall'inizio, ma che staimo, invece,  ripristinando.
+    Qui inviamo al server sia il file id come `X-File-Id`, di modo che sappia quale file stiamo trasferendo, e da quale byte stiamo ripartendo tramite `X-Start-Byte`, cosicché sappia che non stiamo partendo dall'inizio, ma che, invece, stiamo ripristinando.
 
-    Il sefver dovrebbe controllare i suoi registri, e nel caso in cui trovasse un upload di quest file, e la dimensione attualemnte caricata fosse esattaemnte di `X-Start-Byte`, allora accoderebbe i dati a qeusto file.
+    Il server dovrebbe controllare i suoi registri, e nel caso in cui trovasse un upload del file, e la dimensione attualmente caricata fosse esattamente di `X-Start-Byte`, accoderebbe i dati al file.
 
 
 Ecco una demo con il codice client e la relativa parte server, scritta in Node.js.
@@ -77,6 +77,6 @@ Funziona parzialmente su questo sito, dal momento che Node.js sta su un altro se
 
 [codetabs src="upload-resume" height=200]
 
-Come possiamo vedere, i moderni metodi di rete sono molto vicini dall'essere dei gestori di files nelle loro capacità, controllo degli headers, indicazione del progresso di upload, invio di frammenti di files etc.
+Come possiamo vedere, i moderni metodi di rete sono molto vicini all'essere dei gestori di files nelle loro capacità, controllo degli headers, indicazione del progresso di upload, invio di frammenti di files etc.
 
-Possiamo implementare upload ripristinabili e molto altro ancora.
+Possiamo implementare, quindi, upload ripristinabili e molto altro ancora.

5-network/09-resume-upload/upload-resume.view/index.html

@@ -7,10 +7,10 @@
   <input type="submit" name="submit" value="Upload (Ripristina automaticamente)">
 </form>
 
-<button onclick="uploader.stop()">Stop upload</button>
+<button onclick="uploader.stop()">Interrompi upload</button>
 
 
-<div id="log">Progress indication</div>
+<div id="log">Indicatore del progresso di upload</div>
 
 <script>
   function log(html) {

5-network/09-resume-upload/upload-resume.view/server.js

@@ -19,7 +19,7 @@ function onUpload(req, res) {
 
   // non salveremo "da nessuna parte"
   let filePath = '/dev/null';
-  // invece sarebbe possibile usare un percorso reale, ad esempio
+  // invece potremmo usare un percorso reale, ad esempio
   // let filePath = path.join('/tmp', fileId);
 
   debug("onUpload fileId: ", fileId);
@@ -40,7 +40,7 @@ function onUpload(req, res) {
     });
     debug("New file created: " + filePath);
   } else {
-    // possiamo controllare su disco la dimension del file per sicurezza
+    // possiamo controllare su disco la dimensione del file per sicurezza
     if (upload.bytesReceived != startByte) {
       res.writeHead(400, "Wrong start byte");
       res.end(upload.bytesReceived);
@@ -62,7 +62,7 @@ function onUpload(req, res) {
   // invia il corpo della richiesta al file
   req.pipe(fileStream);
 
-  // quando la richiesta è completata, e tutti i dati sono stati scritti
+  // quando la richiesta è stata completata, e tutti i dati sono stati scritti
   fileStream.on('close', function() {
     if (upload.bytesReceived == req.headers['x-file-size']) {
       debug("Upload finished");

5-network/09-resume-upload/upload-resume.view/uploader.js

@@ -5,7 +5,7 @@ class Uploader {
     this.onProgress = onProgress;
 
     // crea un fileId che identifica univocamente il file
-    // potremmo usare l'identificatore di sessione dell'utente (avendone uno) per essere sicuri che sia ancora più unico
+    // potremmo usare l'identificatore di sessione dell'utente (avendone uno) per essere ancora piu' sicuri della sua univocita'
     this.fileId = file.name + '-' + file.size + '-' + file.lastModified;
   }
 
@@ -31,7 +31,7 @@ class Uploader {
     let xhr = this.xhr = new XMLHttpRequest();
     xhr.open("POST", "upload", true);
 
-    // invia il file id, in modo da consentire al serve di conoscere quale file ripristinarea
+    // invia il file id, in modo da consentire al server di conoscere quale file ripristinare
     xhr.setRequestHeader('X-File-Id', this.fileId);
     // invia la posizione del byte dal quale stiamo partendo per il ripristino, in modo da informare il server da dove stiamo ripartendo
     xhr.setRequestHeader('X-Start-Byte', this.startByte);