From 2c8be8af67ea559ad96ca36cf3ccee7423e24f10 Mon Sep 17 00:00:00 2001 From: JinDX Date: Fri, 18 Jul 2025 14:42:18 +0800 Subject: [PATCH 1/6] Meta: link Simplified Chinese translation --- index.bs | 1 + 1 file changed, 1 insertion(+) diff --git a/index.bs b/index.bs index 881fb19..0955887 100644 --- a/index.bs +++ b/index.bs @@ -6,6 +6,7 @@ Text Macro: TWITTER whatfilesystem Text Macro: LATESTRD 2023-09 Abstract: File System defines infrastructure for file systems as well as their API. Translation: ja https://triple-underscore.github.io/fs-ja.html +Translation: zh-Hans https://htmlspecs.com/fs/ Indent: 2 Markup Shorthands: css no, markdown yes From 64646aa066bdb8c0226a8e27605e451c4d177c6a Mon Sep 17 00:00:00 2001 From: Anne van Kesteren Date: Fri, 18 Jul 2025 08:50:51 +0200 Subject: [PATCH 2/6] Update index.bs --- index.bs | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) diff --git a/index.bs b/index.bs index 0955887..a2659a3 100644 --- a/index.bs +++ b/index.bs @@ -12,6 +12,7 @@ Markup Shorthands: css no, markdown yes 
+spec:infra; type:dfn; text:string
 spec:webidl; type:dfn; text:resolve
@@ -1347,9 +1348,9 @@ runs these steps: :: Resizes the file associated with |stream| to be |size| bytes long. If |size| is larger than the current file size this pads the file with null bytes, otherwise it truncates the file. - The file cursor is updated when {{truncate}} is called. If the cursor is smaller than |size|, - it remains unchanged. If the cursor is larger than |size|, it is set to |size| to - ensure that subsequent writes do not error. + The file cursor is updated when {{FileSystemWritableFileStream/truncate()|truncate}} is called. + If the cursor is smaller than |size|, it remains unchanged. If the cursor is larger than + |size|, it is set to |size| to ensure that subsequent writes do not error. No changes are written to the actual file until on disk until the stream has been closed. Changes are typically written to a temporary file instead. @@ -1392,9 +1393,9 @@ The seek(|position|) method s :: Resizes the file associated with |stream| to be |size| bytes long. If |size| is larger than the current file size this pads the file with null bytes, otherwise it truncates the file. - The file cursor is updated when {{truncate}} is called. If the cursor is smaller than |size|, - it remains unchanged. If the cursor is larger than |size|, it is set to |size| to - ensure that subsequent writes do not error. + The file cursor is updated when {{FileSystemWritableFileStream/truncate()|truncate}} is called. + If the cursor is smaller than |size|, it remains unchanged. If the cursor is larger than + |size|, it is set to |size| to ensure that subsequent writes do not error. No changes are written to the actual file until on disk until the stream has been closed. Changes are typically written to a temporary file instead. @@ -1571,7 +1572,7 @@ The write(|buffer|, {{FileSystemReadW : |handle| . {{FileSystemSyncAccessHandle/truncate()|truncate}}(|newSize|) :: Resizes the file associated with |handle| to be |newSize| bytes long. If |newSize| is larger than the current file size this pads the file with null bytes; otherwise it truncates the file. - :: The file cursor is updated when {{truncate}} is called. If the cursor is smaller than |newSize|, it remains unchanged. If the cursor is larger than |newSize|, it is set to |newSize|. + :: The file cursor is updated when {{FileSystemSyncAccessHandle/truncate()|truncate}} is called. If the cursor is smaller than |newSize|, it remains unchanged. If the cursor is larger than |newSize|, it is set to |newSize|.
@@ -1638,7 +1639,7 @@ The flush() method steps are: 1. Attempt to transfer all cached modifications of the file's content to the file system's underlying storage device. - Note: This is also known as flushing. This may be a no-op on some file + Note: This is also known as flushing. This can be a no-op on some file systems, such as in-memory file systems, which do not have a "disk" to flush to. From 02a2995393c6151d689507e7bc179242fabff279 Mon Sep 17 00:00:00 2001 From: Anne van Kesteren Date: Fri, 18 Jul 2025 09:00:44 +0200 Subject: [PATCH 3/6] Update index.bs --- index.bs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.bs b/index.bs index a2659a3..49776cf 100644 --- a/index.bs +++ b/index.bs @@ -440,7 +440,7 @@ Note: A {{FileSystemFileHandle}}'s associated [=FileSystemHandle/locator=]'s
To -create a child `FileSystemFileHandle` +create a child `FileSystemFileHandle` given a [=directory locator=] |parentLocator| and a string |name| in a [=/Realm=] |realm|: 1. Let |handle| be a [=new=] {{FileSystemFileHandle}} in |realm|. From f1026a201f2a99fc723d812e8a4de8bfc046ac22 Mon Sep 17 00:00:00 2001 From: Anne van Kesteren Date: Tue, 22 Jul 2025 09:02:09 +0200 Subject: [PATCH 4/6] Update index.bs --- index.bs | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/index.bs b/index.bs index 49776cf..3399fd6 100644 --- a/index.bs +++ b/index.bs @@ -679,7 +679,7 @@ dictionary FileSystemRemoveOptions { [Exposed=(Window,Worker), SecureContext, Serializable] interface FileSystemDirectoryHandle : FileSystemHandle { - async iterable; + async_iterable; Promise getFileHandle(USVString name, optional FileSystemGetFileOptions options = {}); Promise getDirectoryHandle(USVString name, optional FileSystemGetDirectoryOptions options = {}); @@ -742,7 +742,7 @@ in a [=/Realm=] |realm|: might or might not be included. No guarantees are given either way.
-Issue(15): In the future we might want to add arguments to the async iterable declaration to +Issue(15): In the future we might want to add arguments to the async_iterable declaration to support for example recursive iteration.
From 9b15968a565221cd92b05a00ed974479ec650aa5 Mon Sep 17 00:00:00 2001 From: Anne van Kesteren Date: Tue, 22 Jul 2025 09:09:54 +0200 Subject: [PATCH 5/6] Update index.bs --- index.bs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.bs b/index.bs index 3399fd6..aa192db 100644 --- a/index.bs +++ b/index.bs @@ -1511,7 +1511,7 @@ The read(|buffer|, {{FileSystemReadWr : |handle| . {{FileSystemSyncAccessHandle/write()|write}}(|buffer|, { {{FileSystemReadWriteOptions/at}} }) :: Writes the content of |buffer| into the file associated with |handle|, optionally at a given offset, and returns the number of written bytes. Checking the returned number of written bytes allows callers to detect and handle errors and partial writes. - :: The file cursor is updated when {{write}} is called to point to the byte after the last byte written. + :: The file cursor is updated when {{FileSystemSyncAccessHandle/write()|write}} is called to point to the byte after the last byte written.
From 9bd38fde9d7a4ef99b11ad8d9061a8cd6daaecc9 Mon Sep 17 00:00:00 2001 From: Anne van Kesteren Date: Tue, 22 Jul 2025 09:13:13 +0200 Subject: [PATCH 6/6] Update index.bs --- index.bs | 1 - 1 file changed, 1 deletion(-) diff --git a/index.bs b/index.bs index aa192db..2c738fc 100644 --- a/index.bs +++ b/index.bs @@ -12,7 +12,6 @@ Markup Shorthands: css no, markdown yes 
-spec:infra; type:dfn; text:string
 spec:webidl; type:dfn; text:resolve