웹 블루투스

1. filter.name 이 존재한다면, device 의 Bluetooth Device Name 이 완전하고 filter.name 과 동일하지 않다면 mismatch 를 반환합니다.

2. filter.namePrefix 가 존재한다면, device 의 Bluetooth Device Name 이 존재하지 않거나 filter.namePrefix 로 시작하지 않으면 mismatch 를 반환합니다.

3. filter.services 의 각 uuid 에 대해, UA가 광고 데이터, 확장 조회 응답, 또는 장치가 UUID uuid 를 가진 기본(포함된 것이 아닌) 서비스를 지원함을 나타내는 서비스 검색 응답을 받지 않았다면 mismatch 를 반환합니다.

4. filter["manufacturerData"] 의 각 manufacturerData 에 대해, device 가 제조사별 데이터 를 광고하지 않았거나 회사 식별자 코드가 manufacturerData["companyIdentifier"] 와 같지 않거나, 데이터가 일치 하지 않으면 mismatch 를 반환합니다.

5. filter["serviceData"] 의 각 serviceData 에 대해, device 가 128비트 형태가 serviceData["service"] 인 UUID의 서비스 데이터 를 광고하지 않았거나, 데이터가 일치 하지 않으면 mismatch 를 반환합니다.

6. match 를 반환합니다.

1. expectedPrefix 를 filter.dataPrefix 가 보유한 바이트의 사본 으로 둡니다.

2. mask 를 filter.mask 가 보유한 바이트의 사본 으로 둡니다.

3. data 의 바이트 수가 expectedPrefix 보다 적으면 mismatch 를 반환합니다.

4. mask 의 각 1 비트에 대해, data 의 해당 비트가 expectedPrefix 의 해당 비트와 다르면 mismatch 를 반환합니다.

5. match 를 반환합니다.

1. filter1 의 길이가 filter2 의 길이보다 짧으면 false 를 반환합니다.

2. byteIndex 를 0 으로 둡니다.

3. byteIndex 가 filter2 의 길이보다 작은 동안 다음 하위 단계를 수행합니다:

   1. filter1.mask[byteIndex] & filter2.mask[byteIndex] 가 filter2.mask[byteIndex] 와 같지 않으면 false 를 반환합니다.

   2. filter1.dataPrefix[byteIndex] & filter2.mask[byteIndex] 가 filter2.dataPrefix[byteIndex] & filter2.mask[byteIndex] 와 같지 않으면 false 를 반환합니다.

   3. byteIndex 를 byteIndex + 1 로 설정합니다.

4. true 를 반환합니다.

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

2. global 의 연결된 Document 가 "bluetooth" 라는 정책 제어 기능을 사용할 수 없음 이라면, 거부된 프라미스 를 SecurityError 로 반환합니다.

3. promise 를 새로운 프라미스 로 둡니다.

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

   1. devices 를 새 비어 있는 Array 로 둡니다.

   2. storage.allowedDevices 의 각 allowedDevice 에 대해, allowedDevice@[[device]] 를 나타내는 BluetoothDevice 객체를 devices 에 추가합니다.

   3. 전역 작업 대기 를 Bluetooth 작업 소스 에, global 을 주어 resolve 하여 promise 를 devices 로 이행하도록 합니다.

   참고: devices 내의 BluetoothDevice 들은 Bluetooth 라디오의 범위 내에 없을 수도 있습니다. devices 의 특정 device 에 대해서는, watchAdvertisements() 메서드를 사용해 device 가 범위 내에 있고 광고 패킷을 브로드캐스트하는 시점을 관찰할 수 있습니다. device 에 advertisementreceived 이벤트 event 가 발생하면, event.device.gatt.connect() 호출로 연결을 설정할 수 있을 정도로 충분히 가까움을 나타낼 수 있습니다.

5. promise 를 반환합니다.

1. options.exclusionFilters 가 존재하고 options.filters 가 존재하지 않으면, 거부된 프라미스 를 TypeError 로 반환합니다.

2. options.filters 가 존재하면서 options.acceptAllDevices 가 true 인 경우, 또는 options.filters 가 없고 options.acceptAllDevices 가 false 인 경우, 거부된 프라미스 를 TypeError 로 반환합니다.

   참고: 이는 filters 와 acceptAllDevices:true 중 정확히 하나만 존재하도록 강제합니다.

3. promise 를 새로운 프라미스 로 둡니다.

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

   1. Bluetooth 장치 요청 을 수행합니다. 이때 options.filters 는 options.acceptAllDevices 가 false 일 때 전달하고, 그렇지 않으면 null 을 전달합니다. 또한 options.exclusionFilters 가 존재하면 전달하고, 그렇지 않으면 null 을 전달합니다. 그리고 options.optionalServices 와 options.optionalManufacturerData 도 전달합니다. 결과를 devices 로 둡니다.

   2. 전역 작업 대기 를 Bluetooth 작업 소스 에, this 의 관련 전역 객체 를 주어 다음 단계를 실행합니다:

      1. 이전 단계에서 예외가 발생했다면, 그 예외로 promise 를 거부하고 이 단계를 중단합니다.

      2. devices 가 빈 시퀀스라면, NotFoundError 로 promise 를 거부하고 이 단계를 중단합니다.

      3. promise 를 이행 하되, devices[0] 으로 이행합니다.

5. promise 를 반환합니다.

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

2. document 를 global 의 연결된 Document 로 둡니다.

3. document 가 "bluetooth" 라는 정책 제어 기능 을 사용할 수 없음 이라면 SecurityError 를 던지고 단계를 중단합니다.

4. 이 알고리즘이 트리거될 때 관련 전역 객체 가 일시적 활성화 를 보유하고 있는지 확인하고, 그렇지 않다면 SecurityError 를 던지며 단계를 중단합니다.

5. 서비스 이름과 별칭에서 UUID 로 인자를 변환하기 위해 다음 하위 단계를 수행합니다:

   1. filters !== null && filters.length === 0 이면 TypeError 를 던지고 단계를 중단합니다.

   2. exclusionFilters !== null && exclusionFilters.length === 0 이면 TypeError 를 던지고 단계를 중단합니다.

   3. uuidFilters 를 새 Array 로, uuidExclusionFilters 를 새 Array 로, requiredServiceUUIDs 를 새 Set 으로 둡니다.

   4. filters 가 null 이면, requiredServiceUUIDs 를 모든 UUID의 집합으로 설정합니다.

   5. filters 가 null 이 아니면, 각 filter 에 대해 다음을 수행합니다:

      1. canonicalFilter 를 정규화 한 결과로 둡니다.

      2. canonicalFilter 를 uuidFilters 에 추가합니다.

      3. canonicalFilter.services 의 내용을 requiredServiceUUIDs 에 추가합니다.

   6. exclusionFilters 가 null 이 아니면, 각 exclusionFilter 에 대해 다음을 수행합니다:

      1. canonicalExclusionFilter 를 정규화 한 결과로 둡니다.

      2. canonicalExclusionFilter 를 uuidExclusionFilters 에 추가합니다.

   7. optionalServiceUUIDs 를 Array.prototype.map.call(optionalServices, BluetoothUUID.getService) 로 둡니다.

   8. 어떤 BluetoothUUID.getService() 호출이라도 예외를 던지면, 그 예외를 던지고 단계를 중단합니다.

   9. optionalServiceUUIDs 에서 blocklisted 된 UUID를 제거합니다.

6. descriptor 를 다음으로 둡니다:

   {
     name: "bluetooth",
     filters: uuidFilters
     optionalServices: optionalServiceUUIDs,
     optionalManufacturerData: optionalManufacturerData
     acceptAllDevices: filters !== null,
   }
   

7. state 를 descriptor 의 권한 상태 로 둡니다.

   참고: state 는 비보안 컨텍스트 에서 강력한 기능을 사용할 수 없으므로 "denied" 입니다.

8. state 가 "denied" 이면 [] 를 반환하고 단계를 중단합니다.

9. UA가 다음 단계에서 장치를 전혀 찾을 수 없음을 증명할 수 있다면(예: 스캔에 사용할 Bluetooth 어댑터가 없거나, 필터가 어떤 가능한 광고 패킷과도 일치할 수 없는 경우), UA는 [] 를 반환하고 단계를 중단할 수 있습니다.

10. scanResult 를 scan for devices 를 global 및 requiredServiceUUIDs 와 함께 호출한 결과로 둡니다.

11. filters 가 null 이 아니면, 다음 하위 단계를 수행합니다:

    1. scanResult 에서 uuidFilters 의 필터와 일치 하지 않는 장치를 제거합니다.

    2. exclusionFilters 가 null 이 아니면, uuidExclusionFilters 의 필터와 일치 하는 장치를 scanResult 에서 제거합니다.

