Chrome 64 เพื่อเลิกใช้งาน chrome.loadTimes() API

Philip Walton

chrome.loadTimes() เป็น API ที่ไม่เป็นไปตามมาตรฐานซึ่งแสดงเมตริกการโหลดและข้อมูลเครือข่ายแก่นักพัฒนาซอฟต์แวร์เพื่อช่วยให้เข้าใจในประสิทธิภาพของเว็บไซต์ในโลกแห่งความเป็นจริงได้ดียิ่งขึ้น

ตั้งแต่มีการใช้ API นี้ในปี 2009 ข้อมูลทั้งหมดที่เป็นประโยชน์ซึ่ง API รายงานจะอยู่ใน API มาตรฐาน เช่น

• ระยะเวลาในการนําทาง 2
• ช่วงเวลาการทาสี
• nextHopProtocol เพิ่มลงใน Navigation Timing 2 และ Resource Timing 2

ผู้ให้บริการเบราว์เซอร์หลายรายใช้ API มาตรฐานเหล่านี้ ด้วยเหตุนี้ เราจึงเลิกใช้งาน chrome.loadTimes() ใน Chrome 64

API ที่เลิกใช้งานแล้ว

ฟังก์ชัน chrome.loadTimes() จะแสดงผลออบเจ็กต์เดียวที่มีข้อมูลการโหลดและเครือข่ายทั้งหมด ตัวอย่างเช่น ออบเจ็กต์ต่อไปนี้คือผลลัพธ์ของการเรียกใช้ chrome.loadTimes() ใน www.google.com

{
  "requestTime": 1513186741.847,
  "startLoadTime": 1513186741.847,
  "commitLoadTime": 1513186742.637,
  "finishDocumentLoadTime": 1513186742.842,
  "finishLoadTime": 1513186743.582,
  "firstPaintTime": 1513186742.829,
  "firstPaintAfterLoadTime": 0,
  "navigationType": "Reload",
  "wasFetchedViaSpdy": true,
  "wasNpnNegotiated": true,
  "npnNegotiatedProtocol": "h2",
  "wasAlternateProtocolAvailable": false,
  "connectionInfo": "h2"
}

การเปลี่ยนแทนแบบมาตรฐาน

ตอนนี้คุณดูค่าแต่ละค่าข้างต้นได้โดยใช้ API มาตรฐาน ตารางต่อไปนี้จับคู่แต่ละค่ากับ API แบบมาตรฐาน และส่วนด้านล่างจะแสดงตัวอย่างโค้ดสำหรับวิธีหาค่าแต่ละค่าใน API เก่าที่มีค่าเทียบเท่าปัจจุบัน

ตัวอย่างโค้ดด้านล่างจะแสดงค่าที่เทียบเท่ากับค่าที่ chrome.loadTimes() แสดงผล อย่างไรก็ตาม เราไม่แนะนําให้ใช้ตัวอย่างโค้ดเหล่านี้กับโค้ดใหม่ สาเหตุคือ chrome.loadTimes() ให้ค่าเวลาเป็นเวลาตามยุคเป็นวินาที ส่วน Performance API ใหม่มักจะรายงานค่าเป็นมิลลิวินาทีโดยสัมพันธ์กับต้นทางเวลาของหน้าเว็บ ซึ่งมักจะมีประโยชน์สําหรับการวิเคราะห์ประสิทธิภาพมากกว่า

ตัวอย่างหลายรายการยังรองรับ API Performance Timeline 2 ด้วย (เช่น performance.getEntriesByType()) แต่ก็มีทางเลือกสําหรับ API Navigation Timing 1 ที่เก่ากว่าเนื่องจากรองรับเบราว์เซอร์ได้กว้างกว่า นับจากนี้ไป Performanceไทม์ไลน์ API จะเป็นที่ต้องการมากกว่า และมักจะรายงานด้วยความแม่นยำสูงกว่า

requestTime

function requestTime() {
  // If the browser supports the Navigation Timing 2 and HR Time APIs, use
  // them, otherwise fall back to the Navigation Timing 1 API.
  if (window.PerformanceNavigationTiming && performance.timeOrigin) {
    const ntEntry = performance.getEntriesByType('navigation')[0];
    return (ntEntry.startTime + performance.timeOrigin) / 1000;
  } else {
    return performance.timing.navigationStart / 1000;
  }
}

startLoadTime

function startLoadTime() {
  // If the browser supports the Navigation Timing 2 and HR Time APIs, use
  // them, otherwise fall back to the Navigation Timing 1 API.
  if (window.PerformanceNavigationTiming && performance.timeOrigin) {
    const ntEntry = performance.getEntriesByType('navigation')[0];
    return (ntEntry.startTime + performance.timeOrigin) / 1000;
  } else {
    return performance.timing.navigationStart / 1000;
  }
}

