Convert WebUSB article from WebFu #4095
Conversation
Alex Recommends ReportAlex recommends the following language changes, but Alex is a regular expression based algorithm, so take them with a grain of salt. ✨ 🚀 ✨ Nothing to Report ✨ 🚀 ✨ |
|
Deploy preview for web-dev-staging ready! Built with commit 0df7bd7 |
| - api | ||
| --- | ||
|
|
||
| If I said plain and simple "USB", there is a good chance that you will |
There was a problem hiding this comment.
This should be either:
If I said plainly and simply "USB"...
or
If I said "plain and simple USB"...
I think the first is closer to what you're after.
| --- | ||
|
|
||
| If I said plain and simple "USB", there is a good chance that you will | ||
| immediately think of keyboards, mice, audio, video and storage devices. You're |
There was a problem hiding this comment.
| immediately think of keyboards, mice, audio, video and storage devices. You're | |
| immediately think of keyboards, mice, audio, video, and storage devices. You're |
| But most importantly this will **make USB safer and easier to use by bringing | ||
| it to the Web**. | ||
|
|
||
| Let's see what you could expect with the WebUSB API: |
There was a problem hiding this comment.
| Let's see what you could expect with the WebUSB API: | |
| Let's see the behavior you could expect with the WebUSB API: |
There was a problem hiding this comment.
The language is a little more specific.
| 2. Plug it into your computer. | ||
| 3. A notification appears right away, with the right website to go to for this |
There was a problem hiding this comment.
| 2. Plug it into your computer. | |
| 3. A notification appears right away, with the right website to go to for this | |
| 2. Plug it into your computer. A notification appears right away, with the right website to go to for this |
There was a problem hiding this comment.
A best practice is that the steps always begin with the user action. Responses of a system are tacked to the end of the steps that initiated them.
| 2. Plug it into your computer. | ||
| 3. A notification appears right away, with the right website to go to for this | ||
| device. | ||
| 4. Simply click on it. Website is there and ready to use! |
There was a problem hiding this comment.
| 4. Simply click on it. Website is there and ready to use! | |
| 4. Click the notification. The website is there and ready to use! |
|
|
||
| ## Tips | ||
|
|
||
| Debugging USB in Chrome is easier with the internal page `chrome://device-log` |
There was a problem hiding this comment.
Is the information on the Chrome pages up to date?
| </figure> | ||
|
|
||
| The internal page `chrome://usb-internals` also comes in handy and allows you | ||
| to simulate connection connection and disconnection of virtual WebUSB devices. |
There was a problem hiding this comment.
| to simulate connection connection and disconnection of virtual WebUSB devices. | |
| to simulate connection connection and disconnection of virtual WebUSB devices. |
| to simulate connection connection and disconnection of virtual WebUSB devices. | |
| to simulate connection and disconnection of virtual WebUSB devices. |
|
|
||
| The internal page `chrome://usb-internals` also comes in handy and allows you | ||
| to simulate connection connection and disconnection of virtual WebUSB devices. | ||
| This is be useful for doing UI testing without the need for real hardware. |
There was a problem hiding this comment.
| This is be useful for doing UI testing without the need for real hardware. | |
| This is be useful for doing UI testing without real hardware. |
|
|
||
| where `[yourdevicevendor]` is `2341` if your device is an Arduino for instance. | ||
| `ATTR{idProduct}` can also be added for a more specific rule. Make sure your | ||
| `user` is a member of the `plugdev` group. Then, just reconnect your device. |
There was a problem hiding this comment.
What's the plugdev group? How do I make sure I'm a member of it? Links will be fine.
There was a problem hiding this comment.
I've added a link that includes both answers.
| `ATTR{idProduct}` can also be added for a more specific rule. Make sure your | ||
| `user` is a member of the `plugdev` group. Then, just reconnect your device. | ||
|
|
||
| ## What's next |
There was a problem hiding this comment.
Does this section need to be updated? I couldn't find any features for shared or service workers on Chrome Status. I did find this: https://www.chromestatus.com/features/5928209916887040
There was a problem hiding this comment.
Oh I've missed this. You're right.
I've removed this "What's next" section
beaufortfrancois
added
the
content update
This PR is about moving https://developers.google.com/web/updates/2016#access_usb_devices_on_the_web to web.dev/usb
Changes to the original article include:
Live preview at https://deploy-preview-4095--web-dev-staging.netlify.app/usb/