PerformanceResourceTiming: transferSize-Eigenschaft

Die transferSize-Eigenschaft kann die folgenden Werte haben:

• Eine Zahl, die die Größe (in Oktetten) der abgerufenen Ressource darstellt. Die Größe beinhaltet die Antwort-Header-Felder plus den Antwort-Nutzlastkörper (RFC7230).
• 0, wenn die Ressource augenblicklich aus einem Cache abgerufen wurde.
• 0, wenn die Ressource eine Cross-Origin-Anfrage ist und kein Timing-Allow-Origin HTTP-Antwort-Header verwendet wird.

Für Umgebungen, die die responseStatus-Eigenschaft nicht unterstützen, kann die transferSize-Eigenschaft verwendet werden, um Cache-Treffer zu bestimmen. Wenn transferSize null ist und die Ressource eine nicht-null dekodierte Körpergröße hat (bedeutet, die Ressource ist gleich-origin oder hat Timing-Allow-Origin), wurde die Ressource aus einem lokalen Cache abgerufen.

Beispiel mit einem PerformanceObserver, der über neue resource-Performance-Einträge benachrichtigt, während sie in der Performance-Zeitleiste des Browsers aufgezeichnet werden. Verwenden Sie die Option buffered, um auf Einträge von vor der Erstellungs des Observers zuzugreifen.

const observer = new PerformanceObserver((list) => {
  list.getEntries().forEach((entry) => {
    if (entry.transferSize === 0 && entry.decodedBodySize > 0) {
      console.log(`${entry.name} was loaded from cache`);
    }
  });
});

observer.observe({ type: "resource", buffered: true });

Beispiel mit Performance.getEntriesByType(), welches nur resource-Performance-Einträge zeigt, die sich zum Zeitpunkt des Aufrufs dieser Methode in der Performance-Zeitleiste des Browsers befinden:

const resources = performance.getEntriesByType("resource");
resources.forEach((entry) => {
  if (entry.transferSize === 0 && entry.decodedBodySize > 0) {
    console.log(`${entry.name} was loaded from cache`);
  }
});

Wenn der Wert der transferSize-Eigenschaft 0 ist und nicht aus einem lokalen Cache geladen wurde, könnte die Ressource eine Cross-Origin-Anfrage sein. Um Informationen zur Größe von Cross-Origin-Inhalten offenzulegen, muss der Timing-Allow-Origin HTTP-Antwort-Header gesetzt sein.

Zum Beispiel, um https://developer.mozilla.org die Ansicht von Inhaltsgrößen zu ermöglichen, sollte die Cross-Origin-Ressource senden:

Timing-Allow-Origin: https://developer.mozilla.org

• Timing-Allow-Origin