WebUSB API

1. global을 this의 관련 전역 객체로 둡니다.

2. document를 global의 연결된 Document로 하고, 연결된 Document가 없으면 null로 둡니다.

3. storage를 다음과 같이 둡니다:

   1. 연관된 service worker client의 스크립트 실행 환경에 있는 USBPermissionStorage 객체, 만약 global이 ServiceWorkerGlobalScope라면.

   2. 그 외의 경우, 현재 스크립트 실행 환경의 USBPermissionStorage 객체.

4. promise를 새로운 promise로 둡니다.

5. 다음 단계를 병렬로 실행합니다:

   1. 시스템에 연결된 모든 장치 나열을 수행하고, 이 결과를 enumerationResult로 둡니다.

   2. devices를 새로운 빈 Array로 둡니다.

   3. enumerationResult의 각 device에 대해 다음을 수행:

      1. device가 document에 대해 차단 목록(blocklisted)이면, continue합니다.

      2. 이 메서드의 첫 번째 호출이라면 storage로 device의 권한 확인을 수행합니다.

      3. storage.allowedDevices 중에서 device가 allowedDevice.[[devices]]에 존재하는 요소를 탐색하고, 없다면 다음 device로 넘어갑니다.

   4. device를 나타내는 USBDevice 객체를 devices에 추가합니다.

   5. 글로벌 작업을 대기열에 추가하여 USB 작업 소스에 global과 함께 promise를 devices로 resolve 하도록 합니다.

6. promise를 반환합니다.

1. 다음 기술(descriptor)에 대한 권한을 요청합니다.

   {
     name: "usb"
     filters: options.filters
     exclusionFilters: options.exclusionFilters
   }
   

   permissionResult를 결과로 나오는 Promise로 둡니다.

2. permissionResult가 result와 함께 이행(fulfillment)될 때 다음 단계를 실행합니다:

   1. result.devices 가 비어 있다면, "NotFoundError" DOMException 을 발생시키고, 이 단계를 중단합니다.

   2. result.devices[0]을 반환합니다.

1. global을 storage의 관련 전역 객체로 둡니다.

2. 각 filter에 대해 options.filters 내에 filter가 유효하지 않은 필터라면, 거부된 promise를 TypeError와 함께 반환합니다.

3. 각 exclusionFilter에 대해 options.exclusionFilters 내에 exclusionFilter가 유효하지 않은 필터라면, 거부된 promise를 TypeError와 함께 반환합니다.

4. 이 알고리즘이 global에 일시적 활성화(transient activation) 상태에서 트리거됐는지 확인합니다. 아니라면, 거부된 promise를 "SecurityError" DOMException과 함께 반환합니다.

5. promise를 새로운 promise로 둡니다.

6. 다음 단계를 병렬로 실행합니다.

   1. 시스템에 연결된 모든 장치 나열을 수행하고, 결과를 enumerationResult로 둡니다.

   2. document에 대해 차단 목록에 포함된 장치는 enumerationResult에서 제거합니다.

   3. options.filters 중 어느 필터에도 일치하지 않는 장치는 enumerationResult에서 제거합니다.

   4. options.exclusionFilters 중 어느 필터에 일치하는 장치는 enumerationResult에서 제거합니다.

   5. 사용자에게 enumerationResult에서 장치를 선택하라는 안내 프롬프트를 표시합니다. UA는 각 장치의 사람이 알아볼 수 있는 이름을 표시해야 합니다.

   6. 사용자가 device를 선택하거나 프롬프트를 취소할 때까지 대기합니다.

   7. 글로벌 작업을 대기열에 USB 작업 소스 global에 추가하여 다음 단계를 실행:

      1. status.state 값을 "ask"로 설정합니다.

      2. 사용자가 프롬프트를 취소했다면 status.devices 를 빈 FrozenArray로 하고, resolve promise with undefined하여 이 단계를 중단합니다.

      3. device를 storage에 추가합니다.

      4. deviceObj를 device를 나타내는 USBDevice 객체로 둡니다.

      5. status.devices 값을 deviceObj 하나만 들어있는 새로운 FrozenArray로 설정합니다.

      6. resolve promise with undefined합니다.

7. promise를 반환합니다.

1. 연결된 장치의 deviceDescriptor를 device descriptor로 두되, Get Descriptor를 수행하여 DescriptorType을 DEVICE로 설정합니다.

2. deviceDescriptor를 반환합니다.

1. deviceDescriptor를 연결된 USB 장치의 디바이스 디스크립터를 찾는 결과로 둡니다.

2. numConfigurations를 deviceDescriptor의 bNumConfigurations로 둡니다.

3. configurationIndex를 0으로 둡니다.

4. configurationDescriptors를 빈 리스트로 둡니다.

5. 만약 configurationIndex가 numConfigurations보다 작을 동안:

   1. Get Descriptor를 DescriptorType=CONFIGURATION, DescriptorIndex=configurationIndex로 수행하여 descriptors를 얻습니다.

   2. 만약 descriptors[0]의 bDescriptorType이 CONFIGURATION와 같다면, descriptors[0]을 configurationDescriptors에 추가합니다.

   3. configurationIndex를 1씩 증가시킵니다.

6. configurationDescriptors를 반환합니다.

1. global를 interface의 관련 전역 객체로 둡니다.

2. configuration를 interface.[[configuration]]로 둡니다.

