PackageTrack
Sign in Get early access

file_system_access_api

A Dart library to expose the File System Access Api from web platform.

2.0.0 3.0K downloads/mo #4634 most downloaded on pub.dev poirierlouis/file_system_access_api

What this package is like to depend on

Last release 3 years ago

no release in 18 months

Ships fairly regularly

a new release about every 7 months

Nearly every release is documented

notes for 8 of 8 stable releases

Nothing withdrawn

no release was ever pulled

4 years old

8 releases · first in 2022

0 releases in the last 12 months

see the full history below

Release timeline

8 releases · Dec 2022 to Jan 2024
2023 2024 2025 2026
Release Pre-release

Releases

latest 8
  1. 2.0.0 19 Jan 2024
    Release notes

    ci: publish release v2.0.0.

    Open source →
    Release notes

    Changed

    • bump SDK lower constraint to v3.1.0.
    • bump SDK upper constraint to v4.0.0.
    • bump package 'js' to v0.7.0. ([issue #6])

    Open source →
  2. 1.1.0 13 Feb 2023
    Release notes

    ci: publish release v1.1.0.

    Open source →
    Release notes

    Added

    • js-interop binding to support experimental and non-standard method FileSystemHandle.remove.

    Open source →
  3. 1.0.3 17 Dec 2022
    Release notes

    ci: publish release v1.0.3.

    Open source →
    Release notes

    Fixed

    • downgrade package 'js' from v0.6.5 to v0.6.4 to be compatible with flutter_web_plugins in Flutter projects.

    Open source →
  4. 1.0.2 17 Dec 2022
    Release notes

    ci: publish release v1.0.2.

    Open source →
    Release notes

    Changed

    • nullable return type of getFileHandle and getDirectoryHandle in FileSystemDirectoryHandle to be non-nullable. Methods throw NotFoundError instead of returning null. ([issue #1])
    • bump package 'js' from v0.6.4 to v0.6.5.

    Open source →
  5. 1.0.1 16 Dec 2022
    Release notes

    ci: publish release v1.0.1.

    Open source →
    Release notes

    Fixed

    • update CHANGELOG with the latest release.

    Open source →
  6. 1.0.0 16 Dec 2022
    Release notes

    ci: publish release v1.0.0.

    Open source →
    Release notes

    Due to internal refactoring, expect breaking changes with this version. See below to migrate from [0.2.0].

    Fixed

    • call to read/write methods of a FileSystemSyncAccessHandle now correctly sends 'offset' option to native method.
    • API documentation using Dart Doc styles.

    Removed

    • FileSystemAccess.fromNative and FileSystemHandle.toNative methods as it is now obsolete.

    Added

    • documentation on how to check if browser supports API.

    Changed

    • internal structure to use plain js-interop extensions instead of custom wrappers.

    Migration

    toNative() removed:

    final storage; // IndexedDB storage
    final handle; // a file handle
    
    /// Call to:
    await storage.put("key", handle.toNative());
    
    /// Replace with:
    await storage.put("key", handle);
    

    fromNative() removed:

    final storage; // IndexedDB storage
    final data = await storage.get("key"); // get file/directory handle
    
    /// Call to:
    final handle = FileSystemAccess.fromNative(data);
    
    /// Replace with:
    final handle = data as FileSystemHandle;
    

    is keyword will always return false:

    FileSystemHandle handle;
    
    /// Call to:
    if (handle is FileSystemFileHandle) {}
    
    /// Replace with:
    if (handle.kind == FileSystemKind.file) {}
    

    Open source →
  7. 0.2.0 14 Dec 2022
    Release notes

    ci: publish release v0.2.0.

    Open source →
    Release notes

    Added

    • js-interop bindings for createSyncAccessHandle and FileSystemSyncAccessHandle object.
    • example to demonstrate usage of Synchronous Access in Web Workers.
    • minimal code samples in example.dart to be shown in pub.dev.

    Open source →
  8. 0.1.0 10 Dec 2022
    Release notes

    ci: publish first version as v0.1.0.

    Open source →
    Release notes

    Added

    • js-interop bindings for showOpenFilePicker, showSaveFilePicker and showDirectoryPicker on Window.
    • js-interop bindings for File System Access API objects.
    • js-interop binding for Origin Private File System on Storage Manager object.
    • examples to demonstrate usage of this library.
    • Dart typed errors to replace vague DomException errors.
    • README and CHANGELOG.

    <!-- Table of releases --> [Unreleased]: https://github.com/poirierlouis/file_system_access_api/compare/v2.0.0...HEAD [2.0.0]: https://github.com/poirierlouis/file_system_access_api/compare/v1.1.0...v2.0.0 [1.1.0]: https://github.com/poirierlouis/file_system_access_api/compare/v1.0.3...v1.1.0 [1.0.3]: https://github.com/poirierlouis/file_system_access_api/compare/v1.0.2...v1.0.3 [1.0.2]: https://github.com/poirierlouis/file_system_access_api/compare/v1.0.1...v1.0.2 [1.0.1]: https://github.com/poirierlouis/file_system_access_api/compare/v1.0.0...v1.0.1 [1.0.0]: https://github.com/poirierlouis/file_system_access_api/compare/v0.2.0...v1.0.0 [0.2.0]: https://github.com/poirierlouis/file_system_access_api/compare/v0.1.0...v0.2.0 [0.1.0]: https://github.com/poirierlouis/file_system_access_api/releases/tag/v0.1.0

    <!-- Table of issues --> [issue #6]: https://github.com/poirierlouis/file_system_access_api/issues/6 [issue #1]: https://github.com/poirierlouis/file_system_access_api/issues/1

    Open source →

Every package, every release, already written down.

The archive is open and free. Watching your own project is what we are building next.

Browse the archive