USBDevice.controlTransferOut()
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The controlTransferOut()
method of the USBDevice
interface returns a promise
that resolves with a USBOutTransferResult
when a command or status operation has been transmitted to the USB device.
Syntax
var promise = USBDevice.controlTransferOut(setup, data)
Parameters
- setup
-
An object that sets options for . The available options are:
-
requestType
: Must be one of three values specifying whether the tranfer is"standard"
(common to all USB devices)"class"
(common to an industry-standard class of devices) or"vendor"
. -
recipient
: Specifices the target of the transfer on the device, one of"device"
,"interface"
,"endpoint"
, or"other"
. -
request
: A vendor-specific command. -
value
: Vender-specific request parameters. -
index
: The interface number of the recipient.
-
- data
-
A
TypedArray
containing the data that will be transfered to the device. Not all commands require data; some commands can send data just through the value parameter. Check with your device to see what the specific request requires.
Return value
A promise
that resolves with a USBOutTransferResult
.
Specifications
Specification |
---|
WebUSB API # ref-for-dom-usbdevice-controltransferout① |
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
controlTransferOut |
61 |
79 |
No |
No |
48 |
No |
No |
61 |
No |
45 |
No |
8.0 |
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/USBDevice/controlTransferOut