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 delCORSmecanismo 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

fetch('https://api.example.com/data')
    .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

fetch('https://api.example.com/data', {
    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

fetch('https://api.example.com/data')
    .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

fetch('https://api.example.com/data', {
    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

const request = new Request('flowers.jpg');
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

fetch('https://api.example.com/data')
    .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

fetch('https://example.com/api', {
    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

fetch('https://example.com/api')
  .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

const formData = new FormData();
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

fetch('https://example.com/api', {
    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

fetch('server.php?query=123')
    .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

<?php
// 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