PerformanceResourceTiming: nextHopProtocol-Eigenschaft

Wert

Die nextHopProtocol-Eigenschaft kann die folgenden Werte haben:

• Ein String, der das Netzwerkprotokoll repräsentiert, das zum Abrufen der Ressource verwendet wird, wie durch die ALPN-Protokoll-ID (RFC7301) identifiziert. Typische Werte sind:
  • "http/0.9"
  • "http/1.0"
  • "http/1.1"
  • "h2"
  • "h2c"
  • "h3"
• Ein leerer String, wenn die Ressource eine Cross-Origin-Anfrage ist und kein Timing-Allow-Origin-HTTP-Antwort-Header verwendet wird.

Beispiele

Protokollieren von Ressourcen, die weder HTTP/2 noch HTTP/3 verwenden

Die nextHopProtocol-Eigenschaft kann verwendet werden, um Ressourcen anzuzeigen, die nicht die Protokolle HTTP/2 oder HTTP/3 verwenden.

Beispiel mit einem PerformanceObserver, der über neue resource-Performance-Einträge informiert, sobald diese in der Performance-Zeitleiste des Browsers aufgezeichnet werden. Verwenden Sie die Option buffered, um auf Einträge vor der Erstellung des Observers zuzugreifen.

const observer = new PerformanceObserver((list) => {
  list.getEntries().forEach((entry) => {
    const protocol = entry.nextHopProtocol;
    if (protocol && !(protocol === "h2" || protocol === "h3")) {
      console.log(`${entry.name} uses ${protocol}.`);
    }
  });
});

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

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

const resources = performance.getEntriesByType("resource");
resources.forEach((entry) => {
  const protocol = entry.nextHopProtocol;
  if (protocol && !(protocol === "h2" || protocol === "h3")) {
    console.log(`${entry.name} uses ${protocol}.`);
  }
});

Cross-Origin-Netzwerkprotokollinformationen

Wenn der Wert der nextHopProtocol-Eigenschaft ein leerer String ist, könnte die Ressource eine Cross-Origin-Anfrage sein. Um Cross-Origin-Netzwerkprotokollinformationen bereitzustellen, muss der Timing-Allow-Origin-HTTP-Antwort-Header gesetzt werden.

Um beispielsweise https://developer.mozilla.org das Anzeigen von Netzwerkprotokollinformationen zu erlauben, sollte die Cross-Origin-Ressource Folgendes senden:

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

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Timing-Allow-Origin
• HTTP/2
• HTTP/3