Baseline 2023
Newly available
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Hinweis: Diese Funktion ist nur in Dedicated Web Workers verfügbar.
Die write()-Methode des FileSystemSyncAccessHandle-Interfaces schreibt den Inhalt eines angegebenen Puffers in die Datei, die mit dem Handle verknüpft ist, optional an einem gegebenen Offset.
Dateien im origin private file system sind für Endbenutzer nicht sichtbar und unterliegen daher nicht denselben Sicherheitsüberprüfungen wie Methoden, die auf Dateien im für Benutzer sichtbaren Dateisystem ausgeführt werden. Daher sind Schreibvorgänge, die mit FileSystemSyncAccessHandle.write() durchgeführt werden, wesentlich performanter. Dies macht sie geeignet für signifikante, groà angelegte Dateiaktualisierungen wie SQLite-Datenbankänderungen.
buffer
Ein ArrayBuffer oder ArrayBufferView (wie ein DataView), der den Puffer darstellt, der in die Datei geschrieben werden soll.
options Optional
Ein Optionsobjekt mit den folgenden Eigenschaften:
at
Eine Zahl, die den Offset in Bytes vom Beginn der Datei angibt, an dem der Puffer geschrieben werden soll.
Hinweis: Sie können den Inhalt eines ArrayBuffer nicht direkt manipulieren. Stattdessen erstellen Sie ein typisiertes Array-Objekt wie ein Int8Array oder ein DataView-Objekt, das den Puffer in einem spezifischen Format darstellt, und verwenden dieses, um den Inhalt des Puffers zu lesen und zu schreiben.
Eine Zahl, die die Anzahl der in die Datei geschriebenen Bytes darstellt.
AusnahmenInvalidStateError DOMException
Wird ausgelöst, wenn das zugeordnete Zugriffshandle bereits geschlossen ist oder wenn die Ãnderung der binären Daten der Datei vollständig fehlschlägt.
QuotaExceededError DOMException
Wird ausgelöst, wenn die erhöhte Datenkapazität das Speicherlimit des Browsers überschreitet.
TypeError
Wird ausgelöst, wenn das zugrunde liegende Dateisystem nicht unterstützt, die Datei ab dem angegebenen Dateioffset zu schreiben.
Die folgende asynchrone Ereignis-Handler-Funktion ist innerhalb eines Web Workers enthalten. Beim Empfang einer Nachricht vom Hauptthread:
ArrayBuffer, um sie zu enthalten.onmessage = async (e) => {
// Retrieve message sent to work from main script
const message = e.data;
// 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();
// Get size of the file.
const fileSize = accessHandle.getSize();
// Read file content to a buffer.
const buffer = new DataView(new ArrayBuffer(fileSize));
const readBuffer = accessHandle.read(buffer, { at: 0 });
// Write the message to the end of the file.
const encoder = new TextEncoder();
const encodedMessage = encoder.encode(message);
const writeBuffer = accessHandle.write(encodedMessage, { at: readBuffer });
// Persist changes to disk.
accessHandle.flush();
// Always close FileSystemSyncAccessHandle if done.
accessHandle.close();
};
Hinweis: In früheren Versionen der Spezifikation wurden close(), flush(), getSize() und truncate() fälschlicherweise als asynchrone Methoden spezifiziert, und ältere Versionen einiger Browser implementieren sie auf diese Weise. Allerdings implementieren alle aktuellen Browser, die diese Methoden unterstützen, sie als synchrone Methoden.
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