javascript-tutorial / javascript-tutorial/en.javascript.info
Proposal: Add `AbortSignal.timeout()` shorthand to "Fetch: Abort" article
Ninguém assumiu esta issue ainda.
- Linguagem predominante
- HTML
- Estrelas
- 25.5k
- Forks
- 4k
- Métricas de merge de PRs
- Nenhum PR com merge em 30d
Descrição
### Description
The ["Fetch: Abort"](https://github.com/javascript-tutorial/en.javascript.info/blob/20208769e528337949e946f526534d61d38bac47/5-network/04-fetch-abort/article.md) article excellently explains the mechanics of `AbortController` and demonstrates a manual timeout using
```js
setTimeout(() => controller.abort(), 1000)
```
Since aborting fetches due to time constraints is a very common use case, it would be highly beneficial for learners to also see the modern [`AbortSignal.timeout()`](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal/timeout_static) method.
### Proposal
I propose adding a short subsection titled `### AbortSignal.timeout()` immediately following the `try..catch` block of the manual timeout example. This section will demonstrate the shorthand syntax and note the important distinction that it throws a `TimeoutError` rather than an `AbortError`.
Guia de contribuição
Nenhum guia de contribuição indexado para este repositório
Primeiros passos
- Leia a issue inteira e depois o guia de contribuição do projeto.
- Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
- Faça um fork do repositório e trabalhe em uma branch.
- Abra um pull request que referencie o número da issue.
Direção de pesquisa
Abra 5-network/04-fetch-abort/article.md e leia o exemplo de timeout manual, especialmente o bloco try..catch. Adicione imediatamente depois a subseção proposta sobre AbortSignal.timeout(), mostrando a forma abreviada e explicando a distinção entre TimeoutError e AbortError. A tarefa estará concluída quando o artigo abordar claramente as duas abordagens de timeout.
Escrita pelo modelo de indexação a partir do texto da issue.
Avaliação
- Stack de tecnologia
- javascript
- Domínio
- documentation
- Tipo de issue
- Documentação
- Dificuldade
- 1/5
- Tempo estimado
- 1-3 horas
- Status de atividade
- Pouca atividade
- Clareza
- Claramente especificada
- Facilidade para iniciantes
- 88/100