Fetch API
Fetch API es una herramienta moderna y potente para solicitudes de red que te permite solicitar recursos de forma asíncrona mediante JavaScript, sin necesidad de usar el objeto tradicional XMLHttpRequest.
Fetch API puede realizar solicitudes HTTP de manera concisa y manejar la respuesta del servidor.
Fetch API está diseñado basándose en Promises, lo que hace que las operaciones asíncronas sean más simples y fáciles de entender.
Ventajas de Fetch:
- Basado enPromises, el código es más conciso y legible.
- Mejor mecanismo de manejo de errores: solo se rechaza en errores de red (como no poder conectarse al servidor),
catch, en lugar de errores de código de estado. - Admite múltiples formatos de datos (JSON, texto, binario, etc.).
- Puede manejar solicitudes entre dominios, a través del
CORSmecanismo de configuración.
Uso básico de fetch
La sintaxis de fetch es bastante concisa; la forma más básica es:
fetch(url)
.then(response => response.json()) // 解析 JSON 数据
.then(data => console.log(data)) // 处理数据
.catch(error => console.error('Error:', error)); // 错误处理
Parámetros:
- url: La URL de destino a la que se enviará la solicitud.
- options(Opcional): Puede especificar el método de solicitud (GET, POST, etc.), cabeceras, cuerpo de la solicitud, etc.
Valor de retorno
Devuelve un objeto Promise. La Promise devuelve un objeto Response cuando la solicitud tiene éxito y se rechaza cuando la solicitud falla.
Usar Fetch
1. Solicitud GET básica:
Ejemplo
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
En este ejemplo, fetch realiza por defecto una solicitud GET; la respuesta devuelta es un objeto Response que se analiza como datos JSON llamando al método .json().
2. Enviar una solicitud POST:
Ejemplo
method: 'POST', // Especificar el método de solicitud
headers: {
'Content-Type': 'application/json'
},
body: JSON.stringify({
key: 'value'
})
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
Aquí, enviamos una solicitud POST estableciendo method como 'POST' y enviamos datos en formato JSON en el cuerpo de la solicitud (body).
3. Manejar el estado de la respuesta:
Ejemplo
.then(response => {
if (!response.ok) {
throw new Error('Network response was not ok ' + response.statusText);
}
return response.json();
})
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
Al manejar la respuesta, primero comprobamos si el estado de la respuesta es exitoso (response.ok); si no lo es, lanzamos un error.
4. Enviar una solicitud con credenciales:
Ejemplo
credentials: 'include' // Incluir cookies en la solicitud
});
Usar credentials: 'include' permite enviar cookies en solicitudes entre dominios.
5. Usar los objetos Request y Response:
Ejemplo
fetch(request)
.then(response => response.blob())
.then(imageBlob => {
const imageObjectUrl = URL.createObjectURL(imageBlob);
img.src = imageObjectUrl;
});
Puedes crear un objeto Request para personalizar la solicitud. Fetch devuelve un objeto Response que puedes usar para obtener diferentes tipos de cuerpo de respuesta, como blob, text, json, etc.
6. Manejo de errores:
Ejemplo
.then(response => {
if (response.ok) {
return response.json();
}
throw new Error('Something went wrong');
})
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
En las llamadas encadenadas, cualquier error lanzado en cualquier lugar será capturado por .catch().
7. Configurar cabeceras de solicitud
Puedes añadir cabeceras HTTP personalizadas a la solicitud mediante la propiedad headers, por ejemplo Content-Type, Authorization, etc.
Ejemplo
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer your-token'
},
body: JSON.stringify({ name: 'John', age: 30 })
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
8. Manejar estados de respuesta distintos de 200
Fetch no convierte automáticamente los estados de error HTTP (como 404 o 500) en una Promise rechazada; aún es necesario comprobar el estado de la respuesta.
Ejemplo
.then(response => {
if (!response.ok) { // Comprobar el estado de la respuesta
throw new Error('Network response was not ok ' + response.statusText);
}
return response.json();
})
.then(data => console.log(data))
.catch(error => console.error('Fetch error:', error));
9. Enviar datos de formulario
Puedes usar el objeto FormData para enviar datos de formulario al servidor:
Ejemplo
formData.append('username', 'John');
formData.append('email', 'john@example.com');
fetch('https://example.com/api/form', {
method: 'POST',
body: formData
})
.then(response => response.text())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
10. Solicitudes entre dominios
Si necesitas realizar solicitudes entre dominios, puedes configurar CORS (Cross-Origin Resource Sharing) en el servidor. En el frontend, también puedes especificar si se envían cookies u otras credenciales mediante la opción credentials.
Ejemplo
method: 'GET',
credentials: 'include' // Permitir enviar cookies en solicitudes entre dominios
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
Fetch y PHP
Usar solicitudes AJAX en PHP no es esencialmente diferente de usar AJAX en otros lenguajes de backend. El script PHP recibe la solicitud en el servidor, procesa los datos y devuelve la respuesta.
El código JavaScript del cliente usa Fetch API para enviar solicitudes y manejar respuestas.
Por ejemplo, si tienes un archivo PHP server.php que recibe una solicitud GET y devuelve algunos datos, puedes usar Fetch de la siguiente manera:
Ejemplo
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
En el lado de PHP, analizarás los parámetros de la solicitud y devolverás la respuesta:
Ejemplo
// server.php
$queryString = $_SERVER['QUERY_STRING'];
parse_str($queryString, $params);
$responseData = array('status' => 'success', 'data' => $params);
echo json_encode($responseData);
?>
Así, puedes usar Fetch API en el cliente para comunicarte con el backend de PHP.
Otras extensiones