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
ReportingObservermớ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.
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.
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 là "deprecation".
Thông số kỹ thuật
| Thông số kỹ thuật |
|---|
| Reporting API> # interface-reporting-observer> |