12. navigable 을 document 의 navigable 로 둡니다.

13. promptId 를 새로운 고유한 불투명 문자열로 둡니다.

실제로는 프롬프트가 열려 있는 동안 장치 목록이 동적으로 업데이트됩니다. 명세 텍스트는 아직 이를 반영하지 않지만, 동일한 promptId 와 최신 장치 목록로 이벤트가 여러 번 발생할 수 있습니다. 참조: https://github.com/WebBluetoothCG/web-bluetooth/issues/621.

1. 프롬프트 업데이트 이벤트 트리거 를 navigable, promptId, scanResult 를 주어 실행합니다.

2. scanResult 가 비어 있더라도, 사용자에게 선택을 요청 하여 descriptor 와 연계된 scanResult 의 장치들 중 하나를 선택하게 하고, 결과를 device 로 둡니다.

   UA는 사용자가 uuidFilters 와 일치하지 않는 근처 장치를 선택하도록 허용할 수 있습니다.

   참고: UA는 각 장치의 사람이 읽을 수 있는 이름을 사용자에게 보여주어야 합니다. 이 이름을 사용할 수 없는 경우(예: UA의 Bluetooth 시스템이 프라이버시 활성화 스캔을 지원하지 않는 경우), UA는 사용자가 관심을 표시하도록 허용하고 이름을 가져오기 위해 프라이버시 비활성화 스캔을 수행해야 합니다.

3. 제거: map of navigables to device prompts[navigable 의 navigable id] 항목을 제거합니다.

4. UA는 device 를 storage 에 추가 할 수 있습니다.

   참고: device 를 선택하는 것은 사용자가 해당 장치가 적어도 현재 설정 객체 에 대해 "bluetooth" 의 추가 권한 데이터 의 allowedDevices 목록에 나타나길 의도한다는 의미일 가능성이 큽니다. 또한 mayUseGATT 필드는 true 여야 하며, requiredServiceUUIDs 와 optionalServiceUUIDs 의 합집합에 있는 모든 서비스가 기존 서비스에 더해 allowedServices 목록에 나타나야 합니다. 또한 optionalManufacturerData 의 제조사 코드들은 allowedManufacturerData 목록에 나타나야 합니다.

5. device 가 "denied" 이면 [] 를 반환하고 단계를 중단합니다.

6. UA는 device 의 모든 Service 로 Bluetooth 캐시 채우기 를 수행할 수 있습니다. 이 단계에서의 오류는 무시합니다.

7. BluetoothDevice 가져오기 를 통해, 예외를 전파하면서 this 내에서 device 를 나타내는 객체를 얻고, 결과를 deviceObj 로 둡니다.

8. [deviceObj] 를 반환합니다.

1. filter 의 어떤 멤버도 존재하지 않으면, TypeError 를 던지고 단계를 중단합니다.

2. canonicalizedFilter 를 {} 로 둡니다.

3. filter.services 가 존재하면 다음 하위 단계를 수행합니다:

   1. filter.services.length === 0 이면 TypeError 를 던지고 단계를 중단합니다.

   2. services 를 Array.prototype.map.call(filter.services, BluetoothUUID.getService) 로 둡니다.

   3. 어떤 BluetoothUUID.getService() 호출이라도 예외를 던지면, 그 예외를 던지고 단계를 중단합니다.

   4. services 의 어떤 서비스라도 blocklisted 이면, SecurityError 를 던지고 단계를 중단합니다.

   5. canonicalizedFilter.services 를 services 로 설정합니다.

4. filter.name 이 존재하면 다음 하위 단계를 수행합니다.

   1. filter.name 의 UTF-8 인코딩 이 248 바이트를 초과하면 TypeError 를 던지고 단계를 중단합니다.

      참고: 248은 Bluetooth Device Name 의 최대 UTF-8 코드 유닛 수입니다.

   2. canonicalizedFilter.name 를 filter.name 으로 설정합니다.

5. filter.namePrefix 가 존재하면 다음 하위 단계를 수행합니다.

   1. filter.namePrefix.length === 0 이거나 filter.namePrefix 의 UTF-8 인코딩 이 248 바이트를 초과하면 TypeError 를 던지고 단계를 중단합니다.

      참고: 248은 Bluetooth Device Name 의 최대 UTF-8 코드 유닛 수입니다.

   2. canonicalizedFilter.namePrefix 를 filter.namePrefix 로 설정합니다.

6. canonicalizedFilter["manufacturerData"] 를 [] 로 둡니다.

7. filter["manufacturerData"] 가 존재하며 filter["manufacturerData"].length === 0 이면, TypeError 를 던지고 단계를 중단합니다.

8. filter["manufacturerData"] 의 각 manufacturerData 에 대해 다음 하위 단계를 수행합니다:

   1. manufacturerData 가 차단된 제조사 데이터 필터 이면, SecurityError 를 던지고 단계를 중단합니다.

   2. canonicalizedFilter["manufacturerData"] 에 객체 existing 이 존재하고, existing["companyIdentifier"] === manufacturerData["companyIdentifier"] 라면, TypeError 를 던지고 단계를 중단합니다.

   3. canonicalizedManufacturerDataFilter 를 정규화 한 결과로(그리고 ECMAScript 값으로 변환 하여) 둡니다. 예외가 발생하면 예외를 전파하고 단계를 중단합니다.

   4. canonicalizedManufacturerDataFilter["companyIdentifier"] 를 manufacturerData["companyIdentifier"] 로 설정합니다.

   5. canonicalizedManufacturerDataFilter 를 canonicalizedFilter["manufacturerData"] 에 추가합니다.

9. canonicalizedFilter.serviceData 를 [] 로 둡니다.

10. filter["serviceData"] 가 존재하며 filter["serviceData"].length === 0 이면, TypeError 를 던지고 단계를 중단합니다.

11. filter["serviceData"] 의 각 serviceData 에 대해 다음 하위 단계를 수행합니다:

    1. service 를 BluetoothUUID.getService(serviceData["service"]) 로 둡니다. 예외가 발생하면 예외를 전파하고 단계를 중단합니다.

    2. service 가 blocklisted 이면, SecurityError 를 던지고 단계를 중단합니다.

    3. canonicalizedServiceDataFilter 를 정규화 한 결과로(그리고 ECMAScript 값으로 변환 하여) 둡니다. 예외가 발생하면 예외를 전파하고 단계를 중단합니다.

    4. canonicalizedServiceDataFilter["service"] 를 service 로 설정합니다.

    5. canonicalizedServiceDataFilter 를 canonicalizedFilter["serviceData"] 에 추가합니다.

12. canonicalizedFilter 를 반환합니다.

1. filter.dataPrefix 가 존재하지 않으면 dataPrefix 를 빈 바이트 시퀀스로 둡니다. 그렇지 않으면, 다음 하위 단계를 수행합니다:

   1. dataPrefix 를 보유한 바이트의 사본으로 설정합니다(원본: filter.dataPrefix).

   2. dataPrefix 의 길이가 0이면 TypeError 를 던지고 이 단계를 중단합니다.

2. filter.mask 가 존재하면 mask 를 보유한 바이트의 사본으로 설정합니다(원본: filter.mask). 그렇지 않으면 mask 를 dataPrefix 와 같은 길이의 0xFF 바이트 시퀀스로 둡니다.

3. mask 의 길이가 dataPrefix 와 같지 않으면 TypeError 를 던지고 이 단계를 중단합니다.

4. {dataPrefix: new Uint8Array(|dataPrefix|), mask: new Uint8Array(|mask|)} 를 반환합니다.

1. UA가 최근 현재 스캔의 UUID 집합을 포함하는 상위 집합(UUID 세트)으로 장치를 스캔한 적이 있다면, UA는 그 스캔의 결과를 반환하고 이 단계를 중단할 수 있습니다.

   TODO: 시간 기준을 확정해야 합니다.

2. nearbyDevices 를 Bluetooth device 의 집합으로 두며, 초기값은 UA에 연결되어 있는(ATT Bearer 를 가진) 장치들의 집합과 동일합니다.

3. topLevelTraversable 을 global 의 navigable 의 최상위 트래버서블로 둡니다.

4. simulatedBluetoothDevices 를 빈 list 로 둡니다.

5. topLevelTraversable 에 simulated Bluetooth adapter 가 있다면, simulatedBluetoothDevices 를 해당 값을 얻어 구성한 simulated Bluetooth device mapping 의 결과로 둡니다.

   비동기 장치 검색을 지원해야 합니다.