3. device를 configuration.[[device]]로 둡니다.

4. 만약 configuration이 device로 현재 구성을 찾은 결과와 같지 않다면, 반환합니다.

5. 만약 인터페이스가 클레임되었는지 찾은 결과가 true가 아니라면, 반환합니다.

6. currAlternateInterface를 현재 대체 설정에 대한 대체 인터페이스를 찾은 결과로 둡니다.

7. 각 endpoint에 대해 currAlternateInterface.[[endpoints]]에 대해:

   1. endpoint에 현재 스케줄된 모든 전송을 중단합니다.

   2. 관련된 프로미스들을 거부하기 위해 주어진 global에 대한 USB 작업 소스에서 전역 태스크를 큐에 추가하고, 연관된 프로미스들을 "AbortError" AbortError DOMException로 거부합니다.

1. interfaceIndex를 0으로 둡니다.

2. interfaceIndex가 configuration.[[interfaces]]의 크기보다 작을 동안:

   1. 만약 configuration.[[interfaces]][interfaceIndex].[[interfaceNumber]]가 interfaceNumber와 같다면, interfaceIndex를 반환합니다.

   2. interfaceIndex를 1 증가시킵니다.

3. -1를 반환합니다.

1. alternateIndex를 0으로 둡니다.

2. alternateIndex가 interface.[[alternates]]의 크기보다 작을 동안:

   1. 만약 interface.[[alternates]][alternateIndex].[[alternateSetting]]가 alternateSetting와 같다면, alternateIndex를 반환합니다.

   2. alternateIndex를 1 증가시킵니다.

3. -1를 반환합니다.

1. 각 configuration에 대해 device.[[configurations]]를 반복합니다:

   1. 만약 configuration.[[configurationValue]]가 device.[[configurationValue]]와 같다면, configuration를 반환합니다.

2. null을 반환합니다.

1. configuration를 device로 현재 구성을 찾은 결과로 둡니다.

2. 만약 configuration가 null이면, null을 반환합니다.

3. 각 interface에 대해 configuration.[[interfaces]]를 반복합니다:

   1. 만약 인터페이스가 클레임되었는지 찾은 결과가 true가 아니라면, 계속합니다.

   2. alternate를 현재 대체 설정에 대한 대체 인터페이스를 찾은 결과로 둡니다.

   3. 각 endpoint에 대해 alternate.[[endpoints]]를 반복합니다:

      1. 만약 endpoint.[[endpointAddress]]가 endpointAddress와 같다면, endpoint를 반환합니다.

4. null을 반환합니다.

1. 만약 device가 더 이상 시스템에 연결되어 있지 않다면, "NotFoundError" DOMException으로 거부된 프로미스를 반환합니다.

2. 만약 device.opened가 true가 아니라면, "InvalidStateError" DOMException로 거부된 프로미스를 반환합니다.

3. 만약 device.[[configurationValue]]가 0과 같다면, "InvalidStateError" DOMException로 거부된 프로미스를 반환합니다.

4. undefined를 반환합니다.

1. this.[[configurationValue]]를 Get Configuration의 반환값으로 설정합니다.

2. configurationDescriptors를 연결된 USB 장치에 대한 구성 디스크립터 목록을 찾은 결과로 둡니다.

3. 각 configurationDescriptor에 대해 다음을 수행합니다:

   1. configuration를 새로운 USBConfiguration 객체로 만들되, USBConfiguration(device,configurationValue)를 사용하고, device를 this로, configurationValue를 configurationDescriptor의 bConfigurationValue로 설정합니다.

   2. Append configuration를 this.[[configurations]]에 추가합니다.

   3. 만약 configurationDescriptor의 bConfigurationValue가 this.[[configurationValue]]와 같다면:

      1. numInterfaces를 configuration.[[interfaces]]의 크기로 둡니다.

      2. this.[[selectedAlternateSetting]]의 크기를 numInterfaces로 조정합니다.

      3. this.[[selectedAlternateSetting]]를 0으로 채웁니다.

      4. this.[[claimedInterface]]의 크기를 numInterfaces로 조정합니다.

      5. this.[[claimedInterface]]를 false로 채웁니다.

1. global를 this의 관련 전역 객체로 둡니다.

2. 만약 this가 더 이상 시스템에 연결되어 있지 않다면, "NotFoundError" DOMException으로 거부된 프로미스를 반환합니다.

3. 만약 this.opened가 true이면 undefined로 해결된 프로미스를 반환합니다.

4. 다음 단계를 병렬로 실행합니다.

   1. 장치와의 세션을 시작하기 위한 플랫폼 특유의 필요한 단계를 수행합니다.

   2. USB 작업 소스에 대하여 global에 대한 전역 태스크를 큐에 추가하여 다음 단계를 실행합니다:

      1. 만약 위 플랫폼 단계가 실패하면 reject하여 promise를 "NetworkError" DOMException로 거부하고 이 단계를 중단합니다.

      2. this.opened를 true로 설정합니다.

      3. Resolve하여 promise를 undefined로 해결합니다.

5. promise를 반환합니다.

1. global를 this의 관련 전역 객체로 둡니다.

2. 만약 this가 더 이상 시스템에 연결되어 있지 않다면, "NotFoundError" DOMException으로 거부된 프로미스를 반환합니다.

3. 만약 this.opened가 false이면 undefined로 해결된 프로미스를 반환합니다.

