PerformanceResourceTiming: responseStatus property

Note: This feature is available in Web Workers.

The responseStatus read-only property represents the HTTP response status code returned when fetching the resource.

This property maps to Response.status from the Fetch API.

Value

The responseStatus property can have the following values:

Examples

Checking if a cache was hit

The responseStatus property can be used to check for cached resources with a 304 Not Modified response status code.

Example using a PerformanceObserver, which notifies of new resource performance entries as they are recorded in the browser's performance timeline. Use the buffered option to access entries from before the observer creation.

js
const observer = new PerformanceObserver((list) => {
  list.getEntries().forEach((entry) => {
    if (entry.responseStatus === 304) {
      console.log(`${entry.name} was loaded from cache`);
    }
  });
});

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

Example using Performance.getEntriesByType(), which only shows resource performance entries present in the browser's performance timeline at the time you call this method:

js
const resources = performance.getEntriesByType("resource");
resources.forEach((entry) => {
  if (entry.responseStatus === 304) {
    console.log(`${entry.name} was loaded from cache`);
  }
});

Alternatively, if responseStatus is not available, you can check if the transferSize property returned 0.

Cross-origin response status codes

If the value of the responseStatus property is 0, the resource might be a cross-origin request. To allow seeing cross-origin response status codes, the CORS Access-Control-Allow-Origin HTTP response header needs to be set.

For example, to allow https://developer.mozilla.org to see response status codes, the cross-origin resource should send:

http
Access-Control-Allow-Origin: https://developer.mozilla.org

Specifications

Specification
Resource Timing
# dom-performanceresourcetiming-responsestatus

Browser compatibility

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
responseStatus

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

See also