6. UA가 LE 전송을 지원한다면 General Discovery Procedure 를 수행하되, Discoverable Mode 플래그가 설정되지 않은 장치도 포함할 수 있으며, 발견된 Bluetooth device 들을 nearbyDevices 에 추가합니다. UA는 Privacy Feature 를 활성화해야 합니다(SHOULD).

   passive scanning 과 Privacy Feature 는 모두 고유하고 불변인 장치 ID 누출을 방지합니다. UA가 둘 중 하나를 사용하도록 요구하는 것이 바람직하지만, OS API가 이를 노출하지 않는 것으로 보입니다. 또한 Bluetooth는 Central 장치가 Observation Procedure 를 지원하도록 요구하지 않기 때문에 passive scanning 사용을 어렵게 합니다.

7. UA가 BR/EDR 전송을 지원한다면 Device Discovery Procedure 를 수행하고, 발견된 Bluetooth device 들을 nearbyDevices 에 추가합니다.

   모든 형태의 BR/EDR 조회/검색은 고유하고 불변인 장치 주소를 누출하는 것으로 보입니다.

8. result 를 비어 있는 Bluetooth device 의 집합으로 둡니다.

9. nearbyDevices 및 simulatedBluetoothDevices 내의 각 Bluetooth device device 에 대해 다음 하위 단계를 수행합니다:

   1. device 의 supported physical transports 에 LE가 포함되어 있고, Bluetooth Device Name 이 부분적이거나 없으면, UA는 완전한 이름을 얻기 위해 Name Discovery Procedure 를 수행해야 합니다(SHOULD).

   2. device 가 광고하는 Service UUIDs 가 Service UUIDs 집합과 공통 원소를 가진다면(공집합이 아니라면), device 를 result 에 추가하고 이 하위 단계를 중단합니다.

      참고: BR/EDR 장치의 경우 Extended Inquiry Response 에서 GATT와 비-GATT 서비스를 구분할 방법이 없습니다. 사이트가 비-GATT 서비스의 UUID로 필터링하면, 사용자가 이 API로는 상호작용할 방법이 없는 장치를 requestDevice 결과로 선택할 수 있습니다.

   3. UA는 device 에 연결하고, UUID가 Service UUIDs 집합에 속하는 모든 Service 로 Bluetooth 캐시를 채우기 할 수 있습니다. device 의 supported physical transports 에 BR/EDR이 포함된다면, 표준 GATT 절차에 더해 캐시를 채우는 동안 Service Discovery Protocol(Searching for Services)을 사용할 수 있습니다.

      참고: 주변의 모든 장치에 연결해 서비스를 발견하는 과정은 전력을 소모하고 Bluetooth 라디오의 다른 사용을 지연시킬 수 있습니다. UA는 해당 장치가 흥미로울 이유가 있는 경우에만 추가 서비스를 발견해야 합니다.

      또한 UA는 개발자가 이러한 추가 발견 동작에 의존하지 않도록 도와야 합니다. 예를 들어, 개발자가 이전에 특정 장치에 연결하여, UA가 그 장치가 지원하는 모든 서비스 집합을 알고 있는 경우를 생각해봅시다. 이후 개발자가 광고되지 않은 UUID로 필터링하면, 사용자 기기에서는 필터가 해당 장치를 제외할 가능성이 높음에도 개발자에게 표시되는 대화상자에는 그 장치가 포함될 수 있습니다. UA는 이러한 상황에서 경고하거나, 필터 일치 시 광고된 서비스만 포함하도록 하는 개발자 옵션을 제공할 수 있습니다.

   4. Bluetooth cache 에 device 내부의, UUID가 Service UUIDs 집합에 속하는 존재가 확인된(known-present) Service 가 포함되어 있으면, UA는 device 를 result 에 추가할 수 있습니다.

10. 스캔의 결과로 result 를 반환합니다.

1. grantedServiceUUIDs 를 새 Set 으로 둡니다.

2. requiredServiceUUIDs 의 내용을 grantedServiceUUIDs 에 추가합니다.

3. optionalServiceUUIDs 의 내용을 grantedServiceUUIDs 에 추가합니다.

4. storage.allowedDevices 내에서, device 가 allowedDevice@[[device]] 와 동일한 요소 allowedDevice 를 찾습니다. 발견되면 다음 하위 단계를 수행합니다:

   1. allowedDevice.allowedServices 의 내용을 grantedServiceUUIDs 에 추가합니다.

   발견되지 않으면 다음 하위 단계를 수행합니다:

   1. allowedDevice.deviceId 를 고유 ID로 둡니다. 단, UA가 두 Bluetooth 연결이 동일한 장치인지 판별할 수 있는 한에서, 그리고 사용자가 그 사실을 스크립트에 노출하기를 원하는 범위 내에서만 고유해야 합니다.

5. allowedDevice.allowedServices 를 grantedServiceUUIDs 로 설정합니다.

6. allowedDevice.mayUseGATT 를 true 로 설정합니다.

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

2. global 의 연결된 Document 가 "bluetooth" 라는 정책 제어 기능 을 사용할 수 없음 이라면, 전역 작업을 대기 시켜 global 를 주고 resolve 하여 promise 를 false 로 이행하고, 이 단계를 중단합니다.

3. 사용자가 현재 오리진에 대해 이 함수의 반환값을 특정 값으로 구성해 둔 경우, 작업을 대기 시켜 구성된 값으로 resolve 하여 promise 를 이행하고, 이 단계를 중단합니다.

   참고: 사용자가 Web Bluetooth 권한을 차단한 경우, UA는 resolve 로 promise 를 false 로 이행할 수 있습니다.

4. simulatedBluetoothAdapter 를 this 의 navigable 의 최상위 트래버서블 의 simulated Bluetooth adapter 로 둡니다.

5. simulatedBluetoothAdapter 가 비어 있지 않다면,

   1. simulatedBluetoothAdapter 의 어댑터 상태 가 "absent" 이면, 전역 작업을 대기 시켜 global 를 주고 resolve 하여 promise 를 false 로 이행합니다.

   2. simulatedBluetoothAdapter 의 LE supported state 가 false 이면, 전역 작업을 대기 시켜 global 를 주고 resolve 하여 promise 를 false 로 이행합니다.

   3. 그 외의 경우, 전역 작업을 대기 시켜 global 를 주고 resolve 하여 promise 를 true 로 이행합니다.

   4. 이 단계를 중단합니다.

6. UA가 블루투스 라디오가 있는 시스템에서 실행 중인 경우, 블루투스 라디오의 전원 상태와 무관하게, 전역 작업을 대기 시켜 Bluetooth 작업 소스 에 global 를 주고 resolve 하여 promise 를 true 로 이행합니다.

7. 그렇지 않다면, 전역 작업을 대기 시켜 Bluetooth 작업 소스 에 global 를 주고 resolve 하여 promise 를 false 로 이행합니다.

   참고: UA가 블루투스 사용 가능 여부를 판단하기 위해 다른 시스템을 조회할 수 있도록, 프라미스는 병렬로 이행됩니다.

1. storage를 BluetoothPermissionStorage 로 두되, "bluetooth"의 extra permission data이며, 대상은 current settings object입니다.

2. storage.allowedDevices 에서 allowedDevice.[[device]] 가 device와 same device인 allowedDevice를 찾습니다. 그러한 객체가 없으면 SecurityError 를 던지고 단계를 중단합니다.

3. context.[[deviceInstanceMap]] 에 device와 same device인 키가 없다면, 다음 하위 단계를 수행합니다:

   1. result를 BluetoothDevice 의 새 인스턴스로 둡니다.

   2. result의 모든 선택적 필드를 null로 초기화합니다.

   3. result.[[context]] 를 context로 초기화합니다.

   4. result.[[representedDevice]] 를 device로 초기화합니다.

   5. result.id를 allowedDevice.deviceId 로 초기화하고, result.[[allowedServices]] 를 allowedDevice.allowedServices 로 초기화합니다.

   6. device에 부분 또는 전체 Bluetooth Device Name이 있으면, result.name을 해당 문자열로 설정합니다.

   7. result.watchingAdvertisements를 false로 초기화합니다.

   8. context.[[deviceInstanceMap]] 에 device에서 result로의 매핑을 추가합니다.

4. context.[[deviceInstanceMap]] 에서 키가 device와 same device인 값을 반환합니다.

1. "bluetooth"의 extra permission data가 this의 relevant settings object에 대해, 그 allowedDevices 목록 안에 allowedDevice.[[device]] 가 this.[[representedDevice]] 와 same device이고, allowedDevice.mayUseGATT 가 true라면, this.[[gatt]] 를 반환합니다.

2. 그렇지 않으면 null을 반환합니다.

1. device를 대상 BluetoothDevice 객체로 둡니다.

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

3. device를 storage에서 제거합니다. 이때 storage를 사용합니다.

4. Resolve 하여 promise를 이행합니다.

1. global을 relevant global object로 둡니다. 대상은 this입니다.

