SerialPort: sự kiện connect

Khả dụng hạn chế

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

Note: This feature is available in Dedicated Web Workers.

Sự kiện connect của giao diện SerialPort được kích hoạt khi cổng kết nối với thiết bị.

Mô tả

Cụ thể hơn, sự kiện connect kích hoạt khi cổng trở nên kết nối logic với thiết bị sau khi người dùng cấp quyền cho trang web truy cập cổng sau lệnh gọi Serial.requestPort():

  • Trong trường hợp cổng nối tiếp có dây, điều này xảy ra khi cổng được kết nối vật lý với thiết bị, ví dụ qua USB.
  • Trong trường hợp cổng nối tiếp không dây (ví dụ, Bluetooth RFCOMM), điều này xảy ra khi cổng tạo một hoặc nhiều kết nối đang hoạt động với thiết bị (ví dụ qua các kênh Bluetooth L2CAP).

Nổi bọt sự kiện

Sự kiện này nổi bọt lên thực thể Serial đã trả về giao diện này. Thuộc tính event.target tham chiếu đến đối tượng SerialPort nổi bọt lên.

Để biết thêm thông tin, xem Nổi bọt sự kiện.

Cú pháp

Sử dụng tên sự kiện trong các phương thức như addEventListener(), hoặc đặt thuộc tính trình xử lý sự kiện.

js
addEventListener("connect", (event) => { })

onconnect = (event) => { }

Kiểu sự kiện

Một Event chung.

Ví dụ

Thông báo khi một cổng cụ thể kết nối

Phương thức Serial.requestPort() trả về một Promise phân giải với một SerialPort được người dùng chọn.

js
// Prompt user to choose a serial port
const port = await navigator.serial.requestPort();

port.addEventListener("connect", (event) => {
  // notify that the chosen port is connected
});

Lắng nghe bất kỳ cổng nào vừa kết nối

Sự kiện connect nổi bọt lên đối tượng Serial nơi bạn có thể lắng nghe bất kỳ cổng nào vừa kết nối.

js
navigator.serial.addEventListener("connect", (event) => {
  // notify that a new port is available
  // use `event.target` to refer to the newly-added port
});

Thông số kỹ thuật

Thông số kỹ thuật
Web Serial API
# dfn-connect
Web Serial API
# dom-serialport-onconnect

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

Xem thêm