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, durch
CORSMechanismus-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
.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
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
.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
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
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
.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
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
.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
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
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
.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
// 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