ReportingObserver

Baseline 2026 *
Newly available

Since March 2026, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

* Some parts of this feature may have varying levels of support.

Note: This feature is available in Web Workers.

Giao diện ReportingObserver của Reporting API cho phép bạn thu thập và truy cập các báo cáo.

Hàm khởi tạo

ReportingObserver()

Tạo một phiên bản đối tượng ReportingObserver mới, có thể được sử dụng để thu thập và truy cập các báo cáo.

Thuộc tính phiên bản

Giao diện này không có thuộc tính nào được định nghĩa trên nó.

Phương thức phiên bản

ReportingObserver.disconnect()

Dừng một reporting observer đã từng bắt đầu quan sát khỏi việc thu thập báo cáo.

ReportingObserver.observe()

Hướng dẫn một reporting observer bắt đầu thu thập báo cáo trong hàng đợi báo cáo của nó.

ReportingObserver.takeRecords()

Trả về danh sách báo cáo hiện tại chứa trong hàng đợi báo cáo của observer, và làm rỗng hàng đợi.

Sự kiện

Giao diện này không có sự kiện nào được kích hoạt trên nó.

Ví dụ

Hiển thị báo cáo lỗi thời

Ví dụ này cho thấy cách quan sát các báo cáo "deprecation" bằng ReportingObserver.

JavaScript

Đầu tiên, chúng ta xây dựng một đối tượng ReportingObserver mới để lắng nghe các báo cáo với kiểu "deprecation", truyền một callback sẽ nhận và ghi lại các báo cáo.

js
const options = {
  types: ["deprecation"],
  buffered: true,
};

const observer = new ReportingObserver((reports, observer) => {
  reports.forEach((report) => {
    // console.log(report);
    log(JSON.stringify(report, null, 2));
  });
}, options);

// Bắt đầu observer
observer.observe();

Sau đó chúng ta gọi đoạn mã sau sử dụng XHR đồng bộ (API đã lỗi thời). Lưu ý rằng điều này được định nghĩa sau observer và nó kích hoạt một lần observer đang chạy.

js
const xhr = new XMLHttpRequest();
xhr.open("GET", "/", false); // false = đồng bộ (đã lỗi thời)
xhr.send();

Kết quả

Trên các trình duyệt hỗ trợ báo cáo lỗi thời, một báo cáo sẽ được hiển thị bên dưới. Lưu ý rằng type"deprecation".

Thông số kỹ thuật

Thông số kỹ thuật
Reporting API
# interface-reporting-observer

Tương thích trình duyệt

Xem thêm