Limited availability
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Note: This feature is available in Web Workers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The requestPermission()
method of the FileSystemHandle
interface requests read or readwrite permissions for the file handle.
requestPermission(descriptor)
Parameters
descriptor
Optional
An object which specifies the permission mode to query for. Options are as follows:
'mode'
Optional
Can be either 'read'
, 'write'
, or 'readwrite'
.
A Promise
that resolves with PermissionStatus.state
which is one of 'granted'
, 'denied'
or 'prompt'
. It may also reject with one of the exceptions below.
TypeError
Thrown if no parameter is specified or the mode
is not that of 'read'
, 'write'
, or 'readwrite'
SecurityError
DOMException
Thrown in one of the following cases:
Transient user activation is required. The user has to interact with the page or a UI element in order for this feature to work.
ExamplesThe following asynchronous function requests permissions if they have not been granted.
// fileHandle is a FileSystemFileHandle
// withWrite is a boolean set to true if write
async function verifyPermission(fileHandle, withWrite) {
const opts = {};
if (withWrite) {
opts.mode = "readwrite";
}
// Check if we already have permission, if so, return true.
if ((await fileHandle.queryPermission(opts)) === "granted") {
return true;
}
// Request permission to the file, if the user grants permission, return true.
if ((await fileHandle.requestPermission(opts)) === "granted") {
return true;
}
// The user did not grant permission, return false.
return false;
}
Specifications Browser compatibility See also
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4