Skip to content

Fetch: Download progress - #493

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

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

Conversation

@diogoosz

Copy link
Copy Markdown
Contributor

Resumo

Traduz o artigo "Fetch: Download progress" para o português. Os arquivos de apoio (progress.view/, logo-fetch.svg) não são referenciados por este artigo, então foram deixados como estão.

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

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@@ -1,60 +1,60 @@

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.

Importante: o título do artigo ficou sem tradução. Todo o restante do texto foi traduzido, mas esta linha continua em inglês, e é ela que aparece como título da página e no índice do tutorial. Sugestão:

Suggested change
# Fetch: Progresso do download

1. We create `chunksAll = new Uint8Array(receivedLength)` -- a same-typed array with the combined length.
2. Then use `.set(chunk, position)` method to copy each `chunk` one after another in it.
5. We have the result in `chunksAll`. It's a byte array though, not a string.
Reunimos os pedaços da resposta no array `chunks`. Isso é importante, porque depois que a resposta é consumida, não vamos conseguir "reler" usando `response.json()` ou outra forma (você pode tentar, vai dar erro).

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 (opcional): há um pequeno deslize de concordância aqui. Depois de "não existe um único método que...", o verbo fica no subjuntivo ("concatene", e não "concatena"). Também dá para evitar a repetição de "existe ... isso" na mesma frase. Que tal:

Suggested change
Reunimos os pedaços da resposta no array `chunks`. Isso é importante, porque depois que a resposta é consumida, não vamos conseguir "reler" usando `response.json()` ou outra forma (você pode tentar, vai dar erro).
4. No final, temos `chunks` -- um array de pedaços `Uint8Array` de bytes. Precisamos juntá-los num único resultado. Infelizmente, não existe um único método que os concatene, então é preciso um pouco de código para isso:


It may be absent for cross-origin requests (see chapter <info:fetch-crossorigin>) and, well, technically a server doesn't have to set it. But usually it's at place.
3. Call `await reader.read()` until it's done.
Ele pode estar ausente em requisições cross-origin (veja o capítulo <info:fetch-crossorigin>) e, bem, tecnicamente um servidor não é obrigado a defini-lo. Mas geralmente ele está presente.

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 (opcional): "Chama", sem sujeito, soa como terceira pessoa ("ele chama"). Os passos 1 e 2 usam a primeira pessoa do plural ("Realizamos", "podemos descobrir"), então "Chamamos" deixa a lista coerente:

Suggested change
Ele pode estar ausente em requisições cross-origin (veja o capítulo <info:fetch-crossorigin>) e, bem, tecnicamente um servidor não é obrigado a defini-lo. Mas geralmente ele está presente.
3. Chamamos `await reader.read()` até terminar.


1. We perform `fetch` as usual, but instead of calling `response.json()`, we obtain a stream reader `response.body.getReader()`.
1. Realizamos o `fetch` como de costume, mas em vez de chamar `response.json()`, obtemos um leitor de stream `response.body.getReader()`.

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 (opcional): logo acima (item 1) o termo foi traduzido como "leitor de stream", mas aqui ficou "um reader" no meio do texto corrido. Para manter a mesma tradução ao longo do artigo:

Suggested change
Observe que não podemos usar os dois métodos para ler a mesma resposta: ou usamos um leitor, ou um método de resposta para obter o resultado.

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