Fetch API

Fetch API ist ein modernes, leistungsstarkes Tool für Netzwerkanfragen, mit dem Sie Ressourcen asynchron über JavaScript anfordern können, ohne das traditionelle XMLHttpRequest-Objekt zu verwenden.

Fetch API kann HTTP-Anfragen prägnant senden und Serverantworten verarbeiten.

Fetch API ist auf Basis von Promises konzipiert, was asynchrone Operationen prägnanter und leichter verständlich macht.

Vorteile von Fetch:

  • Basiert aufPromises, wodurch der Code prägnanter und lesbarer wird.
  • Besserer Mechanismus zur Fehlerbehandlung: Wird nur bei Netzwerkfehlern ausgelöst (z. B. wenn keine Verbindung zum Server hergestellt werden kann)catch, statt bei Statuscode-Fehlern.
  • Unterstützt mehrere Datenformate (JSON, Text, Binär usw.).
  • Kann Cross-Origin-Anfragen verarbeiten, durchCORSMechanismus-Konfiguration.

Grundlegende Verwendung von fetch

Die Syntax von fetch ist recht prägnant; die grundlegendste Form ist:

fetch(url)
  .then(response => response.json()) // 解析 JSON 数据
  .then(data => console.log(data))   // 处理数据
  .catch(error => console.error('Error:', error)); // 错误处理

Parameter:

  • url: Die Ziel-URL, an die die Anfrage gesendet wird.
  • options(Optional): Sie können die Anfragemethode (GET, POST usw.), Anfrage-Header, Anfrage-Body und mehr angeben.

Rückgabewert

Gibt ein Promise-Objekt zurück. Das Promise gibt bei erfolgreicher Anfrage ein Response-Objekt zurück und wird bei Fehlschlag abgelehnt.


Fetch verwenden

1. Grundlegende GET-Anfrage:

Beispiel

fetch('https://api.example.com/data')
    .then(response => response.json())
    .then(data => console.log(data))
    .catch(error => console.error('Error:', error));

In diesem Beispiel führt fetch standardmäßig eine GET-Anfrage aus. Die zurückgegebene Antwort ist ein Response-Objekt, und JSON-Daten werden durch Aufrufen der Methode .json() geparst.

2. Senden einer POST-Anfrage:

Beispiel

fetch('https://api.example.com/data', {
    method: 'POST', // Anfragemethode angeben
    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));

Hier senden wir eine POST-Anfrage, indem wir method auf 'POST' setzen, und senden JSON-formatierte Daten im Anfrage-Body.

3. Behandeln des Antwortstatus:

Beispiel

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));

Bei der Behandlung der Antwort prüfen wir zuerst, ob der Antwortstatus erfolgreich ist (response.ok), und werfen einen Fehler, wenn dies nicht der Fall ist.

4. Senden von Anfragen mit Anmeldedaten:

Beispiel

fetch('https://api.example.com/data', {
    credentials: 'include' // Cookies in die Anfrage aufnehmen
});

Die Verwendung von credentials: 'include' ermöglicht das Senden von Cookies bei Cross-Origin-Anfragen.

5. Verwenden von Request- und Response-Objekten:

Beispiel

const request = new Request('flowers.jpg');
fetch(request)
    .then(response => response.blob())
    .then(imageBlob => {
        const imageObjectUrl = URL.createObjectURL(imageBlob);
        img.src = imageObjectUrl;
    });

Sie können ein Request-Objekt erstellen, um die Anfrage anzupassen. fetch gibt ein Response-Objekt zurück, das Sie verwenden können, um verschiedene Arten von Response-Bodies zu erhalten, wie blob, text, json usw.

6. Fehlerbehandlung:

Beispiel

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));

In einem verketteten Aufruf werden Fehler, die irgendwo ausgelöst werden, von .catch() abgefangen.

7. Festlegen von Anfrage-Headern

Sie können der Anfrage benutzerdefinierte HTTP-Header-Informationen hinzufügen, indem Sie die headers-Eigenschaft verwenden, z. B. Content-Type, Authorization usw.

Beispiel

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. Umgang mit Nicht-200-Antwortstatuscodes

fetch behandelt HTTP-Fehlerstatus (wie 404 oder 500) nicht automatisch als abgelehnte Promises; Sie müssen weiterhin den Antwortstatus prüfen.

Beispiel

fetch('https://example.com/api')
  .then(response => {
    if (!response.ok) { // Antwortstatus prüfen
      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. Senden von Formulardaten

Sie können das FormData-Objekt verwenden, um Formulardaten an den Server zu senden:

Beispiel

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));

Cross-Origin-Anfragen

Wenn Cross-Origin-Anfragen benötigt werden, können Sie serverseitig CORS (Cross-Origin Resource Sharing) einrichten. Auf der Clientseite können Sie außerdem die Option credentials verwenden, um anzugeben, ob Anmeldedaten wie Cookies gesendet werden.

Beispiel

fetch('https://example.com/api', {
    method: 'GET',
    credentials: 'include' // Senden von Cookies bei Cross-Origin-Anfragen erlauben
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

Fetch und PHP

Die Verwendung von AJAX-Anfragen in PHP unterscheidet sich im Wesentlichen nicht von der Verwendung von AJAX in anderen Backend-Sprachen. PHP-Skripte empfangen Anfragen, verarbeiten Daten und geben Antworten auf der Serverseite zurück.

Clientseitiger JavaScript-Code verwendet die Fetch-API, um Anfragen zu senden und Antworten zu verarbeiten.

Wenn Sie beispielsweise eine PHP-Datei server.php haben, die eine GET-Anfrage empfängt und einige Daten zurückgibt, können Sie Fetch wie folgt verwenden:

Beispiel

fetch('server.php?query=123')
    .then(response => response.json())
    .then(data => console.log(data))
    .catch(error => console.error('Error:', error));

Auf der PHP-Seite parsen Sie die Anfrageparameter und geben eine Antwort zurück:

Beispiel

<?php
// server.php
$queryString = $_SERVER['QUERY_STRING'];
parse_str($queryString, $params);
$responseData = array('status' => 'success', 'data' => $params);
echo json_encode($responseData);
?>

Auf diese Weise können Sie die Fetch-API auf der Clientseite verwenden, um mit dem PHP-Backend zu kommunizieren.

Weitere Erweiterungen