Skip to content

Commit f34ddaf

Browse files
authored
Merge pull request #180 from pierangelomiceli/serversentevents
Server Sent Events
2 parents fa96242 + 8b5fa10 commit f34ddaf

File tree

1 file changed

+12
-12
lines changed

1 file changed

+12
-12
lines changed

5-network/12-server-sent-events/article.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -37,11 +37,11 @@ data: Message 3
3737
data: of two lines
3838
```
3939

40-
- Un messaggio di testo che va dopo `data:`, lo spazio dopo la virgola è opzionale.
40+
- Un messaggio di testo segue la stringa `data:`, lo spazio dopo la virgola è opzionale.
4141
- I messaggi sono delimitati con un doppio line break `\n\n`.
42-
- Per inviare un line break `\n`, possiamo inviare immediatamente un altro `data:` (il terzo messaggio nell'esempio qui sopra).
42+
- Per inviare un line break `\n`, possiamo inviare immediatamente un altro `data:` (il terzo messaggio nell'esempio precedente).
4343

44-
In pratica, i messaggi complessi sono solitamente inviati tramite oggetti codificati in JSO. I Line-breaks sono codificati come `\n` tra essi, e in questo modo i messaggi `data:` multiriga non sono necessari
44+
In pratica, i messaggi complessi sono solitamente inviati tramite oggetti codificati in JSO. I Line-breaks sono codificati come `\n`, e in questo modo i messaggi `data:` multiriga non sono necessari
4545

4646
Ad esempio:
4747

@@ -114,7 +114,7 @@ eventSource.close();
114114
Inoltre, non avverrà alcuna riconnessione se la risposta ha un `Content-type` non valido o se il suo HTTP status è diverso da 301, 307, 200 o 204. In questi casi verrà emesso l'evento `"error"`, e il browser non si riconnetterà.
115115

116116
```smart
117-
Quando una connessione è finalemente chiusa, non ci sarà modo di "riaprirla". Se volessimo riconnetterci nuovamente, dovremmo ricreare un nuovo `EventSource`.
117+
Quando una connessione è finalmente chiusa, non ci sarà modo di "riaprirla". Se volessimo riconnetterci nuovamente, dovremmo ricreare un nuovo `EventSource`.
118118
```
119119

120120
## Message id
@@ -143,7 +143,7 @@ Nota bene: l'`id` viene aggiunto dopo il messaggio `data` dal server, per assicu
143143
144144
## Stato della conessione: readyState
145145
146-
L'oggetto `EventSource` possiede la proprietà `readyState`, che assume uno tra questi tre valori:
146+
L'oggetto `EventSource` possiede la proprietà `readyState`, che può assumere uno dei seguenti valori:
147147
148148
```js no-beautify
149149
EventSource.CONNECTING = 0; // connessione o riconnessione
@@ -161,7 +161,7 @@ Di base l'oggetto `EventSource` genera tre eventi:
161161

162162
- `message` -- un messaggio ricevuto, disponibile come `event.data`.
163163
- `open` -- la connessione è aperta.
164-
- `error` -- la connessaione non può essere stabilita, ad esempio, il server ha risposto con lo status HTTP 500.
164+
- `error` -- la connessione non può essere stabilita, ad esempio, il server ha risposto con lo status HTTP 500.
165165

166166
Il server può specificare un altro tipo di evento con `event: ...` all'inizio dell'evento.
167167

@@ -248,19 +248,19 @@ Complessivamente la sicurezza del cross-origin è la stessa di `fetch` e altri m
248248
: La connessione è stabilita.
249249

250250
`error`
251-
: In caso di errori, includendo sia la connessione persa (si riconnetterà automaticamente), che errori fatali. Possiamo controllare `readyState` per vedere se è stata tentata la riconnessione.
251+
: In caso di errori, inclusi sia la connessione persa (con riconnessione automatica) che eventuali errori fatali. Possiamo controllare `readyState` per vedere se è stata tentata la riconnessione.
252252

253-
Il server può impostare un evento custom dentro `event:`. Questi eventi andrebbero gestiti usando `addEventListener`, e non `on<event>`.
253+
Il server può impostare un evento personalizzato dentro `event:`. Questi eventi andrebbero gestiti usando `addEventListener`, e non `on<event>`.
254254

255255
### Formato della risposta del server
256256

257257
Il server invia messaggi, delimitati da `\n\n`.
258258

259259
Un messaggio può avere i seguenti campi:
260260

261-
- `data:` -- corpo del messaggio, una sequenza di `data` multipli viene intrpretata come un messaggio singolo, con `\n` tra la parti.
262-
- `id:` -- aggiorna il `lastEventId`, inviato dentro `Last-Event-ID` in fase di riconnnessione.
263-
- `retry:` -- raccomnda una ritardo nel tentativo di riconessione in millisecondi. Non c'è modo di impostarlo da JavaScript.
264-
- `event:` -- event name, must precede `data:`.
261+
- `data:` -- corpo del messaggio, una sequenza di `data` multipli viene interpretata come un messaggio singolo, con `\n` tra la parti.
262+
- `id:` -- aggiorna `lastEventId`, inviato dentro `Last-Event-ID` in fase di riconnessione.
263+
- `retry:` -- raccomanda una ritardo nel tentativo di riconessione in millisecondi. Non c'è modo di impostarlo da JavaScript.
264+
- `event:` -- il nome dell'evento, deve necessariamente precedere `data:`.
265265

266266
Un messaggio può includere uno o più campi in qualunque ordine, ma l'`id:` solitamente va per ultimo.

0 commit comments

Comments
 (0)