PerformanceResourceTiming: responseStatus property
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
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:
- A number indicating the HTTP response status code returned when fetching the resource.
0if the CORS check fails.0for cross-origin<iframe>objects.
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
BCD tables only load in the browser