In diesem Codelab erfahren Sie, wie Sie die HTTP-Caching-Header ändern, die von einem Node.js-basierten Webserver zurückgegeben werden, auf dem das Express-Serving-Framework ausgeführt wird. Außerdem wird gezeigt, wie Sie im Netzwerkbereich der Chrome-Entwicklertools prüfen können, ob das erwartete Caching-Verhalten tatsächlich angewendet wird.
Beispielprojekt kennenlernen
Dies sind die wichtigsten Dateien, mit denen Sie im Beispielprojekt arbeiten werden:
server.jsenthält den Node.js-Code, der den Inhalt der Webanwendung bereitstellt. Es verwendet Express, um HTTP-Anfragen und -Antworten zu verarbeiten. Insbesondere wirdexpress.static()verwendet, um alle lokalen Dateien im öffentlichen Verzeichnis bereitzustellen. Daher ist die Dokumentation zuserve-staticnützlich.public/index.htmlist der HTML-Code der Web-App. Wie die meisten HTML-Dateien enthält sie keine Versionsinformationen in der URL.public/app.15261a07.jsundpublic/style.391484cf.csssind die JavaScript- und CSS-Assets der Webanwendung. Diese Dateien enthalten jeweils einen Hash in ihren URLs, der ihrem Inhalt entspricht.index.htmlist dafür verantwortlich, zu verfolgen, welche spezifische versionierte URL geladen werden soll.
Caching-Header für HTML konfigurieren
Wenn Sie auf Anfragen für URLs antworten, die keine Versionsverwaltungsinformationen enthalten, müssen Sie Ihren Antwortnachrichten Cache-Control: no-cache hinzufügen. Außerdem wird empfohlen, einen von zwei zusätzlichen Antwortheadern festzulegen: entweder Last-Modified oder ETag. index.html fällt in diese Kategorie. Sie können dies in zwei Schritte unterteilen.
Erstens werden die Header Last-Modified und ETag durch die Konfigurationsoptionen etag und lastModified gesteuert. Beide Optionen sind standardmäßig auf true für alle HTTP-Antworten festgelegt. In dieser aktuellen Konfiguration müssen Sie sich also nicht aktiv dafür entscheiden, um dieses Verhalten zu erhalten. Sie können dies jedoch trotzdem in Ihrer Konfiguration explizit angeben.
Zweitens musst du den Header Cache-Control: no-cache hinzufügen können, aber nur für deine HTML-Dokumente (in diesem Fall index.html). Am einfachsten lässt sich dieser Header bedingt festlegen, indem Sie einen benutzerdefinierten setHeaders function schreiben und darin prüfen, ob die eingehende Anfrage für ein HTML-Dokument bestimmt ist.
Die statische Bereitstellungskonfiguration in server.js sieht so aus:
app.use(express.static('public'));
- Nehmen Sie die oben beschriebenen Änderungen vor. Das Ergebnis sollte in etwa so aussehen:
app.use(express.static('public', {
etag: true, // Just being explicit about the default.
lastModified: true, // Just being explicit about the default.
setHeaders: (res, path) => {
if (path.endsWith('.html')) {
// All of the project's HTML files end in .html
res.setHeader('Cache-Control', 'no-cache');
}
},
}));
Caching-Header für die versionierten URLs konfigurieren
Wenn du auf Anfragen für URLs antwortest, die Fingerabdruck- oder Versionsinformationen enthalten und deren Inhalt sich nie ändern soll, füge deinen Antworten Cache-Control: max-age=31536000 hinzu. app.15261a07.js und style.391484cf.css fallen in diese Kategorie.
Aufbauend auf dem im letzten Schritt verwendeten setHeaders function können Sie zusätzliche Logik hinzufügen, um zu prüfen, ob eine bestimmte Anfrage für eine versionierte URL bestimmt ist. Wenn ja, fügen Sie den Header Cache-Control:
max-age=31536000 hinzu.
Die zuverlässigste Methode hierfür ist die Verwendung eines regulären Ausdrucks, um zu prüfen, ob das angeforderte Asset einem bestimmten Muster entspricht, von dem Sie wissen, dass die Hashes dazu passen. In diesem Beispielprojekt sind es immer acht Zeichen aus den Ziffern 0–9 und den Kleinbuchstaben a–f (also hexadezimale Zeichen). Der Hash wird auf beiden Seiten immer durch ein .-Zeichen getrennt.
Ein regulärer Ausdruck, der diesen allgemeinen Regeln entspricht, kann als new RegExp('\\.[0-9a-f]{8}\\.') ausgedrückt werden.
- Ändern Sie die Funktion
setHeadersso, dass sie folgendermaßen aussieht:
app.use(express.static('public', {
etag: true, // Just being explicit about the default.
lastModified: true, // Just being explicit about the default.
setHeaders: (res, path) => {
const hashRegExp = new RegExp('\\.[0-9a-f]{8}\\.');
if (path.endsWith('.html')) {
// All of the project's HTML files end in .html
res.setHeader('Cache-Control', 'no-cache');
} else if (hashRegExp.test(path)) {
// If the RegExp matched, then we have a versioned URL.
res.setHeader('Cache-Control', 'max-age=31536000');
}
},
}));
Neues Verhalten mit den Entwicklertools bestätigen
Nachdem Sie die Änderungen am statischen Dateiserver vorgenommen haben, können Sie prüfen, ob die richtigen Header festgelegt werden. Rufen Sie dazu die Vorschau der Live-App auf, während der Netzwerkbereich der Entwicklertools geöffnet ist.
- Sie können die im Netzwerkbereich angezeigten Spalten anpassen, um die für Sie relevantesten Informationen einzublenden. Klicken Sie dazu mit der rechten Maustaste auf die Spaltenüberschrift:

