USBDevice

Khả dụng hạn chế

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

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

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

Note: This feature is available in Web Workers.

Giao diện USBDevice của WebUSB API cung cấp quyền truy cập vào siêu dữ liệu về một thiết bị USB đã được ghép nối và các phương thức để điều khiển thiết bị đó.

Thuộc tính phiên bản

USBDevice.configuration Read only Thử nghiệm: Một đối tượng USBConfiguration cho giao diện hiện đang được chọn của thiết bị USB đã ghép nối.
USBDevice.configurations Read only Thử nghiệm: Một array các giao diện dành riêng cho thiết bị để điều khiển thiết bị USB đã ghép nối.
USBDevice.deviceClass Read only Thử nghiệm: Một trong ba thuộc tính dùng để nhận dạng thiết bị USB nhằm mục đích tải trình điều khiển USB phù hợp với thiết bị đó. Hai thuộc tính còn lại là USBDevice.deviceSubclass và USBDevice.deviceProtocol.
USBDevice.deviceProtocol Read only Thử nghiệm: Một trong ba thuộc tính dùng để nhận dạng thiết bị USB nhằm mục đích tải trình điều khiển USB phù hợp với thiết bị đó. Hai thuộc tính còn lại là USBDevice.deviceClass và USBDevice.deviceSubclass.
USBDevice.deviceSubclass Read only Thử nghiệm: Một trong ba thuộc tính dùng để nhận dạng thiết bị USB nhằm mục đích tải trình điều khiển USB phù hợp với thiết bị đó. Hai thuộc tính còn lại là USBDevice.deviceClass và USBDevice.deviceProtocol.
USBDevice.deviceVersionMajor Read only Thử nghiệm: Số phiên bản chính của thiết bị trong sơ đồ phiên bản ngữ nghĩa.
USBDevice.deviceVersionMinor Read only Thử nghiệm: Số phiên bản phụ của thiết bị trong sơ đồ phiên bản ngữ nghĩa.
USBDevice.deviceVersionSubminor Read only Thử nghiệm: Số phiên bản vá của thiết bị trong sơ đồ phiên bản ngữ nghĩa.
USBDevice.manufacturerName Read only Thử nghiệm: Tên của tổ chức đã sản xuất thiết bị USB.
USBDevice.opened Read only Thử nghiệm: Cho biết liệu một phiên làm việc đã được bắt đầu với thiết bị USB đã ghép nối hay chưa.
USBDevice.productId Read only Thử nghiệm: Mã do nhà sản xuất định nghĩa để nhận dạng thiết bị USB.
USBDevice.productName Read only Thử nghiệm: Tên do nhà sản xuất định nghĩa để nhận dạng thiết bị USB.
USBDevice.serialNumber Read only Thử nghiệm: Số sê-ri do nhà sản xuất định nghĩa cho thiết bị USB cụ thể.
USBDevice.usbVersionMajor Read only Thử nghiệm: Một trong ba thuộc tính khai báo phiên bản giao thức USB được thiết bị hỗ trợ. Hai thuộc tính còn lại là USBDevice.usbVersionMinor và USBDevice.usbVersionSubminor.
USBDevice.usbVersionMinor Read only Thử nghiệm: Một trong ba thuộc tính khai báo phiên bản giao thức USB được thiết bị hỗ trợ. Hai thuộc tính còn lại là USBDevice.usbVersionMajor và USBDevice.usbVersionSubminor.
USBDevice.usbVersionSubminor Read only Thử nghiệm: Một trong ba thuộc tính khai báo phiên bản giao thức USB được thiết bị hỗ trợ. Hai thuộc tính còn lại là USBDevice.usbVersionMajor và USBDevice.usbVersionMinor.
USBDevice.vendorId Read only Thử nghiệm: ID nhà cung cấp chính thức do usb.org cấp.

Phương thức phiên bản

USBDevice.claimInterface() Thử nghiệm: Trả về một Promise được giải quyết khi giao diện được yêu cầu được chiếm giữ để truy cập độc quyền.
USBDevice.clearHalt() Thử nghiệm: Trả về một Promise được giải quyết khi điều kiện tạm dừng được xóa.
USBDevice.controlTransferIn() Thử nghiệm: Trả về một Promise được giải quyết với USBInTransferResult khi một lệnh hoặc thao tác trạng thái đã được truyền tới thiết bị USB.
USBDevice.controlTransferOut() Thử nghiệm: Trả về một Promise được giải quyết với USBOutTransferResult khi một lệnh hoặc thao tác trạng thái đã được truyền từ thiết bị USB.
USBDevice.close() Thử nghiệm: Trả về một Promise được giải quyết khi tất cả các giao diện đang mở được giải phóng và phiên làm việc với thiết bị đã kết thúc.
USBDevice.forget() Thử nghiệm: Trả về một Promise được giải quyết sau khi tất cả các giao diện đang mở được giải phóng, phiên làm việc với thiết bị đã kết thúc, và quyền truy cập được đặt lại.
USBDevice.isochronousTransferIn() Thử nghiệm: Trả về một Promise được giải quyết với USBIsochronousInTransferResult khi thông tin nhạy cảm về thời gian đã được truyền tới thiết bị USB.
USBDevice.isochronousTransferOut() Thử nghiệm: Trả về một Promise được giải quyết với USBIsochronousOutTransferResult khi thông tin nhạy cảm về thời gian đã được truyền từ thiết bị USB.
USBDevice.open() Thử nghiệm: Trả về một Promise được giải quyết khi một phiên làm việc với thiết bị đã bắt đầu.
USBDevice.releaseInterface() Thử nghiệm: Trả về một Promise được giải quyết khi giao diện đã chiếm giữ được giải phóng khỏi truy cập độc quyền.
USBDevice.reset() Thử nghiệm: Trả về một Promise được giải quyết khi thiết bị được đặt lại và tất cả các thao tác ứng dụng bị hủy bỏ cùng với các promise của chúng bị từ chối.
USBDevice.selectAlternateInterface() Thử nghiệm: Trả về một Promise được giải quyết khi điểm cuối thay thế được chỉ định được chọn.
USBDevice.selectConfiguration() Thử nghiệm: Trả về một Promise được giải quyết khi cấu hình được chỉ định được chọn.
USBDevice.transferIn() Thử nghiệm: Trả về một Promise được giải quyết với USBInTransferResult khi dữ liệu bulk hoặc ngắt được nhận từ thiết bị USB.
USBDevice.transferOut() Thử nghiệm: Trả về một Promise được giải quyết với USBOutTransferResult khi dữ liệu bulk hoặc ngắt được gửi tới thiết bị USB.

Thông số kỹ thuật

Thông số kỹ thuật
WebUSB API # device-usage

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

Help improve MDN

Tìm hiểu cách đóng góp

Trang này được sửa đổi lần cuối vào 29 tháng 3, 2026 bởi những người đóng góp MDN.

Xem trang này trên GitHub • Báo cáo sự cố với nội dung này