4. 이 장치에 대해 현재 실행 중인 다른 모든 알고리즘을 중단하고 관련 프로미스들을 "AbortError" DOMException으로 reject합니다.

5. 다음 단계를 병렬로 실행합니다.

   1. 각 클레임된 인터페이스에 대해 releaseInterface(interfaceNumber)가 호출된 것처럼 플랫폼 특유의 필요한 단계를 수행하여 모든 클레임된 인터페이스를 해제합니다.

   2. 장치와의 세션을 종료하기 위한 플랫폼 특유의 필요한 단계를 수행합니다.

   3. USB 작업 소스에 대하여 global에 대한 전역 태스크를 큐에 추가하여 다음 단계를 실행합니다:

      1. this.opened를 false로 설정합니다.

      2. Resolve하여 promise를 undefined로 해결합니다.

6. promise를 반환합니다.

참고: 더 이상 어떤 [ECMAScript] 코드도 USBDevice device 인스턴스를 관찰할 수 없게 되면, UA는 device.close()를 실행할 것을 권장합니다.

1. device를 this로 둡니다.

2. storage를 현재 스크립트 실행 환경의 USBPermissionStorage 객체로 둡니다.

3. Remove device from storage를 storage로 실행합니다.

4. undefined로 해결된 프로미스를 반환합니다.

참고: 사용자 에이전트는 예를 들어 WebHID와 WebUSB 장치 접근을 통합된 저레벨 장치 접근 권한으로 추적하는 등 API 간 권한을 결합하도록 결정할 수 있습니다. 이 때문에 이 메서드는 향후 추가적인(아직 명시되지 않은) 권한도 취소할 수 있습니다.

1. global를 this의 관련 전역 객체로 둡니다.

2. 만약 this가 더 이상 시스템에 연결되어 있지 않다면, "NotFoundError" DOMException으로 거부된 프로미스를 반환합니다.

3. selectedConfiguration를 null로 둡니다.

4. this.[[configurations]]의 각 configuration에 대해 반복하며:

   1. 만약 configuration.[[configurationValue]]가 configurationValue와 같다면 selectedConfiguration를 configuration으로 설정하고 반복을 중단합니다.

5. 만약 selectedConfiguration가 null이면, "NotFoundError" DOMException으로 거부된 프로미스를 반환합니다.

6. 만약 this.opened가 true가 아니면, "InvalidStateError" DOMException으로 거부된 프로미스를 반환합니다.

7. activeConfiguration를 현재 구성 찾기를 이 this에 대해 실행한 결과로 둡니다.

8. 다음 단계를 병렬로 실행합니다.

   1. 만약 activeConfiguration가 null이 아니라면:

      1. 각 interface에 대해 activeConfiguration.[[interfaces]]를 반복하며, 해당 인터페이스에서 현재 스케줄된 전송을 중단합니다.

   2. SET_CONFIGURATION 제어 전송을 실행하여 configurationValue를 지정된 configurationValue로 설정합니다.

   3. USB 작업 소스에 대하여 global의 전역 태스크를 큐에 추가하여 다음 단계를 실행합니다:

      1. 만약 위의 제어 전송이 실패하면 reject하여 promise를 "NetworkError" DOMException으로 거부하고 이 단계를 중단합니다.

      2. numInterfaces를 selectedConfiguration.[[interfaces]]의 크기로 둡니다.

      3. this.[[selectedAlternateSetting]]의 크기를 numInterfaces로 조정합니다.

      4. [[selectedAlternateSetting]]을 0으로 채웁니다.

      5. [[claimedInterface]]의 크기를 numInterfaces로 조정합니다.

      6. [[claimedInterface]]를 false로 채웁니다.

      7. this.[[configurationValue]]를 configurationValue로 설정합니다.

      8. Resolve하여 promise를 undefined로 해결합니다.

9. promise를 반환합니다.

1. global를 this의 관련 전역 객체로 둡니다.

2. 만약 장치가 구성되어 있는지 확인가 이 this에 대해 Promise를 반환하면, 그 값을 반환합니다.

3. activeConfiguration를 현재 구성 찾기를 이 this에 대해 실행한 결과로 둡니다.

4. interfaces를 activeConfiguration.[[interfaces]]로 둡니다.

5. interfaceIndex를 인터페이스 인덱스 찾기로 구한 값(인수: interfaceNumber, activeConfiguration)으로 둡니다.

6. 만약 interfaceIndex가 -1이면, "NotFoundError" DOMException으로 거부된 프로미스를 반환합니다.

7. 만약 this.[[claimedInterface]][interfaceIndex]가 true이면 undefined로 해결된 프로미스를 반환합니다.

8. unrestricted를 false로 둡니다.

9. document를 global의 연관 Document로 두거나, 연관 Document가 없으면 null로 둡니다.

10. 만약 document가 null이 아니고, document가 정책 제어 기능 "usb-unrestricted"을 사용할 수 있도록 허용되어 있다면 unrestricted를 true로 설정합니다.

11. 만약 interfaces[interfaceIndex].[[isProtectedClass]]가 true이고 unrestricted가 false이면 "SecurityError" DOMException으로 거부된 프로미스를 반환합니다.

12. promise를 새 프로미스로 둡니다.

