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

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

Ouverte Adaptée aux débutants
#3,988 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

Langage dominant
HTML
Étoiles
25.5k
Forks
4k
Métriques de merge des PR
Aucune PR mergée en 30 j

Description

### 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`.

Guide de contribution

Aucun guide de contribution indexé pour ce dépôt

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Piste de recherche

Ouvrez 5-network/04-fetch-abort/article.md et lisez l’exemple de délai d’expiration manuel, en particulier le bloc try..catch. Ajoutez immédiatement après la sous-section proposée sur AbortSignal.timeout(), en montrant la forme abrégée et en expliquant la différence entre TimeoutError et AbortError. La tâche est terminée lorsque l’article couvre clairement les deux approches de délai d’expiration.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Évaluation

Stack technique
javascript
Domaine
documentation
Type d'issue
Documentation
Difficulté
1/5
Temps estimé
1-3 heures
Activité
Calme
Clarté
Clairement spécifiée
Accessibilité débutants
88/100

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.