Skip to content

Server Sent Events - #502

Open
diogoosz wants to merge 1 commit into
javascript-tutorial:masterfrom
diogoosz:translate-server-sent-events
Open

diogoosz wants to merge 1 commit into
javascript-tutorial:masterfrom
diogoosz:translate-server-sent-events

Conversation

@diogoosz

Copy link
Copy Markdown
Contributor

Resumo

Traduz o artigo "Server Sent Events" para o português, incluindo a demo embutida via [codetabs src="eventsource"] (eventsource.view/index.html): botões, texto instrucional e mensagens de log. Nomes literais de evento (open, message, bye) ficaram sem tradução, por serem identificadores. server.js não tem texto voltado ao usuário e foi deixado como está.

Plano de teste

  • Diff de todos os trechos de código (code spans) entre o original em inglês e a tradução.
  • Grep em busca de falsos cognatos conhecidos e registro informal.
  • Releitura manual completa para checar sentido e concordância.

🤖 Generated with Claude Code

Also translates the embedded demo shown via [codetabs]
(eventsource.view/index.html): button labels, instructional text,
and log messages (keeping literal event-name values like "open",
"message", "bye" untranslated, as identifiers). server.js has no
user-facing text and was left untouched.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Isso faz do `EventSource` uma alternativa viável ao `WebSocket`, já que este último é mais de baixo nível e não tem esses recursos nativos (embora eles possam ser implementados).

In many real-life applications, the power of `EventSource` is just enough.
Em muitas aplicações da vida real, o poder do `EventSource` é só o suficiente.

@gabifs gabifs Nov 22, 2026 •

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sugestão: "é só o suficiente" pode soar como "é apenas suficiente, por pouco", o que enfraquece o sentido do original ("the power of EventSource is just enough", ou seja, é tudo de que se precisa). Que tal remover o "só"?

Suggested change
Em muitas aplicações da vida real, o poder do `EventSource` é só o suficiente.
Em muitas aplicações da vida real, o poder do `EventSource` é suficiente.

```

When an object is created, or the connection is down, it's always `EventSource.CONNECTING` (equals `0`).
Quando um objeto é criado, ou a conexão está fora do ar, ele é sempre `EventSource.CONNECTING` (igual a `0`).

@gabifs gabifs Nov 22, 2026 •

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sugestão: em "ele é sempre EventSource.CONNECTING", o pronome "ele" acaba se referindo a "um objeto", como se o próprio objeto fosse igual a CONNECTING. No original, o "it" é a propriedade readyState. Citar a propriedade diretamente evita a ambiguidade:

Suggested change
Quando um objeto é criado, ou a conexão está fora do ar, ele é sempre `EventSource.CONNECTING` (igual a `0`).
Quando um objeto é criado, ou a conexão está fora do ar, `readyState` é sempre `EventSource.CONNECTING` (igual a `0`).

```

The remote server will get the `Origin` header and must respond with `Access-Control-Allow-Origin` to proceed.
O servidor remoto vai obter o cabeçalho `Origin` e deve responder com `Access-Control-Allow-Origin` para prosseguir.

@gabifs gabifs Nov 22, 2026 •

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sugestão: "vai obter o cabeçalho Origin" dá a entender que o servidor vai buscar o cabeçalho; no original, "will get" significa que o servidor o recebe junto com a requisição. "receber" deixa isso mais claro:

Suggested change
O servidor remoto vai obter o cabeçalho `Origin` e deve responder com `Access-Control-Allow-Origin` para prosseguir.
O servidor remoto vai receber o cabeçalho `Origin` e deve responder com `Access-Control-Allow-Origin` para prosseguir.

let eventSource = new EventSource("/events/subscribe");

eventSource.onmessage = function(event) {
console.log("New message", event.data);

@gabifs gabifs Nov 22, 2026 •

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Os comentários deste bloco de código foram traduzidos, mas o texto ao lado continua em inglês ("New message"), então o exemplo fica misturando idiomas. O mesmo vale para data: Hello, I set the reconnection delay to 15 seconds (linha 100) e para os exemplos de fluxo data: Message 1/2/3. Que tal traduzir também esses textos? Por exemplo:

Suggested change
console.log("New message", event.data);
console.log("Nova mensagem", event.data);

@@ -1,32 +1,32 @@
# Server Sent Events

@gabifs gabifs Nov 22, 2026 •

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Todos os títulos do artigo foram traduzidos, exceto o título principal, que continua "Server Sent Events". É ele que aparece no índice e na navegação do tutorial. Se a ideia for manter o termo em inglês de propósito, pode desconsiderar; caso contrário, que tal algo como "# Eventos enviados pelo servidor (Server-Sent Events)"?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants