PerformanceNavigationTiming: redirectCount 属性

Baseline 已广泛支持

此功能已成熟,并且适用于多种设备和浏览器版本。自 2021 年 10 月以来,它已在所有浏览器中可用。

只读属性 redirectCount 返回一个数字,表示当前浏览上下文中,自上一次非重定向导航以来发生的重定向次数。

页面上的重定向次数越多,页面加载时间就越长。为了提高网页的性能,请避免多次重定向。

可以使用 redirectStartredirectEnd 属性来衡量重定向时间。请注意,对于跨域重定向,它们将返回 0

请注意,客户端重定向,例如 <meta http-equiv="refresh" content="0; url=https://example.com/"> 不在此范围内。

redirectCount 属性可以具有以下值

  • 一个数字,表示当前浏览上下文中,自上一次非重定向导航以来发生的重定向次数。
  • 如果重定向是跨域的,则为 0

示例

记录带有重定向的条目

redirectCount 属性可用于检查是否存在一个或多个重定向。如果条目名称和重定向时间可用,我们将记录它们。

使用 PerformanceObserver 的示例,它会在浏览器性能时间线中记录新的 navigation 性能条目时通知您。使用 buffered 选项可以访问观察者创建之前的条目。

js
const observer = new PerformanceObserver((list) => {
  list.getEntries().forEach((entry) => {
    const name = entry.name;
    const redirectCount = entry.redirectCount;
    const redirectTime = entry.redirectEnd - entry.redirectStart;
    if (redirectCount > 0) {
      console.log(`${name}: Redirect count: ${redirectCount}`);
      if (redirectTime > 0) {
        console.log(`${name}: Redirect time: ${redirectTime}ms`);
      }
    }
  });
});

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

使用 Performance.getEntriesByType() 的示例,它仅显示在调用方法时浏览器性能时间线中存在的 navigation 性能条目。

js
const entries = performance.getEntriesByType("navigation");
entries.forEach((entry) => {
  const name = entry.name;
  const redirectCount = entry.redirectCount;
  const redirectTime = entry.redirectEnd - entry.redirectStart;
  if (redirectCount > 0) {
    console.log(`${name}: Redirect count: ${redirectCount}`);
    if (redirectTime > 0) {
      console.log(`${name}: Redirect time: ${redirectTime}ms`);
    }
  }
});

规范

规范
导航计时 Level 2
# dom-performancenavigationtiming-redirectcount

浏览器兼容性

另见