13. 다음 단계를 병렬로 실행합니다.

    1. 현재 실행 컨텍스트에 대해 interfaces[interfaceIndex]에 대한 단독 제어를 요청하는 플랫폼 특유의 단계를 수행합니다.

    2. USB 작업 소스에 대하여 global의 전역 태스크를 큐에 추가하여 다음 단계를 실행합니다:

       1. 만약 위 플랫폼 단계가 실패하면 reject하여 promise를 "NetworkError" DOMException으로 거부하고 이 단계를 중단합니다.

       2. this.[[claimedInterface]][interfaceIndex]를 true로 설정합니다.

       3. Resolve하여 promise를 undefined로 해결합니다.

14. promise를 반환합니다.

1. global을 this의 관련 전역 객체로 한다.

2. check if the device is configured를 this와 함께 수행한 결과가 Promise를 반환하면, 그 값을 반환한다.

3. activeConfiguration을 finding the current configuration을 this와 함께 수행한 결과로 한다.

4. interfaces를 activeConfiguration.[[interfaces]]로 한다.

5. interfaceIndex를 finding the interface index를 interfaceNumber 및 activeConfiguration과 함께 수행한 결과로 한다.

6. interfaceIndex가 -1과 같다면, 다음으로 거부된 promise를 반환한다: "NotFoundError" DOMException.

7. this.[[claimedInterface]][interfaceIndex] 가 false이면, undefined로 이행된 promise를 반환한다.

8. promise를 새로운 promise로 한다.

9. 다음 단계를 병렬로 수행한다.

   1. interfaces[interfaceIndex]에 대한 독점 제어를 포기하기 위해 필요한 플랫폼별 단계를 수행한다.

   2. 글로벌 태스크를 큐에 넣어 USB 작업 소스에서 global을 주어 다음 단계를 실행한다:

      1. this.[[selectedAlternateSetting]][interfaceIndex] 를 0으로 설정한다.

      2. this.[[claimedInterface]][interfaceIndex] 를 false로 설정한다.

      3. Resolve promise를 undefined로 이행한다.

10. promise를 반환한다.

1. global을 this의 관련 전역 객체로 한다.

2. check if the device is configured를 this와 함께 수행한 결과가 Promise를 반환하면, 그 값을 반환한다.

3. activeConfiguration을 finding the current configuration을 this와 함께 수행한 결과로 한다.

4. interfaces를 activeConfiguration.[[interfaces]]로 한다.

5. interfaceIndex를 finding the interface index를 interfaceNumber와 activeConfiguration으로 수행한 결과로 한다.

6. interfaceIndex가 -1과 같다면, 다음으로 거부된 promise를 반환한다: "NotFoundError" DOMException.

7. this.[[claimedInterface]][interfaceIndex] 가 false라면, 다음으로 거부된 promise를 반환한다: "InvalidStateError" DOMException.

8. interface를 interfaces[interfaceIndex]로 한다.

9. alternateIndex를 finding the alternate index를 alternateSetting과 interface로 수행한 결과로 한다.

10. alternateIndex가 -1과 같다면, 다음으로 거부된 promise를 반환한다: "NotFoundError" DOMException.

11. promise를 새로운 promise로 한다.

12. 다음 단계를 병렬로 수행한다.

    1. 인터페이스에 현재 예약된 전송 중단을 interface로 수행한다.

    2. SET_INTERFACE control transfer를 발행하되, interfaceNumber는 interfaceNumber로, alternateSetting은 alternateSetting으로 설정한다.

    3. 글로벌 태스크를 큐에 넣어 USB 작업 소스에서 global을 주어 다음 단계를 실행한다:

       1. 위의 control transfer가 실패했다면 reject promise를 "NetworkError" DOMException으로 거부하고 이 단계를 중단한다.

       2. this.[[selectedAlternateSetting]][interfaceIndex] 를 alternateSetting으로 설정한다.

       3. Resolve promise를 undefined로 이행한다.

13. promise를 반환한다.

1. global을 this의 관련 전역 객체로 한다.

2. check if the device is configured를 this와 함께 수행한 결과가 Promise를 반환하면, 그 값을 반환한다.

3. check the validity of the control transfer parameters를 this와 setup으로 수행한 결과가 Promise를 반환하면, 그 값을 반환한다.

4. promise를 새로운 promise로 한다.

5. 다음 단계를 병렬로 수행한다.

   1. length가 0보다 크면, buffer를 length 바이트를 담을 공간을 가진 호스트 버퍼로 한다.

   2. control transfer를 this에 대해 발행하되, setup packet 매개변수는 setup에서 제공된 값을 사용하고, bmRequestType의 데이터 전송 방향은 "device to host"로, wLength는 length로 설정한다. 정의되어 있다면, 이 전송에 대한 응답으로 수신된 데이터를 기록할 대상로서 buffer도 제공한다.

   3. 글로벌 태스크를 큐에 넣어 USB 작업 소스에서 global을 주어 다음 단계를 실행한다:

      1. bytesTransferred를 buffer에 기록된 바이트 수로 한다.

      2. result를 새로운 USBInTransferResult로 한다.

      3. 장치로부터 데이터를 수신했다면, 새로운 ArrayBuffer를 생성하되 buffer의 처음 bytesTransferred 바이트를 포함하도록 하고, result.data를 그 위에 구성한 새로운 DataView로 설정한다.

      4. result.status를 다음과 같이 설정한다.

         • "stall": 장치가 기본 제어 파이프를 정지시켜 응답한 경우.

         • "babble": 장치가 length 바이트보다 많은 데이터를 응답한 경우.

         • "ok": 그 외의 경우.

      5. 그 밖의 이유로 전송이 실패했다면 reject promise를 "NetworkError"로 거부하고 이 단계를 중단한다.

      6. Resolve promise를 result로 이행한다.

