javascript-tutorial / javascript-tutorial/en.javascript.info

Proposal: Add `AbortSignal.timeout()` shorthand to "Fetch: Abort" article

Aberta Para iniciantes
#3,988 0 comentários 0 reações 0 responsáveis Ver no GitHub

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

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. 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

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.