Skip to content

WebSocket - #501

Open
diogoosz wants to merge 1 commit into
javascript-tutorial:masterfrom
diogoosz:translate-websocket
Open

diogoosz wants to merge 1 commit into
javascript-tutorial:masterfrom
diogoosz:translate-websocket

Conversation

@diogoosz

Copy link
Copy Markdown
Contributor

Resumo

  • Traduz o artigo "WebSocket" para o português.
  • Traduz o diagrama SVG (websocket-handshake.svg) via images.yml + pipeline do gulp, conferido visualmente.
  • Traduz a UI e os comentários da demo de chat (chat.view/).
  • Strings de demo (alert/console/mensagens do servidor) que o próprio código do artigo exibe (ex.: "Hello from server, John", "[open] Connection established") ficaram em inglês, de forma consistente em todo o artigo e nas duas pastas de demo.

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.
  • Verificação visual do SVG traduzido.

🤖 Generated with Claude Code

- Translates the SVG diagram (websocket-handshake.svg) via
  images.yml + the gulp translation pipeline, verified visually.
- Translates the chat demo (chat.view/) UI text and comments.
- Demo-only alert()/console/server message strings that the
  article's own code blocks display (e.g. "Hello from server, John",
  "[open] Connection established") are kept in English, consistently
  throughout the article and its two demo folders.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
- `Sec-WebSocket-Extensions: deflate-frame` significa que o navegador suporta compressão de dados. Uma extensão é algo relacionado à transferência dos dados, uma funcionalidade que estende o protocolo WebSocket. O cabeçalho `Sec-WebSocket-Extensions` é enviado automaticamente pelo navegador, com a lista de todas as extensões que ele suporta.

- `Sec-WebSocket-Protocol: soap, wamp` means that we'd like to transfer not just any data, but the data in [SOAP](https://en.wikipedia.org/wiki/SOAP) or WAMP ("The WebSocket Application Messaging Protocol") protocols. WebSocket subprotocols are registered in the [IANA catalogue](https://www.iana.org/assignments/websocket/websocket.xml). So, this header describes the data formats that we're going to use.
- `Sec-WebSocket-Protocol: soap, wamp` significa que gostaríamos de transferir não só qualquer dado, mas dados nos protocolos [SOAP](https://en.wikipedia.org/wiki/SOAP) ou WAMP ("The WebSocket Application Messaging Protocol"). Subprotocolos WebSocket são registrados no [catálogo IANA](https://www.iana.org/assignments/websocket/websocket.xml). Então, esse cabeçalho descreve os formatos de dados que vamos usar.

@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.

Olá! Acho que aqui o sentido ficou invertido em relação ao original. Em português, "não só X, mas Y" quer dizer "não apenas X, mas também Y", então o leitor entende que transferimos qualquer dado e também SOAP/WAMP. O original ("not just any data, but the data in SOAP or WAMP") quer dizer que transferimos dados nesses formatos em vez de dados arbitrários. Sugestão: "não um dado qualquer, mas sim dados nos protocolos".

Suggested change
- `Sec-WebSocket-Protocol: soap, wamp` significa que gostaríamos de transferir não só qualquer dado, mas dados nos protocolos [SOAP](https://en.wikipedia.org/wiki/SOAP) ou WAMP ("The WebSocket Application Messaging Protocol"). Subprotocolos WebSocket são registrados no [catálogo IANA](https://www.iana.org/assignments/websocket/websocket.xml). Então, esse cabeçalho descreve os formatos de dados que vamos usar.
- `Sec-WebSocket-Protocol: soap, wamp` significa que gostaríamos de transferir não um dado qualquer, mas sim dados nos protocolos [SOAP](https://en.wikipedia.org/wiki/SOAP) ou WAMP ("The WebSocket Application Messaging Protocol"). Subprotocolos WebSocket são registrados no [catálogo IANA](https://www.iana.org/assignments/websocket/websocket.xml). Então, esse cabeçalho descreve os formatos de dados que vamos usar.

## Fechamento da conexão

Normally, when a party wants to close the connection (both browser and server have equal rights), they send a "connection close frame" with a numeric code and a textual reason.
Normalmente, quando uma das partes quer fechar a conexão (tanto navegador quanto servidor têm direitos iguais), elas enviam um "frame de fechamento de conexão" com um código numérico e um motivo textual.

@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.

Pequeno erro de concordância: o sujeito é "uma das partes" (singular), mas o verbo está no plural ("elas enviam"). Sugestão: "ela envia".

Suggested change
Normalmente, quando uma das partes quer fechar a conexão (tanto navegador quanto servidor têm direitos iguais), elas enviam um "frame de fechamento de conexão" com um código numérico e um motivo textual.
Normalmente, quando uma das partes quer fechar a conexão (tanto navegador quanto servidor têm direitos iguais), ela envia um "frame de fechamento de conexão" com um código numérico e um motivo textual.

Imagine que nosso app está gerando muitos dados para enviar. Mas o usuário tem uma conexão de rede lenta, talvez numa internet móvel, fora da cidade.

We can call `socket.send(data)` again and again. But the data will be buffered (stored) in memory and sent out only as fast as network speed allows.
Podemos chamar `socket.send(data)` repetidamente. Mas os dados vão ficar em buffer (armazenados) na memória e enviados só tão rápido quanto a velocidade da rede permitir.

@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.

Aqui a frase ficou um pouco truncada: "vão ficar (...) e enviados" junta o particípio "enviados" sem o verbo auxiliar. Sugestão: "e ser enviados".

Suggested change
Podemos chamar `socket.send(data)` repetidamente. Mas os dados vão ficar em buffer (armazenados) na memória e enviados só tão rápido quanto a velocidade da rede permitir.
Podemos chamar `socket.send(data)` repetidamente. Mas os dados vão ficar em buffer (armazenados) na memória e ser enviados só tão rápido quanto a velocidade da rede permitir.

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