FileSystemHandle: queryPermission()-Methode
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Die queryPermission()-Methode der FileSystemHandle-Schnittstelle überprüft den aktuellen Berechtigungsstatus des aktuellen Handles.
Syntax
queryPermission(descriptor)
Parameter
descriptorOptional-
Ein Objekt, das den Berechtigungsmodus festlegt, für den abgefragt werden soll. Die Optionen sind wie folgt:
'mode'Optional-
Kann entweder
'read','write'oder'readwrite'sein.
Rückgabewert
Ein Promise, das mit PermissionStatus.state aufgelöst wird, was eines der folgenden sein kann: 'granted', 'denied' oder 'prompt'. Es kann auch mit einer der unten aufgeführten Ausnahmen abgelehnt werden.
Wenn dieses mit "prompt" aufgelöst wird, muss die Website requestPermission() aufrufen, bevor irgendwelche Operationen auf dem Handle durchgeführt werden können. Wenn dieses mit "denied" aufgelöst wird, werden alle Operationen abgelehnt. Normalerweise werden Handles, die von den lokalen Dateisystem-Handle-Fabriken zurückgegeben werden, zunächst mit "granted" für ihren Lesezugriffsstatus aufgelöst. Abgesehen davon, dass der Benutzer die Berechtigung widerruft, wird ein Handle, das aus IndexedDB abgerufen wurde, wahrscheinlich auch mit "prompt" aufgelöst.
Ausnahmen
TypeError-
Wird ausgelöst, wenn
modemit einem anderen Wert als'read','write'oder'readwrite'angegeben wird.
Beispiele
Die folgende asynchrone Funktion gibt true zurück, wenn dem Benutzer Lese- oder Lese-/Schreibberechtigungen für das Dateihandle erteilt wurden. Die Berechtigung wird angefordert, falls nicht.
// 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;
}
Spezifikationen
| Specification |
|---|
| File System Access # api-filesystemhandle-querypermission |
Browser-Kompatibilität
Loading…