Contact emails

[email protected]

Specification

https://github.com/whatwg/fs/pull/53/commits/618b663ebdc0f9842d7db3091baed5f75aa87534

Summary

Updates the asynchronous methods (`flush()`, `getSize()`, `truncate()`) in
`FileSystemSyncAccessHandle` in the File System Access API to synchronous
methods. `FileSystemSyncAccessHandle` currently has a mix of sync and async
methods, hindering the performance and the usability, especially for
applications porting C/C++ to Wasm. This update will bring consistency in
the API usage and improve the performance for Wasm-based libraries.


Blink component

Blink>Storage>FileSystem
<https://bugs.chromium.org/p/chromium/issues/list?q=component:Blink%3EStorage%3EFileSystem>

TAG review

https://github.com/w3ctag/design-reviews/issues/772

TAG review status

Pending


Risks

Interoperability and Compatibility

Compatibility:

Changing a return type from Promise to value can break, only if Promise
methods are directly used rather than `await`. However, we expect minimal
breakage due to very low usage (~0.00002% page loads; zero usage queried
via HttpArchive). The original API was shipped in M102 and targeted for
partner usage, to which the changes may be communicated. In addition, all
code snippets and examples in public documents use `await`, which does not
cause any breakage.

Interoperability:

There are no interoperability risks expected. The design change was
initially proposed and assessed from vendor feedback.
https://github.com/whatwg/fs/issues/7


Gecko: Positive (
https://github.com/whatwg/fs/issues/7#issuecomment-1226562961)

WebKit: No signal

Web developers: Strongly positive (https://github.com/whatwg/fs/issues/7)

Other signals:

Ergonomics

Low ergonomics risks are expected. In fact, the goal of this change is to
improve the ergonomics of the API by making all methods to return
synchronously and make it easier to use on Wasm-ported applications.


WebView application risks

Does this intent deprecate or change behavior of existing APIs, such that
it has potentially high risk for Android WebView-based applications?


Debuggability

Basic tooling: Autocomplete works as described in "New WebIDL/DOM
interfaces and attributes".


Will this feature be supported on all six Blink platforms (Windows, Mac,
Linux, Chrome OS, Android, and Android WebView)?

No

Desktop only now. Origin Private File System (including
`FileSystemSyncAccessHandle`) is planned to be shipped on Android in the
near future.

Is this feature fully tested by web-platform-tests
<https://chromium.googlesource.com/chromium/src/+/main/docs/testing/web_platform_tests.md>
?

Yes

Flag name

sync-access-handle-all-sync-surface

Requires code in //chrome?

False

Tracking bug

https://bugs.chromium.org/p/chromium/issues/detail?id=1338340

Estimated milestones

DevTrial on desktop

106


Anticipated spec changes

https://github.com/whatwg/fs/pull/53/commits/618b663ebdc0f9842d7db3091baed5f75aa87534

Link to entry on the Chrome Platform Status

https://chromestatus.com/feature/5149644305203200

This intent message was generated by Chrome Platform Status
<https://chromestatus.com/>.

-- 
You received this message because you are subscribed to the Google Groups 
"blink-dev" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To view this discussion on the web visit 
https://groups.google.com/a/chromium.org/d/msgid/blink-dev/CAPscNz4GPefX650W7y-z2-kDVpwChCWur1UJb2490ySm03jy2A%40mail.gmail.com.

Reply via email to