Hier sind die Spalten Name, Status, Cache-Control, ETag und Last-Modified wichtig.
- Aktualisieren Sie die Seite, während die Entwicklertools im Netzwerkbereich geöffnet sind.
Nachdem die Seite geladen wurde, sollten im Netzwerkbereich Einträge wie die folgenden angezeigt werden:

Die erste Zeile ist für das HTML-Dokument, zu dem Sie navigiert sind. Dies wird ordnungsgemäß mit Cache-Control: no-cache bereitgestellt. Der HTTP-Antwortstatus für diese Anfrage ist 304. Das bedeutet, dass der Browser wusste, dass er den im Cache gespeicherten HTML-Code nicht sofort verwenden sollte, sondern stattdessen eine HTTP-Anfrage an den Webserver gesendet hat. Dabei wurden die Informationen Last-Modified und ETag verwendet, um zu prüfen, ob es ein Update für den HTML-Code gab, der bereits im Cache vorhanden war. Die HTTP 304-Antwort gibt an, dass kein aktualisierter HTML-Code vorhanden ist.
Die nächsten beiden Zeilen sind für die versionierten JavaScript- und CSS-Assets vorgesehen. Sie sollten mit Cache-Control: max-age=31536000 bereitgestellt werden und der HTTP-Status für jede sollte 200 sein.
Aufgrund der verwendeten Konfiguration wird keine tatsächliche Anfrage an den Node.js-Server gesendet. Wenn Sie auf den Eintrag klicken, werden zusätzliche Details angezeigt, einschließlich der Information, dass die Antwort „(aus dem Datenträger-Cache)“ stammt.

Die tatsächlichen Werte für die Spalten „ETag“ und „Last-Modified“ sind nicht so wichtig. Wichtig ist, dass sie festgelegt werden.
Zusammenfassung
Nachdem Sie die Schritte in diesem Codelab ausgeführt haben, wissen Sie jetzt, wie Sie die HTTP-Antwortheader in einem Node.js-basierten Webserver mit Express konfigurieren, um den HTTP-Cache optimal zu nutzen. Außerdem haben Sie die Schritte, die Sie benötigen, um zu bestätigen, dass das erwartete Caching-Verhalten verwendet wird, über den Netzwerkbereich in den DevTools von Chrome.