chrome.devtools.network

Mô tả

Sử dụng API chrome.devtools.network để truy xuất thông tin về các yêu cầu mạng do Công cụ cho nhà phát triển hiển thị trong bảng điều khiển Mạng.

Thông tin về các yêu cầu mạng được biểu thị ở định dạng Lưu trữ HTTP (HAR). Phần mô tả về HAR nằm ngoài phạm vi của tài liệu này. Hãy tham khảo Quy cách HAR v1.2.

Theo HAR, phương thức chrome.devtools.network.getHAR() trả về toàn bộ nhật ký HAR, trong khi chrome.devtools.network.onRequestFinished sự kiện cung cấp mục nhập HAR làm đối số cho lệnh gọi lại sự kiện.

Xin lưu ý rằng nội dung yêu cầu không được cung cấp trong HAR vì lý do hiệu quả. Bạn có thể gọi phương thức getContent() của yêu cầu để truy xuất nội dung.

Nếu cửa sổ Công cụ cho nhà phát triển được mở sau khi trang được tải, thì một số yêu cầu có thể bị thiếu trong mảng các mục nhập do getHAR() trả về. Hãy tải lại trang để nhận tất cả yêu cầu. Nhìn chung, danh sách các yêu cầu do getHAR() trả về phải khớp với danh sách hiển thị trong bảng điều khiển Mạng.

Xem phần Tóm tắt API DevTools để biết thông tin tổng quan về cách sử dụng API Công cụ cho nhà phát triển.

Tệp kê khai

Bạn phải khai báo các khoá sau trong tệp kê khai để sử dụng API này.

"devtools_page"

Ví dụ

Đoạn mã sau đây ghi lại URL của tất cả hình ảnh lớn hơn 40 KB khi chúng được tải:

chrome.devtools.network.onRequestFinished.addListener(
  function(request) {
    if (request.response.bodySize > 40*1024) {
      chrome.devtools.inspectedWindow.eval(
          'console.log("Large image: " + unescape("' +
          escape(request.request.url) + '"))');
    }
  }
);

Để dùng thử API này, hãy cài đặt các ví dụ về API devtools từ kho lưu trữ chrome-extension-samples.

Loại

Request

Biểu thị một yêu cầu mạng đối với tài nguyên tài liệu (tập lệnh, hình ảnh, v.v.). Hãy xem Quy cách HAR để tham khảo.

Thuộc tính

  • getContent

    void

    Trả về nội dung của phần nội dung phản hồi.

    Hàm getContent có dạng như sau: 

    () => {...}

    • returns

      Promise<object>

      Đang chờ xử lý

      Một hàm nhận phần nội dung phản hồi khi yêu cầu hoàn tất.

Phương thức

getHAR()

chrome.devtools.network.getHAR(): Promise<object>

Trả về nhật ký HAR chứa tất cả các yêu cầu mạng đã biết.

Giá trị trả về

  • Promise<object>

    Đang chờ xử lý

    Một hàm nhận nhật ký HAR khi yêu cầu hoàn tất.

Sự kiện

onNavigated

chrome.devtools.network.onNavigated.addListener(
  callback: function,
)

Được kích hoạt khi cửa sổ được kiểm tra chuyển đến một trang mới.

Thông số

  • callback

    hàm

    Tham số callback có dạng như sau: 

    (url: string) => void

    • url

      chuỗi

onRequestFinished

chrome.devtools.network.onRequestFinished.addListener(
  callback: function,
)

Được kích hoạt khi một yêu cầu mạng hoàn tất và tất cả dữ liệu yêu cầu đều có sẵn.

Thông số

  • callback

    hàm

    Tham số callback có dạng như sau: 

    (request: Request) => void