expo-file-system

Breaking changes

• breaking

  File.write() is now asynchronous and returns a Promise. Use File.writeSync() for synchronous behavior.

• breaking

  FileHandle.readBytes() and FileHandle.writeBytes() are now asynchronous and return a Promise. Use FileHandle.readBytesSync() and FileHandle.writeBytesSync() for synchronous behavior.

New features

• Add File.preview() and File.canPreview() methods for opening files with platform-native preview flows.

• Added File.digest() for asynchronously calculating MD5, SHA-1, SHA-256, SHA-384 and SHA-512 file digests.

Bug fixes

• Fixed File.downloadFileAsync() returning a runtime-specific error message when canceled with an AbortSignal.

• Fix File.readableStream() returning zeroed bytes and writing past the requested region when a BYOB read targets a view that starts at a non-zero offset.

• [Android][iOS] Fix File.size returning null for a missing or unreadable file.

• [iOS] Fix wrong permissions for text() and bytes().

• Fixed copyAsync on iOS copying the unedited original when a ph:// asset has edits applied in Photos.

• Fixed iOS file previews rejecting a new preview while the previous Quick Look dismissal animation is still finishing.

• Added ./next subpath to package exports field to resolve Metro bundler warning.

• Fixed FileHandle security-scoped access, and non-SAF content:// URI support.

• Fixed potential file offset races when asynchronous and synchronous FileHandle operations overlap on Android and iOS.

• Fixed readAsStringAsync to respect position and length when reading UTF-8 strings.

• [android] Fixed rename() storing an unencoded URI, so reading .uri afterwards threw for names containing a space.

• [android] Fixed slow uploads of SAF-backed content:// files by resolving the request body's content length once, instead of querying it through ContentResolver for every 8 KiB written.

Others

• Marked File.md5 and the MD5-related File.info() types (InfoOptions, InfoOptions.md5 and FileInfo.md5) as deprecated.

• Improve read/write performance on Android by applying withContext(Dispatchers.IO) when possible. (#46376, #47945

• Improved FileHandle docs.