SerialPort: phương thức open()
Limited availability
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.
Phương thức open() của giao diện SerialPort trả về một Promise phân giải khi cổng được mở. Mặc định cổng được mở với 8 bit dữ liệu, 1 bit dừng và không kiểm tra chẵn lẻ. Tham số baudRate là bắt buộc.
Cú pháp
open(options)
Tham số
options-
Một đối tượng với bất kỳ giá trị nào sau đây:
baudRate-
Một giá trị dương, khác không cho biết tốc độ baud mà giao tiếp nối tiếp nên được thiết lập.
bufferSizeOptional-
Một số nguyên dài không dấu cho biết kích thước của bộ đệm đọc và ghi cần được thiết lập. Nếu không được truyền, mặc định là 255.
dataBitsOptional-
Một giá trị số nguyên là 7 hoặc 8 cho biết số bit dữ liệu mỗi khung. Nếu không được truyền, mặc định là 8.
flowControlOptional-
Loại kiểm soát luồng, có thể là
"none"hoặc"hardware". Giá trị mặc định là"none". parityOptional-
Chế độ chẵn lẻ, có thể là
"none","even", hoặc"odd". Giá trị mặc định là"none". stopBitsOptional-
Một giá trị số nguyên là 1 hoặc 2 cho biết số bit dừng ở cuối khung. Nếu không được truyền, mặc định là 1.
Giá trị trả về
Một Promise.
Ngoại lệ
InvalidStateErrorDOMException-
Trả về nếu cổng đã mở.
NetworkErrorDOMException-
Trả về nếu nỗ lực mở cổng thất bại.
Ví dụ
Trước khi giao tiếp trên một cổng nối tiếp, cổng đó phải được mở. Mở cổng cho phép trang web chỉ định các tham số cần thiết kiểm soát cách dữ liệu được truyền và nhận. Nhà phát triển nên kiểm tra tài liệu của thiết bị đang kết nối để biết các tham số phù hợp.
await port.open({ baudRate: 9600 /* pick your baud rate */ });
Thông số kỹ thuật
| Specification |
|---|
| Web Serial API # dom-serialport-open |