[ Web Proxy ]
URL:
Viewing: https://developer.mozilla.org/fr/docs/Web/API/Fetch_API [Back]  [Original]

API Fetch - Les API Web | MDN

Cette page a t traduite partir de l'anglais par la communaut. Vous pouvez contribuer en rejoignant la communaut francophone sur MDN Web Docs.

View in English Always switch to English

API Fetch

L'API Fetch fournit une interface pour rcuprer des ressources (y compris sur le rseau). Elle remplace XMLHttpRequest par une solution plus puissante et plus flexible.

Dans cet article

Concepts et utilisation

L'API Fetch utilise les objets Request et Response (ainsi que d'autres lments lis aux requtes rseau), ainsi que des concepts associs comme CORS et la smantique de l'en-tte HTTP Origin.

Pour effectuer une requte et rcuprer une ressource, utilisez la mthode fetch(). Il s'agit d'une mthode globale dans les contextes Window et Worker. Cela la rend disponible dans pratiquement tous les contextes o vous pourriez vouloir rcuprer des ressources.

La mthode fetch() prend un argument obligatoire, le chemin vers la ressource rcuprer. Elle retourne une promesse (Promise) qui rsout la rponse (Response) de cette requte ds que le serveur rpond avec les en-ttes mme si la rponse du serveur est un statut d'erreur HTTP. Vous pouvez aussi lui passer en option un objet d'options init comme second argument (voir Request).

Une fois qu'une rponse (Response) a t rcupre, plusieurs mthodes sont disponibles pour dfinir le contenu du corps et la faon dont il doit tre manipul.

Vous pouvez crer une requte et une rponse directement en utilisant les constructeurs Request() et Response(), mais il est rare de le faire directement. Il est plus courant que leur cration rsulte des actions d'une autre API (par exemple, FetchEvent.respondWith() des service workers).

Pour en savoir plus sur l'utilisation des fonctionnalits de l'API Fetch, consultez Utiliser Fetch.

Fetch diffr

L'API fetchLater() permet une dveloppeureuse de demander un fetch diffr, qui peut tre envoy aprs une priode de temps dfinie, ou lorsque la page est ferme ou quitte. Voir Utiliser un Fetch diffr.

Interfaces

Window.fetch() et WorkerGlobalScope.fetch()

La mthode fetch() utilise pour rcuprer une ressource.

Window.fetchLater()

Utilise pour effectuer une requte de rcupration diffre.

DeferredRequestInit

Reprsente l'ensemble des options pouvant tre utilises pour configurer une requte de rcupration diffre.

FetchLaterResult

Reprsente le rsultat d'une demande de rcupration diffre.

Headers

Reprsente les en-ttes de requte/rponse, permettant de les interroger et de prendre diffrentes dcisions selon le rsultat.

Request

Reprsente une requte de ressource.

Response

Reprsente la rponse une requte.

En-ttes HTTP

deferred-fetch

Contrle le quota principal pour l'API fetchLater().

deferred-fetch-minimal

Contrle le quota partag des sous-frames inter-origines pour l'API fetchLater().

Spcifications

Spcification
Fetch
# fetch-method
Fetch
# deferred-fetch

Compatibilit des navigateurs

api.fetch

api.Window.fetchLater

Voir aussi


Web Proxy Viewer  |  New URL  |  Original Page