2. options.signal 이 존재한다면 다음 하위 단계를 수행합니다:

   1. options.signal 이 aborted 상태라면, abort watchAdvertisements를 this로 실행하고 단계를 중단합니다.

   2. 다음 중단 단계를 추가합니다. 대상: options.signal:

      1. Abort watchAdvertisements를 this로 실행합니다.

      2. Reject 하여 promise를 AbortError로 거부합니다.

3. this.[[watchAdvertisementsState]] 가 다음 중 하나인 경우:

   'not-watching'

   1. this.[[watchAdvertisementsState]] 를 'pending-watch'로 설정합니다.

   2. 다음 단계를 큐에 넣어 watch advertisements manager에 전달합니다. 단, this.[[watchAdvertisementsState]] 가 not-watching이 되면 중단합니다:

      1. UA가 이 장치의 광고를 스캔하고 있음을 보장합니다. UA는 동일 장치의 "중복" 광고를 필터링하지 않아야 합니다(SHOULD NOT).

      2. UA가 스캔 활성화에 실패하면, 전역 작업을 대기시켜 Bluetooth task source에 global을 주고 다음 단계를 수행한 뒤, 이 단계를 중단합니다:

         1. this.[[watchAdvertisementsState]] 를 'not-watching'으로 설정합니다.

         2. Reject 하여 promise를 다음 오류 중 하나로 거부합니다:

            UA가 광고 스캔을 지원하지 않음

            NotSupportedError

            Bluetooth가 꺼져 있음

            InvalidStateError

            기타 사유

            UnknownError

      3. 전역 작업을 대기시켜 Bluetooth task source에 global을 주고 다음 단계를 수행합니다. 단, abort when this.[[watchAdvertisementsState]] 가 not-watching이 되는 경우 중단합니다:

         1. this.[[watchAdvertisementsState]] 를 watching으로 설정합니다.

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

         3. Resolve 하여 promise를 undefined로 이행합니다.

   'pending-watch'

   1. Reject 하여 promise를 InvalidStateError로 거부합니다.

   'watching'

   1. Resolve 하여 promise를 undefined로 이행합니다.

4. If aborted인 경우, reject 하여 promise를 AbortError로 거부합니다.

Note: 스캔은 전력을 소모하므로 웹사이트는 불필요하게 광고를 관찰하지 않도록 해야 하며, 가능한 빨리 전력 사용을 중지하기 위해 AbortController를 사용해야 합니다.

1. this.[[watchAdvertisementsState]] 를 'not-watching'으로 설정합니다.

2. device.watchingAdvertisements 를 false로 설정합니다.

3. 다음 단계를 큐에 넣어 watch advertisements manager에 전달합니다:

   1. UA 전체에서 더 이상 어떤 BluetoothDevice 도 watchingAdvertisements 가 true가 아니라면, UA는 광고 스캔을 중지해야 합니다(SHOULD). 그렇지 않고, this와 동일한 장치를 나타내는 BluetoothDevice 들 중 더 이상 watchingAdvertisements 가 true인 것이 없다면, UA는 이 장치에 대한 리포트를 받지 않도록 스캔을 재구성해야 합니다.

1. For each device in bluetooth.[[deviceInstanceMap]] 에 대해 다음 단계를 수행합니다:

   1. device.[[watchAdvertisementsState]] 가 pending-watch 또는 watching이라면, abort watchAdvertisements를 device로 실행합니다.

1. [BLUETOOTH42]가 충분한 정보를 반환한다고 명시한 임의의 GATT 절차 시퀀스를 사용하여, 캐시의 모든 일치 항목을 known-present 또는 known-absent로 만들도록 시도합니다. 오류는 § 6.7 오류 처리에 설명된 대로 처리합니다.

2. 이전 단계가 오류를 반환하면, 이 알고리즘에서도 그 오류를 반환합니다.

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

2. 해당 설명과 일치하는 항목으로 Bluetooth cache를 채웁니다.

3. 이전 단계가 오류를 반환하면, 전역 작업을 대기시켜 Bluetooth 작업 소스에서 global을 주고 reject로 promise를 해당 오류로 거부하고, 이 단계를 중단합니다.

4. entries를 설명과 일치하는 known-present 캐시 항목들의 시퀀스로 둡니다.

5. context를 deviceObj.[[context]]로 둡니다.

6. result를 새로운 시퀀스로 둡니다.

7. entries의 각 entry에 대해:

   1. 만약 context.[[attributeInstanceMap]]에 Promise<BluetoothGATT*> 인스턴스가 entry에 연관되어 있지 않다면, entry가 Service, Characteristic, Descriptor인지에 따라 BluetoothRemoteGATTService representing 생성, BluetoothRemoteGATTCharacteristic representing 생성, 또는 BluetoothRemoteGATTDescriptor representing 생성을 수행하고, 결과 Promise에 대한 entry → Promise 매핑을 context.[[attributeInstanceMap]]에 추가합니다.

   2. context.[[attributeInstanceMap]]에서 entry에 연관된 Promise<BluetoothGATT*> 인스턴스를 result에 추가합니다.

8. 전역 작업을 대기시켜 Bluetooth 작업 소스에서 global을 주고, resolve로 result의 모든 요소를 모두 대기한 결과로 promise를 이행합니다.

BluetoothDevice

obj.[[representedDevice]]

BluetoothRemoteGATTService

obj.[[representedService]]

BluetoothRemoteGATTCharacteristic

obj.[[representedCharacteristic]]

BluetoothRemoteGATTDescriptor

obj.[[representedDescriptor]]

1. uuid가 존재하면, uuidCanonicalizer(uuid)의 결과로 설정합니다. uuidCanonicalizer가 예외를 던졌다면, 해당 예외로 거부된 프라미스를 반환하고 이 단계를 중단합니다.

2. uuid가 존재하고 blocklisted라면, SecurityError로 거부된 프라미스를 반환하고 이 단계를 중단합니다.

3. attribute의 타입에 따라 deviceObj를 다음과 같이 둡니다:

   BluetoothDevice

   attribute

   BluetoothRemoteGATTService

   attribute.device

   BluetoothRemoteGATTCharacteristic

   attribute.service.device

4. deviceObj.gatt.connected 가 false이면, NetworkError로 거부된 프라미스를 반환하고 이 단계를 중단합니다.

5. Represented(attribute)가 null이면, InvalidStateError로 거부된 프라미스를 반환하고 이 단계를 중단합니다.

   참고: 이는 Service나 Characteristic이 장치에서 제거되었거나 연결 해제로 무효화되었는데, 그 객체를 다시 사용한 경우에 발생합니다.

6. deviceObj의 Bluetooth cache 질의를 수행하여, 다음을 만족하는 항목을 찾습니다:

   • Represented(attribute) 내부에 있고,

   • child type가 기술하는 타입을 가지며,

   • UUID가 blocklisted가 아니고,

   • uuid가 존재하면, 그 UUID가 uuid이며,

   • allowedUuids가 존재하고 "all"이 아니라면, UUID가 allowedUuids에 포함되고,

   • single 플래그가 설정되었다면, 이들 중 첫 번째여야 합니다.

   promise를 결과로 둡니다.

7. 이행 시 promise가 result로 이행되면, 다음을 수행합니다:

   • result가 비어 있으면, NotFoundError를 던집니다.

   • 그 외에, single 플래그가 설정되어 있으면 result의 첫 번째(유일한) 요소를 반환합니다.

   • 그 외에는 result를 반환합니다.

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

2. 만약 this.device.[[representedDevice]]가 null이라면, "NetworkError" DOMException으로 거부된 프라미스를 반환합니다.

