Repository navigation
Description
π Search Terms
microphone, camera, device, permission, state, API, navigator
β Viability Checklist
- This wouldn't be a breaking change in existing TypeScript/JavaScript code
- This wouldn't change the runtime behavior of existing JavaScript code
- This could be implemented without emitting different JS based on the types of the expressions
- This isn't a runtime feature (e.g. library functionality, non-ECMAScript syntax with JavaScript output, new syntax sugar for JS, etc.)
- This isn't a request to add a new utility type: https://github.com/microsoft/TypeScript/wiki/No-New-Utility-Types
- This feature would agree with the rest of our Design Goals: https://github.com/Microsoft/TypeScript/wiki/TypeScript-Design-Goals
β Suggestion
In both files, webworker.generated.d.ts and dom.generated.d.ts in line 9361 and 27992.
The modification would be add two terms in the type PermissionName. 'camera' and 'microphone' to check access in both devices
π Motivating Example
const checkForPermission = (type: PermissionName) => {
navigator.permissions
.query({
name: type,
})
.then(permissionStatus => {
// Will be 'granted', 'denied' or 'prompt':
console.log(permissionStatus);
// permissionStatus.state = 'granted'
// Listen for changes to the permission state
permissionStatus.onchange = () => {
console.log(permissionStatus.state);
};
});
};
checkForPermission('microphone');
checkForPermission('camera');
Expected behavior:
'microphone' and 'camera' should be valid types for PermissionName type.
Actual behavior:
'microphone' and 'camera' are not valid types for PermissionName type.
Typescript is showing error:
Argument of type '"microphone"' is not assignable to parameter of type 'PermissionName'.
π» Use Cases
-
What do you want to use this for?
Check if camera or microphone are enabled/disabled -
What shortcomings exist with current approaches?
To type the promise from navigator.permission in typescript, we have to add a inclusion on type PermissionName like: { PermissionName } & { name: 'camera' | 'microphone' }. -
What workarounds are you using in the meantime?
I'm using it: { PermissionName } & { name: 'camera' | 'microphone' }
Activity
olivermrose commentedon Aug 30, 2024
See microsoft/TypeScript-DOM-lib-generator#1129
ehoogeveen-medweb commentedon Aug 30, 2024
It appears that the
nameproperty of thePermissionDescriptorpassed toPermissions#queryis now simply specced asDOMString.There is a permissions registry, but the number of entries is pretty limited, with 4 standardized permissions and 3 provisional permissions (as I write this).
So maybe it would be better for
PermissionNameto just become an alias ofstring(or preferably something that accepts any string but still autocompletes).Edit: Ah, I missed the
Why is this not an enum?note in the query method specification. Still, I'm not sure what you could base it on other than the provided tables which seem pretty limited.microphonefor example isn't mentioned as a permission name in the spec at all.