fs full changelog

← fs releases CHANGELOG.md on GitHub

2.6.x

2.6.0

Sep 26, 2026

• 97e865bc (#3623) Added an options parameter with baseDir to size, so relative paths can be measured, like the other functions and like the JSDoc example already showed. The Rust command already accepted it.
• 9106093f (#3624) Fixed opening Android content:// URIs with append or with write, truncate and append together: the options were turned into invalid modes such as ra or wta. They now map to the modes Android accepts (r, w, wt, wa, rw, rwt), append taking precedence over read since there is no read and append mode.
• 1cae06a5 (#3625) Fixed readTextFileLines yielding empty lines forever when reading fails (e.g. on a directory). The read error is now reported: the iterator rejects and the file is closed.
• 1cae06a5 (#3625) Fixed readTextFileLines leaving the file open until the webview is destroyed when a for await loop over it exits early (break, return or throw). The iterator now implements return(), which closes the file.
• 0c84c917 (#3621) File watcher errors (e.g. the watched directory was removed or the inotify limit was reached) are now logged instead of being silently dropped.
• b46a88ff (#3622) writeFile and writeTextFile now fail when their options cannot be parsed instead of silently ignoring them (including baseDir, append and createNew) and writing to the raw path. Data sent as a JSON array is rejected if it contains values that are not bytes, instead of truncating them.
• ae3c808e (#3602) The plugin's global API script (used with app.withGlobalTauri) now resolves the core API from window.__TAURI__ instead of bundling its own copy of @tauri-apps/api. Values created with the core API are now accepted by plugin APIs in global mode (e.g. an Image from window.__TAURI__.image passed to clipboardManager.writeImage, which previously failed the instanceof check against the plugin's private copy), and the script is considerably smaller.
• 9b29b601 Update MSRV to 1.90 to match tauri.
• a87a3c7d Update documentation.

2.5.x

2.5.2

Aug 31, 2026

• db9c5998 (#3531 by @Legend-Master) Fix missing consumer-rules.pro on Gradle v9.
• f8053e65 (#3527 by @Legend-Master) Documented Cargo feature flags in each plugin's crate-level documentation.
• 685610ae (#3507 by @Legend-Master) Fix fs:default and fs:read-app-specific-dirs-recursive not giving any command scopes
• 3fb27bf1 (#3504 by @vasfvitor) Fixed deny-webview-data has no effect, and on Linux, only deny access to the webview data paths instead of the entire $APPLOCALDATA

2.5.1

May 2, 2026

• ec054013 (#3323 by @renovate) Updated dependency toml from 0.9 to 1

2.5.0

Apr 4, 2026

• e97a4ded (#3244 by @SeijiOkuda) Add encoding option for readTextFile and readTextFileLines
• f75d21db (#3360 by @Legend-Master) Removed the dependency on tauri-utils's build feature
• f5f68063 (#3185 by @lucasfernog) Enable access for security-scoped resources on iOS by automatically calling NSURL::startAccessingSecurityScopedResource on resource access and adding the stopAccessingSecurityScopedResource API.

2.4.x

2.4.5

Jan 8, 2026

• 521cd8b3 (#3155 by @EliasStar) Fix off by one error in the implementation of readTextFileLines causing all lines to end with an (additional) null byte. Issue: #3154 PR: #3155

2.4.4

Oct 27, 2025

• 93426f85 Fixed an issue that caused docs.rs builds to fail. No user facing changes.

2.4.3

Oct 26, 2025

• 6c9b61fb (#3039 by @FabianLars) On Android, updated compileSdk to 36.
• 6b5b1053 (#1939 by @amrbashir) Enhance error messages.

2.4.2

Aug 20, 2025

• 4eb36b0f (#2907 by @Legend-Master) Fixed calling writeFile with data: ReadableStream throws Invalid argument
• 515182a1 (#2915 by @samhinshaw) readFile now returns a more specific type Promise<Uint8Array<ArrayBuffer>> instead of the default Promise<Uint8Array<ArrayBufferLike>

2.4.1

Jul 20, 2025

• 44a1f659 (#2846 by @Legend-Master) Fix writeFile doesn't create a new file by default when the data is a ReadableStream

2.4.0

Jun 25, 2025

• f209b2f2 (#2804 by @renovate) Updated tauri to 2.6

2.3.x

2.3.0

May 20, 2025

• dac4d537 (#2613 by @Legend-Master) Reduce the overhead of watch and unwatch

2.2.x

2.2.1

Apr 2, 2025

bug

• 831c35ff (#2550) Fix writeFile ReadableStream handling due to missing async iterator support on macOS platform

2.2.0

Dec 9, 2024

• 3a79266b (#2173 by @FabianLars) Bumped all plugins to v2.2.0. From now, the versions for the Rust and JavaScript packages of each plugin will be in sync with each other.

2.0.x

2.0.4

Dec 9, 2024

• 77b85507 (#2171 by @FabianLars) Fixed docs.rs build.

2.0.3

Dec 2, 2024

• ed981027 (#1962 by @amrbashir) Improve performance of readTextFile and readTextFileLines APIs

• 3e78173d (#2018 by @amrbashir) Fix readDir function failing to read directories that contain broken symlinks.

• 5092ea5e (#1964 by @amrbashir) Add support for using ReadableStream<Unit8Array> with writeFile API.

• 14cee64c (#1958 by @bWanShiTong) Fix compilation on targets with pointer width of 16 or 32

2.0.2

Nov 5, 2024

• 77149dc4 (#1965 by @amrbashir) Fix writeTextFile converting UTF-8 characters (for example äöü) in the given path into replacement character (�)

2.0.1

Oct 20, 2024

• ae802456 (#1950 by @amrbashir) Improve performance of the FileHandle.read and writeTextFile APIs.

• a1a82208 (#1873 by @lucasfernog) Downgrade MSRV to 1.77.2 to support Windows 7.

2.0.0

Oct 2, 2024

• e2c4dfb6 Update to tauri v2 stable release.

2.0.0-rc.x

2.0.0-rc.6

Oct 2, 2024

• fc9b189e (#1837 by @FabianLars) Fix failing to deserialize capability file when using an OS specific path in the scope that is not available on the current OS.

2.0.0-rc.5

Sep 15, 2024

• cc03ccf5 (#1774) Fix scope-app, scope-app-recursive and scope-index not properly enabling the application paths.

2.0.0-rc.4

Sep 12, 2024

• 9291e4d2 (#1640 by @SRutile) Support any UTF-8 character in the writeFile API.

2.0.0-rc.3

Sep 5, 2024

• a2fe5551 (#1727 by @amrbashir) Add utility methods on FilePath and SafeFilePath enums which are:

  • path
  • simplified
  • into_path

• a2fe5551 (#1727 by @amrbashir) Implement Serialize, Deserialize, From, TryFrom and FromStr traits for FilePath and SafeFilePath enums.

• a2fe5551 (#1727 by @amrbashir) Mark Error enum as #[non_exhuastive].

• a2fe5551 (#1727 by @amrbashir) Add SafeFilePath enum.

2.0.0-rc.2

Aug 29, 2024

• f7280c88 (#1710 by @Legend-Master) Fix can't use Windows paths like C:/Users/UserName/file.txt

bug

• 51819c60 (#1708 by @lucasfernog) Fixes writeFile command implementation on Android.

• e2e97db5 (#1701 by @lucasfernog) Update to tauri 2.0.0-rc.8

2.0.0-rc.1

Aug 17, 2024

• 5f689902 (#1645 by @lucasfernog) Update documentation.

2.0.0-rc.0

Aug 2, 2024

• 9887d1 Update to tauri RC.

2.0.0-beta.x

2.0.0-beta.8

Jul 31, 2024

• 99d6ac0f (#1606 by @FabianLars) The JS packages now specify the minimum @tauri-apps/api version instead of a single exact version.
• 6de87966 (#1597 by @Legend-Master) Update to tauri beta.25.

2.0.0-beta.7

Jul 12, 2024

• 22a17980 (#1537 by @lucasfernog) Update to tauri beta.24.

2.0.0-beta.6

Jul 2, 2024

• 76daee7a (#1512 by @renovate) Update to tauri beta.23.

• b115fd22(#1221) Fixes an issue that caused the app to freeze when the dialog, fs, and persisted-scope plugins were used together.

2.0.0-beta.5

May 30, 2024

• 9013854f(#1382) Update to tauri beta.22.

• bb51a41(#1168) Breaking Change: All apis that return paths to the frontend will now remove the \\?\ UNC prefix on Windows.

• e3d41f4(#1191) Internally use the webview scoped resources table instead of the app one, so other webviews can't access other webviews resources.

• e3d41f4(#1191) Update for tauri 2.0.0-beta.15.

2.0.0-beta.4

May 30, 2024

• 430bd6f4(#1363) Update to tauri beta.20.

• 9c2fb93 Enhance the scope type to also allow a plain string representing the path to allow or deny.

• 772f2bc(#1136) Update for tauri 2.0.0-beta.14.

2.0.0-beta.3

May 1, 2024

• bd1ed590(#1237) Update to tauri beta.17.

• cb96aa0(#1082) Fixes watch and watchImmediate which previously ignored the baseDir parameter.

• a04ea2f(#1071) The global API script is now only added to the binary when the withGlobalTauri config is true.

2.0.0-beta.2

Mar 7, 2024

• 7358102(#1029) Fix infinite loop on cargo build operations
• 99bea25(#1005) Update to tauri beta.8.

2.0.0-beta.1

Feb 21, 2024

• 569defb Update to tauri beta.4.

2.0.0-beta.0

Feb 3, 2024

• d198c01(#862) Update to tauri beta.
• ea8eadc(#865) Fix incorrect create option default value for writeFile and writeTextFile which didn't match documentation.
• 61edbbe(#885) Replace notify-debouncer-mini with notify-debouncer-full. (plugins-workspace#885)

2.0.0-alpha.x

2.0.0-alpha.6

Dec 28, 2023

• 85f8419(#848) Fix DebouncedEvent type to correctly represent the actual type.
• c601230(#847) Add createNew option for writeFile and writeTextFile to create the file if doesn't exist and fail if it does.
• c601230(#847) Truncate files when using writeFile and writeTextFile with append: false.
• 2e2fc8d(#857) Fix invalid args id for command unwatch error when trying to unwatch a previously watched file or directory.
• c601230(#847) Fix panic when using writeFile or writeTextFile without passing an option object.

2.0.0-alpha.5

Dec 20, 2023

• 387c2f9(#802) Update to @tauri-apps/api v2.0.0-alpha.13.
• 69a1fa0(#751) The fs plugin received a major overhaul to add new APIs and changed existing APIs to be closer to Node.js and Deno APIs.

2.0.0-alpha.4

Dec 14, 2023

• 387c2f9(#802) Update to @tauri-apps/api v2.0.0-alpha.12.
• 88d260d(#744) Add second argument to exists function to specify base directory.

2.0.0-alpha.3

Oct 29, 2023

• e438e0a(#676) Update to @tauri-apps/api v2.0.0-alpha.11.

2.0.0-alpha.2

Oct 23, 2023

• 5c13736(#673) Update to @tauri-apps/api v2.0.0-alpha.9.

• 4e2cef9(#593) Update to alpha.12.

2.0.0-alpha.1

Aug 14, 2023

• 0bba693(#454) Fix writeBinaryFile crashing with command 'write_binary_file' not found
• d74fc0a(#555) Update to alpha.11.

2.0.0-alpha.0

May 24, 2023

• 717ae67(#371) First v2 alpha release! 55](https://github.com/tauri-apps/plugins-workspace/pull/555)) Update to alpha.11.

• 717ae67(#371) First v2 alpha release!