3. UA가 현재 Bluetooth 시스템을 사용 중이라면, "NetworkError" DOMException으로 거부된 프라미스를 반환할 수 있습니다(MAY).

   구현체는 이 NetworkError를 피할 수 있을지도 모르지만, 현재로서는 사이트가 이 API의 사용을 직렬화하고 실패한 동작을 재시도할 수 있는 방법을 사용자에게 제공할 필요가 있습니다. [Issue #188]

4. promise를 새 프라미스로 둡니다.

5. this.connected가 true이면, resolve로 promise를 this로 이행하고 promise를 반환합니다.

6. this.[[activeAlgorithms]]에 promise를 추가합니다.

7. 다음 단계를 병렬로 수행합니다:

   1. 만약 global의 navigable의 top-level traversable의 simulated Bluetooth adapter가 비어 있지 않다면, 다음 단계를 수행합니다:

      1. gatt connection attempted 이벤트 트리거를 global의 navigable과 this.device를 주어 수행합니다.

      2. this.[[automatedGATTConnectionResponse]]가 "not-expected"라면, "expected"로 설정합니다.

      3. this.[[automatedGATTConnectionResponse]]가 "expected"이면, 값이 변경될 때까지 대기합니다.

      4. response를 this.[[automatedGATTConnectionResponse]]의 값으로 둡니다.

      5. this.[[automatedGATTConnectionResponse]]를 "not-expected"로 설정합니다.

      6. response가 0이 아니면, 다음 하위 단계를 수행합니다:

         1. this.[[activeAlgorithms]]에서 promise를 제거합니다.

         2. 전역 작업을 대기시켜 Bluetooth 작업 소스에서 global을 주고 "NetworkError" DOMException으로 reject하여 promise를 거부하고, 이 단계를 중단합니다.

   2. 그 외의 경우, 다음 단계를 수행합니다:

      1. this.device.[[representedDevice]]에 ATT Bearer가 없으면, 다음 하위 단계를 수행합니다:

         1. ATT Bearer 생성을 시도하며, GAP Interoperability Requirements의 "Connection Establishment"에 설명된 절차를 사용합니다. this.[[activeAlgorithms]]에서 promise가 제거되면 이 시도를 중단합니다.

            참고: 연결 가능한 광고를 수신하지 않으면 이 절차는 영원히 대기할 수 있습니다. 더 이상 연결을 원하지 않으면 웹사이트는 disconnect()를 호출해야 합니다.

         2. 이 시도가 this.[[activeAlgorithms]]에서 promise가 제거되어 중단되었다면, 전역 작업을 대기시켜 Bluetooth 작업 소스에서 global을 주고 "AbortError" DOMException으로 reject하여 promise를 거부하고, 이 단계를 중단합니다.

         3. 다른 이유로 이 시도가 실패했다면, 전역 작업을 대기시켜 Bluetooth 작업 소스에서 global을 주고 "NetworkError" DOMException으로 reject하여 promise를 거부하고, 이 단계를 중단합니다.

         4. Exchange MTU 절차를 사용하여 지원되는 가장 큰 MTU를 협상합니다. 이 단계의 오류는 무시합니다.

         5. UA는 BR/EDR Bonding Procedure 또는 LE Bonding Procedure를 사용하여 원격 장치와의 결합을 시도할 수 있습니다(MAY).

            참고: 일반적으로는 결합 여부 및 시점에 대한 제어를 웹사이트에 제공하는 것이 더 바람직하지만, Core Bluetooth 플랫폼 API는 UA가 그러한 설정을 구현할 방법을 제공하지 않습니다. 결합이 없는 것보다 결합이 있는 것이 더 안전하므로, 이 명세는 가능한 플랫폼에서 UA가 기회적으로 결합을 생성하도록 허용합니다. 이는 제한된 characteristic에 접근할 때가 아니라 연결이 생성될 때 사용자에게 표시되는 페어링 대화상자를 유발할 수 있습니다.

   3. 전역 작업을 대기시켜 Bluetooth 작업 소스에서 global을 주고 다음 하위 단계를 수행합니다:

      1. this.[[activeAlgorithms]]에 promise가 없다면, "AbortError" DOMException으로 reject하여 promise를 거부하고, garbage-collect the connection을 this.device.[[representedDevice]]에 대해 수행하고, 이 단계를 중단합니다.

      2. this.[[activeAlgorithms]]에서 promise를 제거합니다.

      3. this.device.[[representedDevice]]가 null이면, "NetworkError" DOMException으로 reject하여 promise를 거부하고, garbage-collect the connection을 this.device.[[representedDevice]]에 대해 수행하고, 이 단계를 중단합니다.

      4. this.connected를 true로 설정합니다.

      5. Resolve로 promise를 this로 이행합니다.

8. promise를 반환합니다.

1. 활성 connect() 호출을 중단시키기 위해 this.[[activeAlgorithms]]를 비웁니다.

2. this.connected가 false이면, 이 단계를 중단합니다.

3. Clean up the disconnected device를 this.device에 대해 수행합니다.

4. device를 this.device.[[representedDevice]]로 둡니다.

5. Garbage-collect the connection을 device에 대해 수행합니다.

1. UA 안팎에서 이 API를 사용하지 않는 시스템이 device의 ATT Bearer를 사용 중이라면, 이 알고리즘을 중단합니다.

2. UA 전체의 모든 BluetoothDevice deviceObj에 대해:

   1. deviceObj.[[representedDevice]]가 device와 same device가 아니면, 다음 deviceObj로 넘어갑니다.

   2. deviceObj.gatt.connected가 true이면, 이 알고리즘을 중단합니다.

   3. deviceObj.gatt.[[activeAlgorithms]]에 Promise가 포함되어 있고 그 Promise가 connect() 호출에서 온 것이라면, 이 알고리즘을 중단합니다.

3. device의 ATT Bearer를 파기합니다.

promise 주위에 gattServer-connection-checking wrapper를 생성하려면, UA는 다음을 수행해야 합니다:

1. gattServer.connected가 true이면, promise를 gattServer.[[activeAlgorithms]]에 추가합니다.

2. 프라미스가 정착(settled)되면 반응합니다:

   • promise가 result로 이행되었다면:

     1. 만약 promise가 gattServer.[[activeAlgorithms]]에 있다면, 이를 제거하고 result를 반환합니다.

     2. 그렇지 않다면, NetworkError를 던집니다.

        참고: 이 오류는 메인 알고리즘 실행 중에 gattServer가 연결 해제되었기 때문에 던져집니다.

   • promise가 error로 거부되었다면:

     1. 만약 promise가 gattServer.[[activeAlgorithms]]에 있다면, 이를 제거하고 error를 던집니다.

     2. 그렇지 않다면, NetworkError를 던집니다.

        참고: 이 오류는 메인 알고리즘 실행 중에 gattServer가 연결 해제되었기 때문에 던져집니다.

1. this.device.[[allowedServices]]가 "all"이 아니고, service가 this.device.[[allowedServices]]에 없다면, SecurityError로 거부된 프라미스를 반환하고 이 단계를 중단합니다.

2. GetGATTChildren(attribute=this.device,
   single=true,
   uuidCanonicalizer=BluetoothUUID.getService,
   uuid=service,
   allowedUuids=this.device.[[allowedServices]],
   child type="GATT Primary Service")를 반환합니다

1. this.device.[[allowedServices]]가 "all"이 아니고, service가 존재하며 this.device.[[allowedServices]]에 없다면, SecurityError로 거부된 프라미스를 반환하고 이 단계를 중단합니다.

2. GetGATTChildren(attribute=this.device,
   single=false,
   uuidCanonicalizer=BluetoothUUID.getService,
   uuid=service,
   allowedUuids=this.device.[[allowedServices]],
   child type="GATT Primary Service")를 반환합니다

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

2. promise 를 새 프라미스로 둡니다.

3. 다음 단계를 병렬로 수행합니다:

   1. result 를 BluetoothRemoteGATTService 의 새 인스턴스로 두고, 그 [[representedService]] 슬롯을 service 로 초기화합니다.

   2. BluetoothDevice representing 가져오기를 수행하여 service 가 나타나는 장치의 객체를 얻고, 이를 device 로 둡니다.

   3. 이전 단계에서 오류가 발생했다면, 전역 작업을 대기시켜 Bluetooth 작업 소스에서 global 을 주고 그 오류로 reject 하여 promise 를 거부하고, 이 단계를 중단합니다.

   4. result.device 를 device 로 초기화합니다.

   5. result.uuid 를 service 의 UUID로 초기화합니다.

   6. service 가 Primary Service 이면 result.isPrimary 를 true 로, 그렇지 않으면 result.isPrimary 를 false 로 초기화합니다.

   7. 전역 작업을 대기시켜 Bluetooth 작업 소스에서 global 을 주고 resolve 하여 promise 를 result 로 이행합니다.

4. promise 를 반환합니다.

GetGATTChildren(attribute=this,
single=true,
uuidCanonicalizer=BluetoothUUID.getCharacteristic,
uuid=characteristic,
allowedUuids=undefined,
child type="GATT Characteristic")

GetGATTChildren(attribute=this,
single=false,
uuidCanonicalizer=BluetoothUUID.getCharacteristic,
uuid=characteristic,
allowedUuids=undefined,
child type="GATT Characteristic")

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

2. promise 를 새 프라미스로 둡니다.

3. 다음 단계를 병렬로 수행합니다:

   1. result 를 BluetoothRemoteGATTCharacteristic 의 새 인스턴스로 두고, 그 [[representedCharacteristic]] 슬롯을 characteristic 으로 초기화합니다.

   2. result.service< 를 BluetoothRemoteGATTService 인스턴스에서 초기화하는데, 이는 characteristic 이 나타나는 Service 를 나타냅니다.

   3. result.uuid 를 characteristic 의 UUID로 초기화합니다.

   4. Characteristic 로부터 BluetoothCharacteristicProperties 인스턴스 생성을 수행하고, 결과를 properties 로 둡니다.

   5. 이전 단계가 오류를 반환했다면, 전역 작업을 대기시켜 Bluetooth 작업 소스에서 global 을 주고 그 오류로 reject 하여 promise 를 거부하고, 이 단계를 중단합니다.

   6. result.properties 를 properties 로 초기화합니다.

   7. result.value 를 null 로 초기화합니다. UA는 (이 값이 사용 가능하다면) characteristic 으로부터 가장 최근에 읽은 값을 담은 new DataView 가 new ArrayBuffer 를 감싸도록 하여 result.value 를 초기화할 수 있습니다(MAY).

   8. 전역 작업을 대기시켜 Bluetooth 작업 소스에서 global 을 주고 resolve 하여 promise 를 result 로 이행합니다.

4. promise 를 반환합니다.

GetGATTChildren(attribute=this,
single=true,
uuidCanonicalizer=BluetoothUUID.getDescriptor,
uuid=descriptor,
allowedUuids=undefined,
child type="GATT Descriptor")

GetGATTChildren(attribute=this,
single=false,
uuidCanonicalizer=BluetoothUUID.getDescriptor,
uuid=descriptor,
allowedUuids=undefined,
child type="GATT Descriptor")

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

2. gatt 를 this.service.device.gatt 로 둡니다.

3. this.uuid 가 blocklisted for reads 에 해당하면, "SecurityError" DOMException 으로 거부된 프라미스 를 반환하고 이 단계를 중단합니다.

4. gatt.connected 가 false 이면, "NetworkError" DOMException 으로 거부된 프라미스 를 반환하고 이 단계를 중단합니다.

5. characteristic 를 this.[[representedCharacteristic]] 로 둡니다.

6. characteristic 이 null 이면, "InvalidStateError" DOMException 으로 거부된 프라미스 를 반환하고 이 단계를 중단합니다.

7. gatt-connection-checking wrapper 로 감싼 새 프라미스 promise 를 반환하고, 다음 단계를 병렬로 수행합니다:

   1. characteristic 의 properties 에 Read 비트가 설정되어 있지 않다면, 전역 작업을 대기시켜 Bluetooth 작업 소스에서 global 을 주고 "NotSupportedError" DOMException 으로 reject 하여 promise 를 거부하고 이 단계를 중단합니다.

   2. global 의 navigable 의 top-level traversable 의 simulated Bluetooth adapter 가 비어 있지 않다면, 다음 단계를 수행합니다:

      1. Trigger a simulated characteristic event 를 수행하되, global 의 navigable, this.device, characteristic, read 를 인수로 제공합니다.

      2. this.[[automatedCharacteristicReadResponse]] 를 "expected" 로 설정하고, 변경될 때까지 대기합니다.

      3. response 를 this.[[automatedCharacteristicReadResponse]] 의 값으로 둡니다.

      4. this.[[automatedCharacteristicReadResponse]] 를 "not-expected" 로 설정합니다.

      5. response 가 0 이 아니면, 다음 하위 단계를 수행합니다:

         1. 전역 작업을 대기시켜 Bluetooth 작업 소스에서 global 을 주고 "NetworkError" DOMException 으로 reject 하여 promise 를 거부하고 이 단계를 중단합니다.

      6. 그렇지 않으면, buffer 를 new ArrayBuffer 로 두되, 그 내용은 this.[[automatedCharacteristicReadResponseData]] 가 되도록 합니다.

   3. 그 외의 경우(시뮬레이션이 아닌 경우), 다음 단계를 수행합니다:

      1. UA가 현재 Bluetooth 시스템을 사용 중이라면, 전역 작업을 대기시켜 Bluetooth 작업 소스에서 global 을 주고 "NetworkError" DOMException 으로 reject 하여 promise 를 거부하고 이 단계를 중단할 수 있습니다(MAY).

         구현에서는 이 NetworkError 를 피할 수 있을 수도 있지만, 현재로서는 사이트가 이 API 사용을 직렬화하거나 실패한 작업을 재시도할 방법을 사용자에게 제공해야 합니다. [Issue #188]

      2. Characteristic Value Read 절차의 하위 절차들을 임의로 조합하여 characteristic 의 값을 가져오고, 그 값을 담은 new ArrayBuffer 를 buffer 로 둡니다. 오류 처리는 § 6.7 오류 처리 에 따라 수행합니다.

   4. 전역 작업을 대기시켜 Bluetooth 작업 소스에서 global 을 주고 다음 단계를 수행합니다:

      1. promise 가 gatt.[[activeAlgorithms]] 에 없다면, "NetworkError" DOMException 으로 reject 하여 promise 를 거부하고 이 단계를 중단합니다.

      2. 위 하위 절차들이 오류를 반환했다면, 해당 오류로 reject 하여 promise 를 거부하고 이 단계를 중단합니다.

      3. new DataView 를 buffer 로 생성하여 this.value 에 할당합니다.

      4. 이벤트를 발생시키되, 이름은 "characteristicvaluechanged" 이고 bubbles 속성은 true 로 초기화하여 this 에서 발생시킵니다.

      5. Resolve 하여 promise 를 this.value 로 이행합니다.

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

2. gatt 를 this.service.device.gatt 로 둡니다.

3. this.uuid 가 blocklisted for writes 에 해당하면, "SecurityError" DOMException 으로 거부된 프라미스 를 반환하고 이 단계를 중단합니다.

4. bytes 를 value 가 보유한 바이트의 복사본으로 둡니다.

5. bytes 의 길이가 512 바이트를 초과하면( Long Attribute Values 에 따른 속성 값의 최대 길이), "InvalidModificationError" DOMException 으로 거부된 프라미스 를 반환하고 이 단계를 중단합니다.

6. gatt.connected 가 false 이면, "NetworkError" DOMException 으로 거부된 프라미스 를 반환하고 이 단계를 중단합니다.

7. characteristic 를 this.[[representedCharacteristic]] 로 둡니다.

8. characteristic 이 null 이면, "InvalidStateError" DOMException 으로 거부된 프라미스 를 반환하고 이 단계를 중단합니다.

9. gatt-connection-checking wrapper 로 감싼 새 프라미스 promise 를 반환하고, 다음 단계를 병렬로 수행합니다.

   1. Assert: response 는 "required", "never", "optional" 중 하나입니다.

   2. global 의 navigable 의 top-level traversable 의 simulated Bluetooth adapter 가 비어 있지 않다면, 다음 단계를 수행합니다:

      1. this.[[automatedCharacteristicWriteResponse]] 가 "not-expected" 가 아니라면, 전역 작업을 대기시켜 Bluetooth 작업 소스에서 global 을 주고 "InvalidStateError" DOMException 으로 reject 하여 promise 를 거부하고 이 단계를 중단합니다.

      2. Trigger a simulated characteristic event 를 수행하되, global 의 navigable, this.device, characteristic, write, bytes 를 인수로 제공합니다.

      3. this.[[automatedCharacteristicWriteResponse]] 를 "expected" 로 설정하고, 변경될 때까지 대기합니다.

      4. response 를 this.[[automatedCharacteristicWriteResponse]] 의 값으로 둡니다.

      5. this.[[automatedCharacteristicWriteResponse]] 를 "not-expected" 로 설정합니다.

      6. response 가 0 이 아니면, 다음 하위 단계를 수행합니다:

         1. 전역 작업을 대기시켜 Bluetooth 작업 소스에서 global 을 주고 "NetworkError" DOMException 으로 reject 하여 promise 를 거부하고 이 단계를 중단합니다.

   3. 그 외의 경우(시뮬레이션이 아닌 경우), 다음 단계를 수행합니다:

      1. UA가 현재 Bluetooth 시스템을 사용 중이라면, 전역 작업을 대기시켜 Bluetooth 작업 소스에서 global 을 주고 "NetworkError" DOMException 으로 reject 하여 promise 를 거부하고 이 단계를 중단할 수 있습니다(MAY).

         구현에서는 이 NetworkError 를 피할 수 있을 수도 있지만, 현재로서는 사이트가 이 API 사용을 직렬화하거나 실패한 작업을 재시도할 방법을 사용자에게 제공해야 합니다. [Issue #188]

      2. bytes 를 characteristic 에 쓰기 위해 다음을 수행합니다:

         response 가 "required" 인 경우

         Write Characteristic Value 절차를 사용합니다.

         response 가 "never" 인 경우

         Write Without Response 절차를 사용합니다.

         그 외의 경우

         Characteristic Value Write 절차의 하위 절차들을 임의로 조합하여 사용합니다.

         오류 처리는 § 6.7 오류 처리 에 따라 수행합니다.

   4. 전역 작업을 대기시켜 global 에서 Bluetooth 작업 소스를 사용하여 다음 단계를 수행합니다:

      1. promise 가 gatt.[[activeAlgorithms]] 에 없다면, "NetworkError" DOMException 으로 reject 하여 promise 를 거부하고 이 단계를 중단합니다.

      2. 위 절차가 오류를 반환했다면, 그 오류로 reject 하여 promise 를 거부하고 이 단계를 중단합니다.

      3. this.value 를 new DataView 로 설정하되, 이는 new ArrayBuffer 가 bytes 를 포함하도록 감싼 것입니다.

      4. Resolve 하여 promise 를 undefined 로 이행합니다.

WriteCharacteristicValue( this=this,
value=value,
response="required")

WriteCharacteristicValue( this=this,
value=value,
response="never")

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

2. gatt 를 this.service.device.gatt 로 둡니다.

3. this.uuid 가 blocklisted for reads 에 해당하면, "SecurityError" DOMException 으로 거부된 프라미스 를 반환합니다.

4. gatt.connected 가 false 이면, "NetworkError" DOMException 으로 거부된 프라미스 를 반환합니다.

5. characteristic 를 this.[[representedCharacteristic]] 로 둡니다.

6. characteristic 이 null 이면, "InvalidStateError" DOMException 으로 거부된 프라미스 를 반환합니다.

7. gatt-connection-checking wrapper 로 감싼 새 프라미스 promise 를 반환하고, 다음 단계를 병렬로 수행합니다.

   1. characteristic 의 properties 에 Notify 와 Indicate 비트가 모두 설정되어 있지 않다면, 전역 작업을 대기시켜 Bluetooth 작업 소스에서 global 을 주고 NotSupportedError 로 reject 하여 promise 를 거부하고 이 단계를 중단합니다.

   2. characteristic 의 active notification context set 에 navigator.bluetooth 가 포함되어 있다면, 전역 작업을 대기시켜 Bluetooth 작업 소스에서 global 을 주고 resolve 하여 promise 를 this 로 이행하고 이 단계를 중단합니다.

   3. global 의 navigable 의 top-level traversable 의 simulated Bluetooth adapter 가 비어 있지 않다면, 다음 단계를 수행합니다:

      1. this.[[automatedCharacteristicSubscribeToNotificationsResponse]] 가 "not-expected" 가 아니라면, 전역 작업을 대기시켜 Bluetooth 작업 소스에서 global 을 주고 "InvalidStateError" DOMException 으로 reject 하여 promise 를 거부하고 이 단계를 중단합니다.

      2. Trigger a simulated characteristic event 를 수행하되, global 의 navigable, this.device, characteristic, subscribe-to-notifications 를 인수로 제공합니다.

      3. this.[[automatedCharacteristicSubscribeToNotificationsResponse]] 를 "expected" 로 설정하고, 변경될 때까지 대기합니다.

      4. response 를 this.[[automatedCharacteristicSubscribeToNotificationsResponse]] 의 값으로 둡니다.

      5. this.[[automatedCharacteristicSubscribeToNotificationsResponse]] 를 "not-expected" 로 설정합니다.

      6. response 가 0 이 아니면, 다음 하위 단계를 수행합니다:

         1. 전역 작업을 대기시켜 Bluetooth 작업 소스에서 global 을 주고 "NetworkError" DOMException 으로 reject 하여 promise 를 거부하고 이 단계를 중단합니다.

      7. 그렇지 않으면, success 를 true 로 둡니다.

   4. 그 외의 경우(시뮬레이션이 아닌 경우), 다음 단계를 수행합니다:

      1. UA가 현재 Bluetooth 시스템을 사용 중이라면, 전역 작업을 대기시켜 Bluetooth 작업 소스에서 global 을 주고 "NetworkError" DOMException 으로 reject 하여 promise 를 거부하고 이 단계를 중단할 수 있습니다(MAY).

         구현에서는 이 NetworkError 를 피할 수 있을 수도 있지만, 현재로서는 사이트가 이 API 사용을 직렬화하거나 실패한 작업을 재시도할 방법을 사용자에게 제공해야 합니다. [Issue #188]

      2. characteristic 에 Client Characteristic Configuration descriptor 가 있다면, Characteristic Descriptors 절차를 사용하여 characteristic 의 Client Characteristic Configuration descriptor 에서 Notification 또는 Indication 비트 중 하나가 설정되도록 해야 하며, 이는 characteristic 의 properties 의 제약과 일치해야 합니다. UA는 두 비트를 모두 설정하는 것을 피해야 하며(SHOULD), 두 비트가 모두 설정된 경우 value-change events 를 중복 제거해야 합니다(MUST). 오류 처리는 § 6.7 오류 처리 에 따라 수행합니다.

         Note: 일부 장치의 characteristic 은 properties 에 Notify 또는 Indicate 비트가 포함되지만 Client Characteristic Configuration descriptor 가 없는 경우가 있습니다. 이러한 표준 비준수 characteristic 은 일반적으로 무조건적으로 알림 또는 표시를 전송하므로, 이 명세는 애플리케이션이 해당 메시지를 단순히 구독하는 것을 허용합니다.

      3. 절차가 성공했다면, success 를 true 로 둡니다.

   5. success 가 true 이면, navigator.bluetooth 를 characteristic 의 active notification context set 에 추가합니다.

   6. 전역 작업을 대기시켜 Bluetooth 작업 소스에서 global 을 주고 다음 단계를 수행합니다:

      1. promise 가 gatt.[[activeAlgorithms]] 에 없다면, "NetworkError" DOMException 으로 reject 하여 promise 를 거부하고 이 단계를 중단합니다.

      2. 위 절차가 오류를 반환했다면, 그 오류로 reject 하여 promise 를 거부하고 이 단계를 중단합니다.

      3. Resolve 하여 promise 를 this 로 이행합니다.

1. characteristic 를 this.[[representedCharacteristic]] 로 둡니다.

2. characteristic 이 null 이면, 거부된 프라미스 를 InvalidStateError 로 반환하고 이 단계를 중단합니다.

3. characteristic 의 active notification context set 에 navigator.bluetooth 가 포함되어 있으면, 이를 제거합니다.

   1. global 의 navigable 의 top-level traversable 의 simulated Bluetooth adapter 가 비어 있지 않다면, 다음 단계를 수행합니다:

      1. this.[[automatedCharacteristicUnsubscribeFromNotificationsResponse]] 가 "not-expected" 가 아니라면, 전역 작업을 대기시켜 Bluetooth 작업 소스에서 global 을 주고 "InvalidStateError" DOMException 으로 reject 하여 promise 를 거부하고 이 단계를 중단합니다.

      2. Trigger a simulated characteristic event 를 수행하되, global 의 navigable, this.device, characteristic, unsubscribe-from-notifications 를 전달합니다.

      3. this.[[automatedCharacteristicUnsubscribeFromNotificationsResponse]] 를 "expected" 로 설정하고, 변경될 때까지 대기합니다.

      4. response 를 this.[[automatedCharacteristicUnsubscribeFromNotificationsResponse]] 의 값으로 둡니다.

      5. this.[[automatedCharacteristicUnsubscribeFromNotificationsResponse]] 를 "not-expected" 로 설정합니다.

      6. response 가 0 이 아니면, 다음 하위 단계를 수행합니다:

         1. 전역 작업을 대기시켜 Bluetooth 작업 소스에서 global 을 주고 "NetworkError" DOMException 으로 reject 하여 promise 를 거부하고 이 단계를 중단합니다.

   2. 그 외의 경우, 다음 단계를 수행합니다:

      1. characteristic 의 active notification context set 이 비게 되었고, 해당 characteristic 에 Client Characteristic Configuration descriptor 가 있다면, UA는 Characteristic Descriptors 절차 중 아무 것이나 사용하여 characteristic 의 Client Characteristic Configuration descriptor 에서 Notification 및 Indication 비트를 해제해야 합니다(SHOULD).

4. 전역 작업을 대기시켜 Bluetooth 작업 소스에서 this 의 관련 전역 객체를 주어 resolve 로 promise 를 this 로 이행합니다.

1. propertiesObj를 BluetoothCharacteristicProperties의 새로운 인스턴스로 둡니다.

2. properties를 characteristic의 특성 속성으로 둡니다.

3. propertiesObj의 속성들을 properties의 해당 비트로부터 초기화합니다:

   속성	비트
   broadcast	Broadcast
   read	Read
   writeWithoutResponse	Write Without Response
   write	Write
   notify	Notify
   indicate	Indicate
   authenticatedSignedWrites	Authenticated Signed Writes

4. 특성 속성의 Extended Properties 비트가 설정되어 있지 않다면, propertiesObj.reliableWrite와 propertiesObj.writableAuxiliaries를 false로 초기화합니다. 그렇지 않으면 다음 단계를 수행합니다:

   1. 탐색을 통해 Characteristic Extended Properties 디스크립터를 characteristic에 대해 찾고, 그 값을 읽어 extendedProperties에 담습니다. 오류 처리는 § 6.7 오류 처리에 따라 수행합니다.

      Characteristic Extended Properties가 주어진 Characteristic에 대해 확장 속성이 불변인지 명확하지 않습니다. 만약 불변이라면, UA가 이를 캐시하도록 허용되어야 합니다.

   2. 이전 단계가 오류를 반환했다면, 그 오류를 반환합니다.

   3. propertiesObj.reliableWrite를 extendedProperties의 Reliable Write 비트로부터 초기화합니다.

   4. propertiesObj.writableAuxiliaries를 extendedProperties의 Writable Auxiliaries 비트로부터 초기화합니다.

5. propertiesObj를 반환합니다.

1. promise를 새로운 프라미스로 둡니다.

2. 다음 단계를 병렬로 수행합니다:

   1. result를 BluetoothRemoteGATTDescriptor의 새 인스턴스로 두고, 그 [[representedDescriptor]] 슬롯을 descriptor로 초기화합니다.

   2. result.characteristic을 BluetoothRemoteGATTCharacteristic 인스턴스에서 초기화하되, 이는 descriptor가 나타나는 Characteristic을 나타냅니다.

   3. result.uuid를 descriptor의 UUID로부터 초기화합니다.

   4. result.value를 null로 초기화합니다. UA는 사용 가능한 경우, descriptor로부터 가장 최근에 읽은 값을 담은 new DataView가 new ArrayBuffer를 감싸도록 하여 result.value를 초기화할 수 있습니다(MAY).

   5. 전역 작업을 대기시켜 Bluetooth 작업 소스에서 this의 관련 전역 객체를 주어 resolve로 promise를 result로 이행시킵니다.

3. promise를 반환합니다.

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

2. gatt를 this.characteristic.service.device.gatt로 둡니다.

3. this.uuid가 읽기 블록리스트에 해당하면, "SecurityError" DOMException으로 거부된 프라미스를 반환합니다.

4. gatt.connected가 false이면, "NetworkError" DOMException으로 거부된 프라미스를 반환합니다.

5. descriptor를 this.[[representedDescriptor]]로 둡니다.

6. descriptor가 null이면, "InvalidStateError" DOMException으로 거부된 프라미스를 반환합니다.

7. connection-checking wrapper로 감싼 새 프라미스 promise를 gatt에 대해 반환하고, 다음 단계를 병렬로 수행합니다:

   1. global의 navigable의 top-level traversable의 simulated Bluetooth adapter가 비어 있지 않다면, 다음 단계를 수행합니다:

      1. this.[[automatedDescriptorReadResponse]]가 "not-expected"가 아니라면, 전역 작업을 대기시켜 Bluetooth 작업 소스에서 global을 주고 "InvalidStateError" DOMException으로 reject하여 promise를 거부하고 이 단계를 중단합니다.

      2. Trigger a simulated descriptor event를 수행하되, global의 navigable, this.device, descriptor, read를 전달합니다.

      3. this.[[automatedDescriptorReadResponse]]를 "expected"로 설정하고, 변경될 때까지 대기합니다.

      4. response를 this.[[automatedDescriptorReadResponse]]의 값으로 둡니다.

      5. this.[[automatedDescriptorReadResponse]]를 "not-expected"로 설정합니다.

      6. response가 0이 아니면, 다음 하위 단계를 수행합니다:

         1. 전역 작업을 대기시켜 Bluetooth 작업 소스에서 global을 주고 "NetworkError" DOMException으로 reject하여 promise를 거부하고 이 단계를 중단합니다.

      7. 그렇지 않으면, buffer를 new ArrayBuffer로 두되, 그 내용은 this.[[automatedDescriptorReadResponseData]]가 되도록 합니다.

   2. 그 외의 경우, 다음 단계를 수행합니다:

      1. UA가 현재 Bluetooth 시스템을 사용 중이라면, 전역 작업을 대기시켜 Bluetooth 작업 소스에서 global을 주고 "NetworkError" DOMException으로 reject하여 이 단계를 중단할 수 있습니다(MAY).

         구현에서는 이 NetworkError를 피할 수 있을 수도 있지만, 현재로서는 사이트가 이 API 사용을 직렬화하거나 실패한 작업을 재시도할 방법을 사용자에게 제공해야 합니다. [Issue #188]

      2. Read Characteristic Descriptors 또는 Read Long Characteristic Descriptors 하위 절차를 사용하여 descriptor의 값을 가져오고, 그 값을 담은 new ArrayBuffer를 buffer로 둡니다. 오류 처리는 § 6.7 오류 처리에 따라 수행합니다.

   3. 전역 작업을 대기시켜 Bluetooth 작업 소스에서 global을 주고 다음 단계를 수행합니다:

      1. promise가 gatt.[[activeAlgorithms]]에 없다면, "NetworkError" DOMException으로 reject하여 promise를 거부하고 이 단계를 중단합니다.

      2. 위 하위 절차가 오류를 반환했다면, 해당 오류로 reject하여 promise를 거부하고 이 단계를 중단합니다.

      3. buffer로 생성한 new DataView를 this.value에 할당합니다.

      4. Resolve로 promise를 this.value로 이행합니다.

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

2. gatt를 this.characteristic.service.device.gatt로 둡니다.

3. this.uuid가 쓰기 블록리스트에 해당하면, "SecurityError" DOMException으로 거부된 프라미스를 반환합니다.

4. bytes를 value가 보유한 바이트의 복사본으로 둡니다.

5. bytes가 512바이트를 초과한다면(이는 Long Attribute Values에 따른 속성 값의 최대 길이), "InvalidModificationError" DOMException으로 거부된 프라미스를 반환합니다.

6. gatt.connected가 false이면, "NetworkError" DOMException으로 거부된 프라미스를 반환합니다.

7. descriptor를 this.[[representedDescriptor]]로 둡니다.

8. descriptor가 null이면, "InvalidStateError" DOMException으로 거부된 프라미스를 반환합니다.

9. connection-checking wrapper로 감싼 새 프라미스 promise를 gatt에 대해 반환하고, 다음 단계를 병렬로 수행합니다.

   1. global의 navigable의 top-level traversable의 simulated Bluetooth adapter가 비어 있지 않다면, 다음 단계를 수행합니다:

      1. this.[[automatedDescriptorWriteResponse]]가 "not-expected"가 아니라면, 전역 작업을 대기시켜 Bluetooth 작업 소스에서 global을 주고 "InvalidStateError" DOMException으로 reject하여 promise를 거부하고 이 단계를 중단합니다.

      2. Trigger a simulated descriptor event를 수행하되, global의 navigable, this.device, descriptor, write, bytes를 전달합니다.

      3. this.[[automatedDescriptorWriteResponse]]를 "expected"로 설정하고, 변경될 때까지 대기합니다.

      4. response를 this.[[automatedDescriptorWriteResponse]]의 값으로 둡니다.

      5. this.[[automatedDescriptorWriteResponse]]를 "not-expected"로 설정합니다.

      6. response가 0이 아니면, 다음 하위 단계를 수행합니다:

         1. 전역 작업을 대기시켜 Bluetooth 작업 소스에서 global을 주고 "NetworkError" DOMException으로 reject하여 promise를 거부하고 이 단계를 중단합니다.

   2. 그 외의 경우, 다음 단계를 수행합니다:

      1. UA가 현재 Bluetooth 시스템을 사용 중이라면, 전역 작업을 대기시켜 Bluetooth 작업 소스에서 global을 주고 "NetworkError" DOMException으로 reject하여 이 단계를 중단할 수 있습니다(MAY).

         구현에서는 이 NetworkError를 피할 수 있을 수도 있지만, 현재로서는 사이트가 이 API 사용을 직렬화하거나 실패한 작업을 재시도할 방법을 사용자에게 제공해야 합니다. [Issue #188]

      2. Write Characteristic Descriptors 또는 Write Long Characteristic Descriptors 하위 절차를 사용하여 bytes를 descriptor에 씁니다. 오류 처리는 § 6.7 오류 처리에 따라 수행합니다.

   3. 전역 작업을 대기시켜 Bluetooth 작업 소스에서 global을 주고 다음 단계를 수행합니다:

      1. promise가 gatt.[[activeAlgorithms]]에 없다면, "NetworkError" DOMException으로 reject하여 promise를 거부하고 이 단계를 중단합니다.

      2. 위 하위 절차가 오류를 반환했다면, 해당 오류로 reject하여 promise를 거부하고 이 단계를 중단합니다.

      3. this.value를 new DataView로 설정하되, 이는 new ArrayBuffer가 bytes를 포함하도록 감싼 것입니다.

      4. Resolve로 promise를 undefined로 이행합니다.