commitLoadTime

function commitLoadTime() {
  // If the browser supports the Navigation Timing 2 and HR Time APIs, use
  // them, otherwise fall back to the Navigation Timing 1 API.
  if (window.PerformanceNavigationTiming && performance.timeOrigin) {
    const ntEntry = performance.getEntriesByType('navigation')[0];
    return (ntEntry.responseStart + performance.timeOrigin) / 1000;
  } else {
    return performance.timing.responseStart / 1000;
  }
}

finishDocumentLoadTime

function finishDocumentLoadTime() {
  // If the browser supports the Navigation Timing 2 and HR Time APIs, use
  // them, otherwise fall back to the Navigation Timing 1 API.
  if (window.PerformanceNavigationTiming && performance.timeOrigin) {
    const ntEntry = performance.getEntriesByType('navigation')[0];
    return (ntEntry.domContentLoadedEventEnd + performance.timeOrigin) / 1000;
  } else {
    return performance.timing.domContentLoadedEventEnd / 1000;
  }
}

finishLoadTime

function finishLoadTime() {
  // If the browser supports the Navigation Timing 2 and HR Time APIs, use
  // them, otherwise fall back to the Navigation Timing 1 API.
  if (window.PerformanceNavigationTiming && performance.timeOrigin) {
    const ntEntry = performance.getEntriesByType('navigation')[0];
    return (ntEntry.loadEventEnd + performance.timeOrigin) / 1000;
  } else {
    return performance.timing.loadEventEnd / 1000;
  }
}

firstPaintTime

function firstPaintTime() {
  if (window.PerformancePaintTiming) {
    const fpEntry = performance.getEntriesByType('paint')[0];
    return (fpEntry.startTime + performance.timeOrigin) / 1000;
  }
}

firstPaintAfterLoadTime

function firstPaintTimeAfterLoad() {
  // This was never actually implemented and always returns 0.
  return 0;
}

navigationType

function navigationType() {
  if (window.PerformanceNavigationTiming) {
    const ntEntry = performance.getEntriesByType('navigation')[0];
    return ntEntry.type;
  }
}

wasFetchedViaSpdy

function wasFetchedViaSpdy() {
  // SPDY is deprecated in favor of HTTP/2, but this implementation returns
  // true for HTTP/2 or HTTP2+QUIC/39 as well.
  if (window.PerformanceNavigationTiming) {
    const ntEntry = performance.getEntriesByType('navigation')[0];
    return ['h2', 'hq'].includes(ntEntry.nextHopProtocol);
  }
}

wasNpnNegotiated

function wasNpnNegotiated() {
  // NPN is deprecated in favor of ALPN, but this implementation returns true
  // for HTTP/2 or HTTP2+QUIC/39 requests negotiated via ALPN.
  if (window.PerformanceNavigationTiming) {
    const ntEntry = performance.getEntriesByType('navigation')[0];
    return ['h2', 'hq'].includes(ntEntry.nextHopProtocol);
  }
}

npnNegotiatedProtocol

function npnNegotiatedProtocol() {
  // NPN is deprecated in favor of ALPN, but this implementation returns the
  // HTTP/2 or HTTP2+QUIC/39 requests negotiated via ALPN.
  if (window.PerformanceNavigationTiming) {
    const ntEntry = performance.getEntriesByType('navigation')[0];
    return ['h2', 'hq'].includes(ntEntry.nextHopProtocol) ?
        ntEntry.nextHopProtocol : 'unknown';
  }
}

wasAlternateProtocolAvailable

function wasAlternateProtocolAvailable() {
  // The Alternate-Protocol header is deprecated in favor of Alt-Svc
  // (https://www.mnot.net/blog/2016/03/09/alt-svc), so technically this
  // should always return false.
  return false;
}

connectionInfo

function connectionInfo() {
  if (window.PerformanceNavigationTiming) {
    const ntEntry = performance.getEntriesByType('navigation')[0];
    return ntEntry.nextHopProtocol;
  }
}

แผนการนำออก

เราจะเลิกใช้งาน chrome.loadTimes() API ใน Chrome 64 และคาดว่าจะนำออกในช่วงปลายปี 2018 นักพัฒนาแอปควรย้ายข้อมูลโค้ดโดยเร็วที่สุดเพื่อไม่ให้ข้อมูลสูญหาย

ความตั้งใจที่จะเลิกใช้งาน | เครื่องมือติดตามสถานะ Chrome | ข้อบกพร่องของ Chromium