Esta traducción está incompleta. Por favor, ayuda a traducir este artículo del inglés.
This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for usage in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the specification changes.
La API Fetch proporciona una interfaz para recuperar recursos (incluyendo recursos remotos a través de redes). Le resultará familiar a cualquiera que haya usado XMLHttpRequest
, pero ésta nueva API ofrece un conjunto de características más potente y flexible.
Conceptos y uso
Fetch ofrece una definición genérica de los objetos Request
y Response
(y otras cosas relacionados con las solicitudes de red). Esto permitirá que sean utilizados donde sea necesario en el futuro, ya sea para los operadores de servicios, API caché y otras cosas similares que manipulan o modifican las solicitudes y respuestas, o cualquier tipo de caso de uso que podría requerir la generación de sus propias respuestas mediante programación.
También proporciona una definición de conceptos relacionados, como CORS y la semántica de encabezado HTTP origen, suplantando sus definiciones separadas en otros lugares.
Para hacer una solicitud y recuperar un recurso, utilice el método GlobalFetch.fetch
. Se implementa en múltiples interfaces, específicamente Window
y WorkerGlobalScope
. Esto hace que esté disponible en casi cualquier contexto donde quiera buscar recursos.
El método fetch()
toma un argumento obligatorio, la ruta de acceso al recurso que desea recuperar. Devuelve una Promise
que resuelve en Response
a esa petición, sea o no correcta. También puede pasar opcionalmente un objeto de opciones init como segundo argumento (ver Request
).
Una vez que Response
es recuperada, hay varios métodos disponibles para definir cuál es el contenido del cuerpo y como se debe manejar (ver Body
).
Puede crear una solicitud y respuesta directamente a con los constructores Request()
y Response()
, pero no es recomendable hacerlo directamente. En su lugar, es preferible que sean creados como resultado de otras acciones de la API (por ejemplo, FetchEvent.respondWith
desde los operadores de servicios).
Nota: Puede encontrar mas información sobre las características de la API Fetch en Usando Fetch, y aprender los conceptos en Fetch: conceptos básicos.
Fetch Interfaces o Métodos
GlobalFetch
- Contiene el método
fetch()
utilizado para obtener o inicializar un recurso. Headers
- Representa los encabezados de la respuesta/solicitud, lo que le permite consultar y tomar diferentes acciones en función de los resultados.
Request
- Representa una solicitud de recursos.
Response
- Representa la respuesta a una solicitud.
Fetch mixin
Body
- Proporciona métodos relacionados con el contenido de la respuesta/solicitud, lo que le permite declarar cuál es su tipo y cómo debe manejarse.
Specifications
Especificación | Estado | Comentario |
---|---|---|
Fetch | Living Standard | Definición inicial |
Compatibilidad de navegadores
Característica | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|
Basic support | 42.0 |
39 (39) 34 behind pref |
No support |
29 |
No support |
Streaming response body | 43.0 |
? |
? |
? |
? |
Característica | Android | Android Webview | Firefox Mobile (Gecko) | Firefox OS (Gecko) | IE Phone | Opera Mobile | Safari Mobile | Chrome for Android |
---|---|---|---|---|---|---|---|---|
Basic support | No support | 42.0 | No support | No support | No support | No support | No support | 42.0 |
Streaming respone body | No support | 43.0 |
? |
? |
? |
? |
? |
43.0 |