6. promise를 반환한다.

1. global을 this의 관련 전역 객체로 한다.

2. check if the device is configured를 this와 함께 수행한 결과가 Promise를 반환하면, 그 값을 반환한다.

3. check the validity of the control transfer parameters를 this와 setup으로 수행한 결과가 Promise를 반환하면, 그 값을 반환한다.

4. 버퍼 소스의 복사본을 가져와 data에서 결과를 bytes로 한다.

5. promise를 새로운 promise로 한다.

6. 다음 단계를 병렬로 수행한다.

   1. control transfer를 this에 대해 발행하되, setup packet 매개변수는 setup에서 제공된 값을 사용하고, bmRequestType의 데이터 전송 방향은 "host to device"로, wLength는 bytes의 길이로 설정한다.

   2. 전송의 data stage에서 bytes를 전송한다.

   3. 글로벌 태스크를 큐에 넣어 USB 작업 소스에서 global을 주어 다음 단계를 실행한다:

      1. result를 새로운 USBOutTransferResult로 한다.

      2. result.status를 다음과 같이 설정한다.

         • "stall": 장치가 기본 제어 파이프를 정지시켜 응답한 경우.

         • "ok": 그 외의 경우이며, 이때 result.bytesWritten을 bytes의 길이로 설정한다.

      3. 그 밖의 이유로 전송이 실패하면 reject promise를 "NetworkError" DOMException으로 거부하고 이 단계를 중단한다.

      4. Resolve promise를 result로 이행한다.

7. promise를 반환한다.

1. global을 this의 관련 전역 객체로 한다.

2. check if the device is configured를 this와 함께 수행한 결과가 Promise를 반환하면, 그 값을 반환한다.

3. endpointAddress를 direction이 "in"과 같으면 endpointNumber | 0x80으로, 그렇지 않으면 endpointNumber로 한다.

4. endpoint를 finding the endpoint를 endpointAddress와 this로 수행한 결과로 한다.

5. endpoint가 null이면, 다음으로 거부된 promise를 반환한다: "NotFoundError" DOMException.

6. promise를 새로운 promise로 한다.

7. 다음 단계를 병렬로 수행한다.

   1. ClearFeature(ENDPOINT_HALT) control transfer를 장치에 발행해 endpoint의 중지(halts) 상태를 해제한다.

   2. 글로벌 태스크를 큐에 넣어 USB 작업 소스에서 global을 주어 다음 단계를 실행한다:

      1. 위의 control transfer가 실패했다면, reject promise를 "NetworkError" DOMException으로 거부하고 이 단계를 중단한다.

      2. Resolve promise를 undefined로 이행한다.

8. promise를 반환한다.

1. global을 this의 관련 전역 객체로 한다.

2. check if the device is configured를 this와 함께 수행한 결과가 Promise를 반환하면, 그 값을 반환한다.

3. endpointAddress를 endpointNumber | 0x80(즉, "in" 방향)으로 한다.

4. endpoint를 finding the endpoint를 endpointAddress와 this로 수행한 결과로 한다.

5. endpoint가 null이면, 다음으로 거부된 promise를 반환한다: "NotFoundError" DOMException.

6. endpoint.type 이 "bulk" 또는 "interrupt"와 같지 않다면, 다음으로 거부된 promise를 반환한다: "InvalidAccessError" DOMException.

7. promise를 새로운 promise로 한다.

8. 다음 단계를 병렬로 수행한다.

   1. buffer를 length 바이트를 담을 공간을 가진 호스트 버퍼로 한다.

   2. endpoint에 적합한 방식으로 bulk 또는 interrupt IN transfer를 수행하여 장치로부터 length 바이트의 데이터를 buffer로 수신한다.

   3. 글로벌 태스크를 큐에 넣어 USB 작업 소스에서 global을 주어 다음 단계를 실행한다:

      1. bytesTransferred를 buffer에 기록된 바이트 수로 한다.

      2. result를 새로운 USBInTransferResult로 한다.

      3. 장치로부터 데이터를 수신했다면, 새로운 ArrayBuffer를 생성하되 buffer의 처음 bytesTransferred 바이트를 포함하도록 하고, result.data를 그 위에 구성한 새로운 DataView로 설정한다.

      4. result.status를 다음과 같이 설정한다.

         • "stall": 장치가 endpoint를 정지시켜 응답한 경우.

         • "babble": 장치가 length 바이트보다 많은 데이터를 응답한 경우.

         • "ok": 그 외의 경우.

      5. 그 밖의 이유로 전송이 실패했다면 reject promise를 "NetworkError" DOMException으로 거부하고 이 단계를 중단한다.

      6. Resolve promise를 result로 이행한다.

9. promise를 반환한다.

1. global을 this의 관련 전역 객체로 한다.

2. check if the device is configured를 this와 함께 수행한 결과가 Promise를 반환하면, 그 값을 반환한다.

3. endpointAddress를 endpointNumber(즉, "out" 방향)로 한다.

4. endpoint를 finding the endpoint를 endpointAddress와 this로 수행한 결과로 한다.

