WebDriver BiDi modules

Danh sách module

bluetooth module

bluetooth module chứa các lệnh để tự động hóa tương tác với thiết bị Bluetooth.

browser module

browser module chứa các lệnh để quản lý trình duyệt.

browsingContext module

browsingContext module chứa các lệnh và sự kiện để quản lý các browsing context.

emulation module

emulation module chứa các lệnh để ghi đè hành vi của một số Web API nhất định, chẳng hạn như Geolocation API và Screen Orientation API, nhằm mô phỏng các môi trường khác nhau.

input module

input module chứa các lệnh để mô phỏng các hành động nhập của người dùng.

log module

log module chứa các sự kiện liên quan đến ghi nhật ký.

network module

network module chứa các lệnh và sự kiện liên quan đến các yêu cầu mạng.

permissions module

permissions module chứa các lệnh để quản lý quyền của trình duyệt.

script module

script module chứa các lệnh và sự kiện để thực thi JavaScript và quản lý các script realm trong trình duyệt.

session module

session module chứa các lệnh để quản lý vòng đời và các đăng ký sự kiện của một phiên WebDriver BiDi.

storage module

storage module chứa các lệnh và sự kiện liên quan đến lưu trữ.

userAgentClientHints module

userAgentClientHints module chứa các lệnh để ghi đè user agent client hints.

webExtension module

webExtension module chứa các lệnh để quản lý browser extensions.

Lệnh

Một lệnh là một thao tác bất đồng bộ được gửi từ client tới trình duyệt. Mỗi thông điệp lệnh bạn gửi tới trình duyệt có ba trường:

• id: Một số do bạn gán cho lệnh. Không giống HTTP, nơi mỗi yêu cầu chờ phản hồi, một kết nối WebSocket có thể có nhiều lệnh đang bay cùng lúc và phản hồi có thể đến không theo thứ tự. id cho phép bạn khớp mỗi phản hồi với lệnh đã kích hoạt nó.
• method: Lệnh cần chạy, dưới dạng module_name.command_name.
• params: Một đối tượng chứa mọi thông tin bổ sung mà lệnh cần. Một số lệnh không cần tham số, nhưng vẫn phải gửi một đối tượng params rỗng ({}).

Ví dụ, để tạo một phiên mới, bạn sẽ gửi lệnh session.new như sau:

{
  "id": 1,
  "method": "session.new",
  "params": {}
}

Mỗi lệnh sẽ dẫn đến hoặc một phản hồi thành công chứa trường result, hoặc một phản hồi lỗi chứa trường error. Cấu trúc của result là riêng cho từng lệnh.

Tất cả các lệnh, ngoại trừ session.new và session.status, đều yêu cầu một phiên WebDriver BiDi đang hoạt động.

Sự kiện

Một sự kiện là một thông báo được trình duyệt gửi tới client khi có điều gì đó đáng chú ý xảy ra. Để nhận sự kiện, client trước tiên phải đăng ký chúng bằng lệnh session.subscribe.

Client có thể đăng ký một sự kiện cụ thể hoặc tất cả sự kiện trong một module. Ví dụ, đăng ký "browsingContext.contextCreated" sẽ đăng ký client cho chỉ sự kiện đó, còn đăng ký "browsingContext" sẽ đăng ký client cho mọi sự kiện trong module browsingContext.

Sau đây là một thông điệp sự kiện mẫu được trình duyệt gửi khi client đã đăng ký log.entryAdded và một thông điệp console được ghi lại (một số trường đã được lược bớt để ngắn gọn):

{
  "type": "event",
  "method": "log.entryAdded",
  "params": {
    "type": "console",
    "method": "log",
    "realm": null,
    "level": "info",
    "text": "Hello world",
    "timestamp": 1657282076037
  }
}

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

Xem thêm

• WebDriver BiDi web client