Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten.Erfahre mehr über dieses Experiment.
FileSystemSyncAccessHandle: truncate()-Methode
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since März 2023.
Sicherer Kontext: Diese Funktion ist nur insicheren Kontexten (HTTPS) in einigen oder allenunterstützenden Browsern verfügbar.
Hinweis: Diese Funktion ist nur inDedicated Web Workers verfügbar.
Dietruncate()-Methode der SchnittstelleFileSystemSyncAccessHandle ändert die Größe der Datei, die mit dem Handle verknüpft ist, auf eine bestimmte Anzahl von Bytes.
Hinweis:In früheren Versionen der Spezifikation wurdenclose(),flush(),getSize() undtruncate() fälschlicherweise als asynchrone Methoden angegeben, und ältere Versionen einiger Browser implementieren sie auf diese Weise. Alle aktuellen Browser, die diese Methoden unterstützen, implementieren sie jedoch als synchrone Methoden.
Syntax
truncate(newSize)Parameter
newSizeDie Anzahl der Bytes, auf die die Datei geändert werden soll.
Rückgabewert
Keiner (undefined).
Ausnahmen
InvalidStateErrorDOMExceptionWird ausgelöst, wenn das zugehörige Zugriffshandle bereits geschlossen ist oder wenn die Änderung der binären Daten der Datei auf andere Weise fehlschlägt.
QuotaExceededErrorWird ausgelöst, wenn
newSizegrößer ist als die ursprüngliche Dateigröße und dasSpeicherkontingent des Browsers überschreitet.TypeErrorWird ausgelöst, wenn das zugrunde liegende Dateisystem das Setzen der Dateigröße auf die neue Größe nicht unterstützt.
Beispiele
async function truncateFile() { // Get handle to draft file const root = await navigator.storage.getDirectory(); const draftHandle = await root.getFileHandle("draft.txt", { create: true }); // Get sync access handle const accessHandle = await draftHandle.createSyncAccessHandle(); // Truncate the file to 0 bytes accessHandle.truncate(0); // Persist changes to disk. accessHandle.flush(); // Always close FileSystemSyncAccessHandle if done. accessHandle.close();}Spezifikationen
| Specification |
|---|
| File System # api-filesystemsyncaccesshandle-truncate |