5. endpoint가 null이면, 다음으로 거부된 promise를 반환한다: "NotFoundError" DOMException.

6. endpoint.type 이 "bulk" 또는 "interrupt"와 같지 않다면, 다음으로 거부된 promise를 반환한다: "InvalidAccessError" DOMException.

7. 버퍼 소스의 복사본을 가져와 data에서 결과를 bytes로 한다.

8. promise를 새로운 promise로 한다.

9. 다음 단계를 병렬로 수행한다.

   1. endpoint에 적합한 방식으로 bulk 또는 interrupt OUT transfer를 수행하여 bytes를 장치로 전송한다.

   2. 글로벌 태스크를 큐에 넣어 USB 작업 소스에서 global을 주어 다음 단계를 실행한다:

      1. result를 새로운 USBOutTransferResult로 한다.

      2. result.bytesWritten을 장치로 성공적으로 전송된 데이터의 양으로 설정한다.

      3. result.status를 다음과 같이 설정한다.

         • "stall": 장치가 endpoint를 정지시켜 응답한 경우.

         • "ok": 그 외의 경우.

      4. 그 밖의 이유로 전송이 실패했다면 reject promise를 "NetworkError" DOMException으로 거부하고 이 단계를 중단한다.

      5. Resolve promise를 result로 이행한다.

10. promise를 반환한다.

1. global을 this의 관련 전역 객체로 한다.

2. check if the device is configured를 this와 함께 수행한 결과가 Promise를 반환하면, 그 값을 반환한다.

3. endpointAddress를 endpointNumber | 0x80(즉, "in" 방향)으로 한다.

4. endpoint를 finding the endpoint를 endpointAddress와 this로 수행한 결과로 한다.

5. endpoint가 null이면, 다음으로 거부된 promise를 반환한다: "NotFoundError" DOMException.

6. endpoint.type 이 "isochronous"와 같지 않다면, 다음으로 거부된 promise를 반환한다: "InvalidAccessError" DOMException.

7. promise를 새로운 promise로 한다.

8. 다음 단계를 병렬로 수행한다.

   1. totalLength를 packetLengths의 모든 요소의 합으로 한다.

   2. buffer를 totalLength 바이트를 담을 공간을 가진 호스트 버퍼로 한다.

   3. isochronous IN transfer를 endpoint에서 수행하여 장치로부터 패킷을 buffer로 읽되, packetLengths에 따라 진행한다.

   4. 글로벌 태스크를 큐에 넣어 USB 작업 소스에서 global을 주어 다음 단계를 실행한다:

      1. result를 새로운 USBIsochronousInTransferResult로 한다.

      2. data를 새로운 ArrayBuffer로 하되 buffer로 초기화한다.

      3. result.data를 새로운 DataView로 설정하되, buffer 위에 구성한다.

      4. 각 패킷 i에 대해 0부터 packetLengths.length - 1까지 반복한다:

         1. packet을 새로운 USBIsochronousInTransferPacket으로 한다.

         2. view를 새로운 DataView로 하되 이 패킷에 대해 장치에서 수신된 데이터를 포함하는 data의 일부분 위에 구성하고, packet.data를 view로 설정한다.

         3. packet.status를 다음과 같이 설정한다.

            • "stall": 이 패킷을 수신하기 전에 장치가 endpoint를 정지시켜 전송이 종료된 경우.

            • "babble": 이 패킷에 대해 장치가 packetLengths[i] 바이트보다 많은 데이터를 보내 전송이 종료된 경우.

            • "ok": 그 외의 경우.

         4. 그 밖의 이유로 전송이 실패하면 reject promise를 "NetworkError" DOMException으로 거부하고 이 단계를 중단한다.

         5. result.packets[i] 를 packet으로 설정한다.

      5. Resolve promise를 result로 이행한다.

9. promise를 반환한다.

1. global을 this의 관련 전역 객체로 한다.

2. check if the device is configured를 this와 함께 수행한 결과가 Promise를 반환하면, 그 값을 반환한다.

3. endpointAddress를 endpointNumber(즉, "out" 방향)로 한다.

4. endpoint를 finding the endpoint를 endpointAddress와 this로 수행한 결과로 한다.

5. endpoint가 null이면, 다음으로 거부된 promise를 반환한다: "NotFoundError" DOMException.

6. endpoint.type 이 "isochronous"와 같지 않다면, 다음으로 거부된 promise를 반환한다: "InvalidAccessError" DOMException.

7. 버퍼 소스의 복사본을 가져와 data에서 결과를 bytes로 한다.

8. promise를 새로운 promise로 한다.

9. 다음 단계를 병렬로 수행한다.

   1. isochronous OUT transfer를 endpoint에서 수행하여 bytes를 장치에 기록하되, packetLengths.length개의 패킷으로 나누고 각 패킷의 크기는 packetLengths[i] 바이트(i는 0부터 packetLengths.length - 1까지)로 한다.

   2. 글로벌 태스크를 큐에 넣어 USB 작업 소스에서 global을 주어 다음 단계를 실행한다:

      1. result를 새로운 USBIsochronousOutTransferResult로 한다.

      2. 각 패킷 i에 대해 0부터 packetLengths.length - 1까지 반복한다:

         1. packet을 새로운 USBIsochronousOutTransferPacket으로 한다.

         2. packet.bytesWritten을 이 패킷의 일부로 장치에 성공적으로 전송된 데이터의 양으로 설정한다.

         3. packet.status를 다음과 같이 설정한다.

            • "stall": 이 패킷이 확인되기 전에 장치가 endpoint를 정지시켜 전송이 종료된 경우.

            • "ok": 그 외의 경우.

         4. 그 밖의 이유로 전송이 실패하면 reject promise를 "NetworkError" DOMException으로 거부하고 이 단계를 중단한다.

         5. result.packets[i] 를 packet으로 설정한다.

      3. Resolve promise를 result로 이행한다.

