chrome.devtools.network

Nội dung 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ề yêu cầu mạng được trình bày ở định dạng Lưu trữ HTTP (HAR). Nội dung mô tả về HAR nằm ngoài phạm vi của tài liệu này, hãy tham khảo Thông số kỹ thuật HAR v1.2.

Đối với HAR, phương thức chrome.devtools.network.getHAR() sẽ trả về toàn bộ nhật ký HAR, trong khi sự kiện chrome.devtools.network.onRequestFinished cung cấp mục 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 tính 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 mở sau khi tải trang, thì một số yêu cầu có thể bị thiếu trong mảng 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 thông tin tóm tắt về API DevTools để biết giới thiệu chung 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ụ

Các đoạn mã sau đây ghi lại URL của tất cả hình ảnh lớn hơn 40KB khi 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 cho nhà phát triển trong kho lưu trữ chrome-extension-samples.

Loại

Request

Đại diện cho một yêu cầu mạng của một tài nguyên tài liệu (tập lệnh, hình ảnh, v.v.). Xem thông số kỹ thuật HAR để tham khảo.

Thuộc tính

• getContent

  void

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

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

  (callback: function)=> {...}

  • số gọi lại

    hàm

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

    (content: string,encoding: string)=>void

    • những nội dung

      string

      Nội dung của nội dung phản hồi (có thể được mã hoá).

    • mã hoá

      string

      Để trống nếu nội dung không được mã hoá, hãy mã hoá tên. Hiện tại, chúng tôi chỉ hỗ trợ base64.

Phương thức

getHAR()

chrome.devtools.network.getHAR(
  callback: function,
)

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

Tham số

• số gọi lại

  hàm

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

  (harLog: object)=>void

  • harLog

    đối tượng

    Nhật ký HAR. Xem thông số kỹ thuật của HAR để biết chi tiết.

Sự kiện

onNavigated

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

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

Tham số

• số gọi lại

  hàm

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

  (url: string)=>void

  • url

    string

onRequestFinished

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

Được kích hoạt khi 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.

Tham số

• số gọi lại

  hàm

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

  (request: Request)=>void

  • request

    Yêu cầu