10. promise를 반환한다.

1. global을 this의 관련 전역 객체로 한다.

2. check if the device is configured를 this와 함께 수행한 결과가 Promise를 반환하면, 그 값을 반환한다.

3. promise를 새로운 promise로 한다.

4. 다음 단계를 병렬로 수행한다.

   1. 장치의 모든 작업을 중단하고, 그들의 연결된 promise를 "글로벌 태스크를 큐에 넣어 USB 작업 소스에서 reject 하되 "AbortError" DOMException으로 거부하도록 한다.

   2. 장치를 소프트 리셋하기 위한 필요한 플랫폼별 작업을 수행한다.

   3. 글로벌 태스크를 큐에 넣어 USB 작업 소스에서 global을 주어 다음 단계를 실행한다:

      1. 소프트 리셋이 실패했다면, reject promise를 "NetworkError"로 거부하고 이 단계를 중단한다.

      2. Resolve promise를 undefined로 이행한다.

5. promise를 반환한다.

장치를 재설정한 후에는 어떤 구성 상태인가? [Issue #36]

1. configuration을 device로 현재 구성을 찾기의 결과로 한다.

2. configuration이 null이면, undefined를 반환한다.

3. setup.recipient 가 "interface"이면, 다음 단계를 수행한다:

   1. interfaceNumber를 setup.index의 하위 8비트로 한다.

   2. interfaceIndex를 interfaceNumber 및 configuration으로 인터페이스 인덱스를 찾기의 결과로 한다.

   3. interfaceIndex가 -1과 같다면, a promise rejected with "NotFoundError" DOMException을 반환한다.

   4. interface를 configuration.[[interfaces]][interfaceIndex]로 한다.

   5. interface로 해당 인터페이스가 클레임되었는지 찾기의 결과가 true가 아니면, a promise rejected with "InvalidStateError" DOMException을 반환한다.

4. setup.recipient 가 "endpoint"이면, 다음 단계를 수행한다:

   1. endpointAddress를 setup.index로 한다.

   2. endpoint를 endpointAddress 및 device로 엔드포인트 찾기의 결과로 한다.

   3. endpoint가 null이면, a promise rejected with "NotFoundError" DOMException을 반환한다.

   4. alternate를 endpoint.[[alternateInterface]]로 한다.

   5. interface를 alternate.[[interface]]로 한다.

   6. interface로 해당 인터페이스가 클레임되었는지 찾기의 결과가 false이면, a promise rejected with "InvalidStateError" DOMException을 반환한다.

5. undefined를 반환한다.

1. deviceDescriptor를 연결된 USB 장치의 디바이스 디스크립터 찾기의 결과로 한다.

2. numConfigurations를 deviceDescriptor의 bNumConfigurations로 한다.

3. configurationIndex를 0으로 한다.

4. configurationIndex가 numConfigurations보다 작은 동안:

   1. descriptors를 descriptors의 목록으로 하되, Get Descriptor를 수행하면서 DescriptorType은 CONFIGURATION으로, DescriptorIndex는 configurationIndex로 설정한다.

   2. descriptors[0]의 bDescriptorType이 CONFIGURATION과 같고, descriptors의 bConfigurationValue가 configurationValue와 같다면, descriptors를 반환한다.

   3. configurationIndex를 1 증가시킨다.

5. empty 결과를 반환한다.

1. this.[[device]] 를 device로 설정한다.

2. this.[[configurationValue]] 를 configurationValue로 설정한다.

3. descriptors를 configurationValue를 configurationValue로 설정하여 구성에 대한 디스크립터 목록을 찾기의 결과로 한다.

4. seen을 비어 있는 ordered set으로 한다.

5. 각 descriptors의 descriptor에 대해:

   1. descriptor의 bDescriptorType이 INTERFACE와 같지 않다면, 다음으로 진행한다.

   2. descriptor의 bInterfaceNumber가 seen 안에 있으면, 다음으로 진행한다.

   3. interface를 새로운 USBInterface 객체로 하되, USBInterface(configuration,interfaceNumber)를 사용하고 configuration은 this로, interfaceNumber는 descriptor의 bInterfaceNumber로 설정한다.

   4. Append interface를 this.[[interfaces]]에 추가한다.

   5. Append descriptor의 bInterfaceNumber를 seen에 추가한다.

1. configuration을 interface.[[configuration]]로 한다.

2. device를 configuration.[[device]]로 한다.

3. configuration이 device로 현재 구성을 찾기의 결과와 동일하지 않다면, false를 반환한다.

4. interfaceIndex를 interface.[[interfaceNumber]] 및 configuration으로 인터페이스 인덱스를 찾기의 결과로 한다.

5. Assert: interfaceIndex는 -1이 아니다.

6. device.[[claimedInterface]][interfaceIndex]를 반환한다.

1. configuration을 interface.[[configuration]]로 한다.

2. device를 configuration.[[device]]로 한다.

3. alternateIndex를 0으로 한다.

4. interface로 인터페이스가 클레임되었는지 찾기의 결과가 true이면:

   1. interfaceIndex를 interface.[[interfaceNumber]] 및 configuration으로 인터페이스 인덱스를 찾기의 결과로 한다.

   2. Assert: interfaceIndex는 -1이 아니다.

   3. alternateIndex를 device.[[selectedAlternateSetting]][interfaceIndex] 및 interface로 대체 인덱스를 찾기의 결과로 설정한다.

5. Assert: alternateIndex는 -1이 아니다.

6. interface.alternates[alternateIndex]를 반환한다.

Note: Interface Descriptor [USB31]에 따르면 인터페이스에는 적어도 하나의 대체 설정이 있어야 한다. 즉, Interface Descriptor에는 최소한 하나의 대체 설정이 존재해야 한다.

1. this.[[configuration]] 를 configuration로 설정한다.

2. this.[[interfaceNumber]] 를 interfaceNumber로 설정한다.

3. descriptors를 configurationValue를 configuration.[[configurationValue]]로 설정하여 구성에 대한 디스크립터 목록을 찾기의 결과로 한다.

4. 각 descriptors의 descriptor에 대하여:

   1. descriptor의 bDescriptorType이 INTERFACE와 같지 않다면, 계속한다.

   2. descriptor의 bInterfaceNumber가 interfaceNumber와 같지 않다면, 계속한다.

   3. descriptor가 보호된 인터페이스 클래스를 가진다면, this.[[isProtectedClass]] 를 true로 설정한다.

   4. alternate를 새로운 USBAlternateInterface 객체로 하되, USBAlternateInterface(deviceInterface,alternateSetting)를 사용하고 deviceInterface는 this로, alternateSetting은 descriptor의 bAlternateSetting으로 설정한다.

   5. Append alternate를 this.[[alternates]]에 추가한다.

1. descriptors를 configurationValue로 구성에 대한 디스크립터 목록을 찾기의 결과로 한다.

2. endpointDescriptors를 비어 있는 list로 한다.

3. index를 0으로 한다.

4. index가 descriptors의 size보다 작은 동안:

   1. descriptor를 descriptors[index]로 한다.

   2. descriptor의 bDescriptorType이 INTERFACE와 같지 않다면, index를 1 증가시키고 계속한다.

   3. descriptor의 bInterfaceNumber가 interfaceNumber와 같지 않다면, index를 1 증가시키고 계속한다.

   4. descriptor의 bAlternateSetting이 alternateSetting과 같지 않다면, index를 1 증가시키고 계속한다.

   5. bNumEndpoints가 0과 같다면, endpointDescriptors를 반환한다.

   6. numEndpoints를 descriptor의 bNumEndpoints로 한다.

   7. indexEndpoints를 0으로 한다.

   8. offset을 index + 1로 한다

   9. indexEndpoints가 numEndpoints보다 작은 동안:

      1. Append descriptors[indexEndpoints + offset]를 endpointDescriptors에 추가한다.

      2. indexEndpoints를 1 증가시킨다.

   10. endpointDescriptors를 반환한다.

1. this.[[interface]] 를 deviceInterface로 설정한다.

2. this.[[alternateSetting]] 를 alternateSetting으로 설정한다.

3. descriptors를 interfaceNumber를 deviceInterface.interfaceNumber로, alternateSetting을 alternateSetting으로, configurationValue를 deviceInterface.[[configuration]].[[configurationValue]]로 설정하여 엔드포인트 디스크립터 목록을 찾기의 결과로 한다.

4. 각 descriptors의 descriptor에 대하여:

   1. descriptor의 bmAttributes가 Control Transfer Type(즉, endpoint descriptor에 따라 비트 0..1이 00)을 나타내면, 계속한다.

   2. endpointAddress를 descriptor의 bEndpointAddress로 한다.

   3. endpointAddress & 0x80이 0이면 dir을 "out"으로, 그렇지 않으면 "in"으로 한다.

   4. endpoint를 새로운 USBEndpoint 객체로 하되, USBEndpoint(alternate,endpointNumber,direction)를 사용하고 alternate는 this로, endpointNumber는 endpointAddress & 0xF로, direction은 dir로 설정한다.

   5. Append endpoint를 this.[[endpoints]]에 추가한다.

1. alternateInterface를 endpoint.[[alternateInterface]]로 한다.

2. interface를 alternateInterface.[[interface]]로 한다.

3. configuration을 interface.[[configuration]]로 한다.

4. endpointDescriptors를 alternateSetting을 alternateInterface.alternateSetting으로, interfaceNumber를 interface.interfaceNumber로, configurationValue를 configuration.configurationValue로 설정하여 엔드포인트 디스크립터 목록 찾기의 결과로 한다.

5. 각 endpointDescriptor (of endpointDescriptors)에 대하여:

   1. endpoint.[[endpointAddress]] 가 endpointDescriptor의 bEndpointAddress와 같으면, endpointDescriptor를 반환한다.

1. this.[[alternateInterface]] 를 alternate로 설정한다.

2. endpointAddress를 direction이 "in"이면 endpointNumber | 0x80으로, 그렇지 않으면 endpointNumber로 한다.

3. this.[[endpointAddress]] 를 endpointAddress로 설정한다.