ファイルシステム

1. lockをfileに関連付けられたロックとします。

2. countをfileに関連付けられた共有ロック数とします。

3. もしvalueが"exclusive"の場合:

   1. もしlockが"open"の場合:

      1. ロックを"taken-exclusive"に設定します。

      2. "success"を返します。

4. もしvalueが"shared"の場合:

   1. もしlockが"open"の場合:

      1. lockを"taken-shared"に設定します。

      2. countを1に設定します。

      3. "success"を返します。

   2. それ以外でlockが"taken-shared"の場合:

      1. countを1増やします。

      2. "success"を返します。

5. "failure"を返します。

注: これらの手順はファイルシステムキュー上で実行される必要があります。

1. lockをfileに関連付けられたロックとします。

2. countをfileに関連付けられた共有ロック数とします。

3. もしlockが"taken-shared"の場合:

   1. countを1減らします。

   2. もしcountが0の場合、lockを"open"に設定します。

4. それ以外の場合、lockを"open"に設定します。

注: これらの手順はファイルシステムキュー上で実行される必要があります。

ファイルシステムロケータ childを、ディレクトリロケータ rootに相対的に解決するには以下の手順を実行します:

1. resultを新しいプロミスとします。

2. 以下の手順をエンキューして、ファイルシステムキューに追加します:

   1. もしchildのロケータのルートがrootのロケータのルートと異なる場合、 nullで解決し、これらの手順を中止します。

   2. childPathをchildのロケータのパスとします。

   3. rootPathをrootのロケータのパスとします。

   4. もしchildPathが同じパスとしてrootPathと一致する場合、 « »で解決し、これらの手順を中止します。

   5. もしrootPathのサイズが childPathのサイズより大きい場合、 nullで解決し、これらの手順を中止します。

   6. 各 indexについてrootPathのインデックスを反復します:

      1. もしrootPath.[[index]]が childPath.[[index]]と一致しない場合、 nullで解決し、これらの手順を中止します。

   7. relativePathを« »とします。

   8. 各 indexについて範囲の rootPathのサイズ からrootPathのサイズまで（排他的）を反復し、 追加します。 childPath.[[index]]をrelativePathに追加します。

   9. 解決をrelativePathで行います。

3. resultを返します。

• もしlocatorがファイルロケータである場合、それはファイルエントリまたはnullを返します。

• もしlocatorがディレクトリロケータである場合、それはディレクトリエントリまたはnullを返します。

• これらの手順がnull以外のentryを返した場合:

  • ロケータを取得する操作でentry がlocatorを返すことを前提とします（中間的なファイルシステム操作が実行されていない場合）。

  • entryの名前は、locatorの パスの最後の項目です。

• もしentryがファイルエントリである場合、 それはファイルロケータを返します。

• もしentryがディレクトリエントリである場合、それはディレクトリロケータを返します。

• これらの手順がlocatorを返した場合:

  • エントリを特定する操作でlocator がentryを返すことを前提とします（中間的なファイルシステム操作が実行されていない場合）。

  • entryの名前は、locatorの パスの最後の項目です。

以下は、value、serialized、およびforStorageを与えられたときのシリアライズ手順です。

1. serialized.[[Origin]]をvalueの関連する設定オブジェクトのオリジンに設定します。

2. serialized.[[Locator]]をvalueのロケータに設定します。

1. もしserialized.[[Origin]]がvalueの関連する設定オブジェクトのオリジンと同一オリジンでない場合、 "DataCloneError" DOMException をスローします。

2. valueのロケータをserialized.[[Locator]]に設定します。

1. realm を this の 関連する Realm とする。

2. p を 新しい Promise として realm 内で生成する。

3. 以下の手順を ファイルシステムキュー にエンキューする：

   1. もし this の locator が 同じ locator を other の locator として持つ場合、 resolve p を true で解決する。

   2. それ以外の場合、resolve p を false で解決する。

4. p を返す。

1. handle を 新しい FileSystemFileHandle として realm 内で生成する。

2. childType を "file" とする。

3. childRoot を parentLocator の root のコピーとする。

4. childPath を clone した parentLocator の path に append した name とする。

5. handle の locator を以下の ファイルシステムロケータ として設定する：その kind は childType、 root は childRoot、そして path は childPath。

6. handle を返す。

1. result を 新しい Promise として作成する。

2. locator を this の locator とする。

3. global を this の 関連するグローバルオブジェクト とする。

4. 以下の手順をエンキューする ファイルシステムキュー に：

   1. entry を、エントリを見つける手順を locator に対して実行した結果とする。

   2. accessResult を、entry の query access に "read" を渡して実行した結果とする。

   3. ストレージタスクをキューに追加する global を使用して以下を実行：

      1. もし accessResult の permission state が "granted" でない場合、 reject result を accessResult の エラー名 を持つ DOMException として解決し、これらの手順を中止する。

      2. もし entry が null の場合、reject result を "NotFoundError" DOMException として解決し、これらの手順を中止する。

      3. アサート: entry が ファイルエントリ であること。

      4. f を新しい File とする。

      5. f の スナップショット状態 を entry の現在の状態に設定する。

      6. f の基礎となるバイトシーケンスを entry の バイナリデータ のコピーに設定する。

      7. f の name を entry の name に設定する。

      8. f の lastModified を entry の 修正タイムスタンプ に設定する。

      9. f の type を例えば entry の name やそのファイル拡張子に基づく 実装依存の値 に設定する。

         読み取りおよびスナップショットの動作仕様については、[FILE-API] 仕様にてさらに詳細に記述する必要がありますが、 現在のところは曖昧なままです。

      10. resolve result を f で解決する。

5. result を返す。

1. result を 新しい Promise として作成する。

2. locator を this の locator とする。

3. realm を this の 関連する Realm とする。

4. global を this の 関連するグローバルオブジェクト とする。

5. 以下の手順をエンキューする ファイルシステムキュー に：

   1. entry を、エントリを見つける手順を locator に対して実行した結果とする。

   2. accessResult を、entry の request access に "readwrite" を渡して実行した結果とする。

   3. もし accessResult の permission state が "granted" でない場合、 ストレージタスクをキューに追加する global を使用して、 reject result を accessResult の エラー名 を持つ DOMException として解決し、これらの手順を中止する。

   4. もし entry が null の場合、 ストレージタスクをキューに追加する global を使用して、 reject result を "NotFoundError" DOMException として解決し、これらの手順を中止する。

   5. アサート: entry が ファイルエントリ であること。

   6. lockResult を、ロックを取得する 手順を "shared" を指定して entry に対して実行した結果とする。

   7. ストレージタスクをキューに追加する global を使用して以下を実行：

      1. もし lockResult が "failure" の場合、 reject result を "NoModificationAllowedError" DOMException として解決し、これらの手順を中止する。

      2. stream を、新しい FileSystemWritableFileStream を作成する 手順を entry に対して realm 内で実行した結果とする。

      3. もし options["keepExistingData"] が true の場合：

         1. stream の [[buffer]] を、 entry の バイナリデータ のコピーに設定する。

      4. resolve result を stream で解決する。

6. result を返す。

1. result を 新しい Promise として作成する。

2. locator を this の locator とする。

3. realm を this の 関連する Realm とする。

4. global を this の 関連するグローバルオブジェクト とする。

5. isInABucketFileSystem を true とし、this が バケットファイルシステム内にある かどうかを判定する。それ以外の場合は false とする。

6. 以下の手順をエンキューする ファイルシステムキュー に：

   1. entry を、エントリを見つける手順を locator に対して実行した結果とする。

   2. accessResult を、entry の request access に "readwrite" を渡して実行した結果とする。

   3. もし accessResult の permission state が "granted" でない場合、 ストレージタスクをキューに追加する global を使用して、 reject result を accessResult の エラー名 を持つ DOMException として解決し、これらの手順を中止する。

   4. もし isInABucketFileSystem が false の場合、 ストレージタスクをキューに追加する global を使用して、 reject result を "InvalidStateError" DOMException として解決し、これらの手順を中止する。

   5. もし entry が null の場合、 ストレージタスクをキューに追加する global を使用して、 reject result を "NotFoundError" DOMException として解決し、これらの手順を中止する。

   6. アサート: entry が ファイルエントリ であること。

   7. lockResult を、ロックを取得する 手順を "exclusive" を指定して entry に対して実行した結果とする。

   8. ストレージタスクをキューに追加する global を使用して以下を実行：

      1. もし lockResult が "failure" の場合、 reject result を "NoModificationAllowedError" DOMException として解決し、これらの手順を中止する。

      2. handle を、新しい FileSystemSyncAccessHandle を作成する 手順を entry に対して realm 内で実行した結果とする。

      3. resolve result を handle で解決する。

7. result を返す。

1. handle を 新しい FileSystemDirectoryHandle として realm 内で生成する。

2. childType を "directory" とする。

3. childRoot を parentLocator の root のコピーとする。

4. childPath を clone した parentLocator の path に append した name とする。

5. handle の locator を以下の ファイルシステムロケータ として設定する：その kind は childType、 root は childRoot、そして path は childPath。

6. handle を返す。

1. handle を 新しい FileSystemDirectoryHandle として realm 内で生成する。

2. handle の locator を以下の ファイルシステムロケータ として設定する：その kind は "directory"、 root は root、そして path は path。

3. handle を返す。

1. iterator の 過去の結果 を空の セット に設定する。

1. promise を 新しい Promise として作成する。

2. 以下の手順をエンキューする ファイルシステムキュー に：

   1. directory を、エントリを見つける 手順を handle の locator に対して実行した結果とする。

   2. accessResult を、directory の query access に "read" を渡して実行した結果とする。

   3. ストレージタスクをキューに追加する handle の 関連するグローバルオブジェクト を使用して以下を実行：

      1. もし accessResult の permission state が "granted" でない場合、 reject promise を accessResult の エラー名 を持つ DOMException として解決し、これらの手順を中止する。

      2. もし directory が null の場合、 reject promise を "NotFoundError" DOMException として解決し、これらの手順を中止する。

         1. アサート: directory が ディレクトリエントリ であること。

      3. child を directory の 子 の中から、child の name が iterator の 過去の結果 に 含まれていないものとして選び、それが存在しない場合は null とする。

         注意: これは意図的に反復順序について非常に曖昧にしています。 異なるプラットフォームやファイルシステムは反復順序について異なる保証を提供し、すべてのプラットフォームで効率的に実装できるようにしたいと考えています。 したがって、どの順序で要素が返されるかについては一切保証されません。

      4. もし child が null の場合、 resolve promise を undefined として解決し、これらの手順を中止する。

      5. 追加 child の name を iterator の 過去の結果 に。

      6. もし child が ファイルエントリ である場合：

         1. result を 子の FileSystemFileHandle を作成する 手順を handle の locator と child の name に対して handle の 関連する Realm 内で実行した結果とする。

      7. それ以外の場合：

         1. result を 子の FileSystemDirectoryHandle を作成する 手順を handle の locator と child の name に対して handle の 関連する Realm 内で実行した結果とする。

      8. resolve promise を (child の name, result) で解決する。

3. promise を返す。

1. result を 新しいプロミス とします。

2. realm を this の 関連する Realm とします。

3. locator を this の ロケーター とします。

4. global を this の 関連するグローバルオブジェクト とします。

5. 以下の手順をエンキュー して、ファイルシステムキュー に送ります:

   1. もし name が 有効なファイル名 でない場合、ストレージタスクをエンキュー して global に プロミスを拒否 し、TypeError を 用いてこれらの手順を中止します。

   2. entry を エントリを位置特定 する結果とします。

   3. もし options["create"] が true の場合:

      1. accessResult を entry の アクセス要求 を "readwrite" にして実行した結果とします。

   4. それ以外の場合:

      1. accessResult を entry の アクセスクエリ を "read" にして実行した結果とします。

   5. ストレージタスクをエンキュー して、global に以下の手順を実行させます:

      1. もし accessResult の 権限状態 が "granted" でない 場合、プロミスを拒否 して accessResult のエラー名 を用いてこれらの手順を中止します。

      2. もし entry が null の場合、プロミスを拒否 して "NotFoundError" DOMException を 用いてこれらの手順を中止します。

      3. アサート: entry は ディレクトリエントリ です。

      4. 各 entry の 子要素 について child を繰り返します:

         1. もし child の 名前 が name と等しい場合:

            1. もし child が ディレクトリエントリ の場合:

               1. プロミスを拒否 して "TypeMismatchError" DOMException を 用いてこれらの手順を中止します。

            2. プロミスを解決 して 子 FileSystemFileHandle を作成 した結果を locator と child の 名前 を用いて realm 内で返し、 これらの手順を中止します。

      5. もし options["create"] が false の場合:

         1. プロミスを拒否 して "NotFoundError" DOMException を 用いてこれらの手順を中止します。

      6. child を新しい ファイルエントリ とし、その アクセスクエリ と アクセス要求 アルゴリズムを entry のものとします。

      7. child の 名前 を name に設定します。

      8. child の バイナリデータ を空の バイトシーケンス に設定します。

      9. child の 変更タイムスタンプ を 現在の時刻に設定します。

      10. 追加 として child を entry の 子要素 に加えます。

      11. 基盤となるファイルシステムで child を作成する際に例外がスローされた場合、 プロミスを拒否 してその例外を用い、これらの手順を中止します。

          可能性のある例外をさらに具体化してください。 [Issue #11]

      12. プロミスを解決 して 子 FileSystemFileHandle を作成 した結果を locator と child の 名前 を用いて realm 内で返します。

6. result を返します。

1. result を 新しいプロミス とします。

2. realm を this の 関連する Realm とします。

3. locator を this の ロケーター とします。

4. global を this の 関連するグローバルオブジェクト とします。

5. 以下の手順をエンキュー して、ファイルシステムキュー に送ります:

   1. もし name が 有効なファイル名 でない場合、ストレージタスクをエンキュー して global に プロミスを拒否 し、TypeError を 用いてこれらの手順を中止します。

   2. entry を エントリを位置特定 する結果とします。

   3. もし options["create"] が true の場合:

      1. accessResult を entry の アクセス要求 を "readwrite" にして実行した結果とします。

   4. それ以外の場合:

      1. accessResult を entry の アクセスクエリ を "read" にして実行した結果とします。

   5. ストレージタスクをエンキュー して、global に以下の手順を実行させます:

      1. もし accessResult の 権限状態 が "granted" でない 場合、プロミスを拒否 して accessResult のエラー名 を用いてこれらの手順を中止します。

      2. もし entry が null の場合、プロミスを拒否 して "NotFoundError" DOMException を 用いてこれらの手順を中止します。

      3. アサート: entry は ディレクトリエントリ です。

      4. 各 entry の 子要素 について child を繰り返します:

         1. もし child の 名前 が name と等しい場合:

            1. もし child が ファイルエントリ の場合:

               1. プロミスを拒否 して "TypeMismatchError" DOMException を 用いてこれらの手順を中止します。

            2. プロミスを解決 して 子 FileSystemDirectoryHandle を作成 した結果を locator と child の 名前 を用いて realm 内で返し、 これらの手順を中止します。

      5. もし options["create"] が false の場合:

         1. プロミスを拒否 して "NotFoundError" DOMException を 用いてこれらの手順を中止します。

      6. child を新しい ディレクトリエントリ とし、その アクセスクエリ と アクセス要求 アルゴリズムを entry のものとします。

      7. child の 名前 を name に設定します。

      8. child の 子要素 を空の セット に設定します。

      9. 追加 として child を entry の 子要素 に加えます。

      10. 基盤となるファイルシステムで child を作成する際に例外がスローされた場合、 プロミスを拒否 してその例外を用い、これらの手順を中止します。

          可能性のある例外をさらに具体化してください。 [Issue #11]

      11. プロミスを解決 して 子 FileSystemDirectoryHandle を作成 した結果を locator と child の 名前 を用いて realm 内で返します。

6. result を返します。

1. result を 新しいプロミス とします。

2. locator を this の ロケーター とします。

3. global を this の 関連するグローバルオブジェクト とします。

4. 以下の手順をエンキュー して、ファイルシステムキュー に送ります:

   1. もし name が 有効なファイル名 でない場合、ストレージタスクをエンキュー して global に プロミスを拒否 し、TypeError を 用いてこれらの手順を中止します。

   2. entry を エントリを位置特定 する結果とします。

   3. accessResult を entry の アクセス要求 を "readwrite" にして実行した結果とします。

   4. ストレージタスクをエンキュー して、global に以下の手順を実行させます:

      1. もし accessResult の 権限状態 が "granted" でない場合、 プロミスを拒否 して accessResult のエラー名 を用いてこれらの手順を中止します。

      2. もし entry が null の場合、プロミスを拒否 して "NotFoundError" DOMException を 用いてこれらの手順を中止します。

      3. アサート: entry は ディレクトリエントリ です。

      4. 各 entry の 子要素 について child を繰り返します:

         1. もし child の 名前 が name と等しい場合:

            1. もし child が ディレクトリエントリ の場合:

               1. もし child の 子要素 が 空でない かつ options["recursive"] が false の場合:

                  1. プロミスを拒否 して "InvalidModificationError" DOMException を 用いてこれらの手順を中止します。

            2. 削除 として child を entry の 子要素 から取り除きます。

            3. 基盤となるファイルシステムで child を削除する際に例外がスローされた場合、 プロミスを拒否 してその例外を用い、これらの手順を中止します。

               注: recursive が true の場合、削除は非原子的に失敗する可能性があります。 一部のファイルまたはディレクトリは削除されるかもしれませんが、他のファイルやディレクトリはまだ存在している可能性があります。

               可能性のある例外をさらに具体化してください。 [Issue #11]

            4. プロミスを解決 して undefined を返します。

      5. プロミスを拒否 して "NotFoundError" DOMException を返します。

5. result を返します。

1. stream を 新しい FileSystemWritableFileStream として realm 内に作成します。

2. stream の [[file]] を file に設定します。

3. writeAlgorithm を chunk 引数を取り、stream および chunk を用いて チャンクを書き込む アルゴリズムを実行した結果を返すアルゴリズムとします。

4. closeAlgorithm を次の手順とします:

   1. closeResult を 新しいプロミス とします。

   2. 以下の手順をエンキュー して、ファイルシステムキュー に送ります:

      1. accessResult を file の アクセスクエリ を "readwrite" にして実行した結果とします。

      2. ストレージタスクをエンキュー して file の 関連するグローバルオブジェクト に以下の手順を実行させます:

         1. もし accessResult の 権限状態 が "granted" でない場合、 プロミスを拒否 して accessResult のエラー名 を用いてこれらの手順を中止します。

         2. 実装依存 のマルウェアスキャンおよび安全なブラウジングチェックを実行します。 これらのチェックが失敗した場合、プロミスを拒否 して "AbortError" DOMException を 用いてこれらの手順を中止します。

         3. stream の [[file]] の バイナリデータ を stream の [[buffer]] に設定します。 それが例外をスローした場合、プロミスを拒否 してその例外を用いてこれらの手順を中止します。

            注: これは書き込み対象の ディスク上のファイルの内容を原子的に更新することが期待されています。

         4. 以下の手順をエンキュー して、ファイルシステムキュー に送ります:

            1. ロックを解放 して stream の [[file]] に設定します。

            2. ストレージタスクをエンキュー して file の 関連するグローバルオブジェクト に プロミスを解決 して undefined を返します。

   3. closeResult を返します。

5. abortAlgorithm を次の手順とします:

   1. 以下の手順をエンキュー して、ファイルシステムキュー に送ります:

      1. ロックを解放 して stream の [[file]] に設定します。

6. highWaterMark を 1 に設定します。

7. sizeAlgorithm を 1 を返すアルゴリズムとします。

8. セットアップ を stream に対して行い、writeAlgorithm を writeAlgorithm に、closeAlgorithm を closeAlgorithm に、abortAlgorithm を abortAlgorithm に、highWaterMark を highWaterMark に、そして sizeAlgorithm を sizeAlgorithm に設定します。

9. stream を返します。

1. inputを、ECMAScript値をIDL値に変換する結果として設定します。 この操作で例外がスローされた場合、その例外で拒否されたPromiseを返します。

2. pを新しいPromiseにします。

3. 以下の手順をエンキューしてファイルシステムキューに追加します：

   1. accessResultを取得するために、 streamの[[file]]の アクセスを照会し、引数に"readwrite"を渡します。

   2. ストレージタスクをキューに追加し、 streamの関連するグローバルオブジェクトで以下の手順を実行します：

      1. もしaccessResultの許可状態 が"granted"でない場合、 拒否されたpを accessResultの エラー名を含むDOMException として返して、この手順を中止します。

      2. commandを、inputが"type"を持つ場合その値に、 それ以外の場合は"write"に設定します。

      3. もしcommandが"write"の場合:

         1. もしinputがundefinedであるか、inputが辞書であり、 input["data"] が存在しない場合、 拒否されたpをTypeError として返し、これらの手順を中止します。

         2. dataを、inputが["data"] を持つ場合その値に、それ以外の場合はinputに設定します。

         3. writePositionをstreamの[[seekOffset]] に設定します。

         4. もしinputが辞書であり、 input["position"] 存在する場合、writePositionを input["position"] に設定します。

         5. oldSizeをstreamの[[buffer]]の 長さに設定します。

         6. もしdataがBufferSource である場合、dataBytesをコピーした結果 とします。

         7. そうでない場合、もしdataがBlobである場合:

            1. dataBytesを 読み取り操作 をdataに対して実行した結果とします。 これが例外をスローした場合、その例外で拒否されたpを返し、 これらの手順を中止します。

         8. それ以外の場合:

            1. 断言: dataはUSVString である。

            2. dataBytesをUTF-8エンコードした dataの結果とします。

         9. もしwritePositionがoldSizeより大きい場合、 writePosition - oldSize分の0x00 (NUL)バイトを streamの[[buffer]] の末尾に追加します。

            注: 実装はスキップされたファイル内容が実際にNULバイトで埋められているかのように動作することが期待されます。 これらのバイトが実際にディスクに書き込まれディスクスペースを占有する必要はありません。 代わりに、多くのファイルシステムはスパースファイルをサポートしており、 これらのNULバイトが実際のディスクスペースを占有しないようにすることができます。

         10. headをバイト列で、 writePositionバイト分のstreamの[[buffer]] の先頭部分を持つものに設定します。

         11. tailを空のバイト列に設定します。

         12. もしwritePosition + dataの長さが oldSizeより小さい場合:

             1. tailをバイト列で、 最後のoldSize - (writePosition + dataの長さ) バイトをstreamの[[buffer]] に設定します。

         13. streamの[[buffer]] をhead、data、tailを連結したものに設定します。

         14. もしこれまでの手順でstreamの[[buffer]] を変更する操作がストレージクォータを超過したために失敗した場合、 "QuotaExceededError" DOMException を用いて拒否されたpを返し、これらの手順を中止し、 streamの[[buffer]] を変更せずに残します。

             注: ストレージクォータは バケットファイルシステム に保存されたファイルにのみ適用されます。しかし、この操作は他のファイルにも失敗する可能性があり、 例えば書き込み先のディスクがディスクスペース不足になった場合です。

         15. streamの[[seekOffset]] をwritePosition + dataの 長さ に設定します。

         16. 解決されたpを返します。

      4. それ以外の場合、もしcommandが"seek"の場合:

         1. 断言: chunkは辞書である。

         2. もしchunk["position"] が存在しない場合、 拒否されたpをTypeError として返し、この手順を中止します。

         3. streamの[[seekOffset]] を chunk["position"] に設定します。

         4. 解決されたpを返します。

      5. それ以外の場合、もしcommandが"truncate"の場合:

         1. 断言: chunkは辞書である。

         2. もしchunk["size"] が存在しない場合、 拒否されたpをTypeError として返し、この手順を中止します。

         3. newSizeをchunk["size"] に設定します。

         4. oldSizeをstreamの[[buffer]]の 長さに設定します。

         5. もしnewSizeがoldSizeより大きい場合:

            1. streamの[[buffer]] を、streamの[[buffer]] とnewSize-oldSize分の 0x00バイトを含むバイト列を連結したものに設定します。

            2. もし前のステップの操作がストレージクォータ 超過のために失敗した場合、 拒否されたpを"QuotaExceededError" DOMException として返し、これらの手順を中止し、 streamの[[buffer]] を変更せずに残します。

               注: ストレージクォータは バケットファイルシステム に保存されたファイルにのみ適用されます。しかし、この操作は他のファイルにも失敗する可能性があり、 例えば書き込み先のディスクがディスクスペース不足になった場合です。

         6. それ以外の場合、もしnewSizeがoldSizeより小さい場合:

            1. streamの[[buffer]] を、streamの[[buffer]] の最初のnewSizeバイトを含むバイト列に設定します。

         7. もしstreamの[[seekOffset]] がnewSizeより大きい場合、 streamの[[seekOffset]] をnewSizeに設定します。

         8. 解決されたpを返します。

4. pを返します。

1. writerを、ライターを取得することでthisに対して取得します。

2. resultを、writerに対してチャンクを書き込む 結果として設定します。

3. ライターを解放する writer。

4. resultを返します。

1. writerを、ライターを取得することでthisに対して取得します。

2. resultを、writerに対してチャンクを書き込む 結果として設定します。 «[ "type" → "seek", "position" → position ]».

3. ライターを解放する writer。

4. resultを返します。

1. writerを、ライターを取得することでthisに対して取得します。

2. resultを、writerに対してチャンクを書き込む 結果として設定します。 «[ "type" → "truncate", "size" → size ]».

3. ライターを解放する writer。

4. resultを返します。

1. handle を new された FileSystemSyncAccessHandle として realm 内で作成します。

2. handle の [[file]] を file に設定します。

3. handle の [[state]] を "open" に設定します。

4. handle を返します。

1. もし this の [[state]] が "closed" の場合、 スローします。 "InvalidStateError" DOMException を。

2. bufferSize を buffer の バイト長に設定します。

3. fileContents を this の [[file]] の バイナリデータに設定します。

4. fileSize を fileContents の 長さに設定します。

5. readStart を options["at"] に設定します。もし options["at"] が 存在する場合です。それ以外の場合は this の ファイルポジションカーソル に設定します。

6. もし基盤となるファイルシステムが readStart での読み取りをサポートしていない場合、 スローします。TypeError を。

7. もし readStart が fileSize より大きい場合：

   1. this の ファイルポジションカーソル を fileSize に設定します。

   2. 0 を返します。

8. readEnd を readStart + (bufferSize − 1) に設定します。

9. もし readEnd が fileSize より大きい場合、readEnd を fileSize に設定します。

10. bytes を バイトシーケンスで、 fileContents の readStart から readEnd までのバイトを含むものに設定します。

11. result を bytes の 長さに設定します。

12. もし前述のステップで fileContents からの読み取り操作が失敗した場合：

    1. 部分的な読み取りがあり、bytes に読み込まれたバイト数がわかっている場合は、 result を読み取られたバイト数に設定します。

    2. それ以外の場合、result を 0 に設定します。

13. arrayBuffer を buffer の 基盤バッファに設定します。

14. 書き込み bytes を arrayBuffer に行います。

15. this の ファイルポジションカーソル を readStart + result に設定します。

16. result を返します。

1. もし this の [[state]] が "closed" の場合、 スローします。 "InvalidStateError" DOMException を。

2. writePosition を options["at"] に設定します。もし options["at"] が 存在する場合です。それ以外の場合は this の ファイルポジションカーソル に設定します。

3. もし基盤となるファイルシステムが writePosition での書き込みをサポートしていない場合、 スローします。TypeError を。

4. fileContents を this の [[file]] の バイナリデータ のコピーに設定します。

5. oldSize を fileContents の 長さ に設定します。

6. bufferSize を buffer の バイト長 に設定します。

7. もし writePosition が oldSize より大きい場合、 writePosition − oldSize 分の 0x00 (NUL) バイトを fileContents の末尾に追加します。

   注: 実装はスキップされたファイル内容が実際に NUL バイトで埋められているかのように動作することが期待されます。 これらのバイトが実際にディスクに書き込まれディスクスペースを占有する必要はありません。 代わりに、多くのファイルシステムはスパースファイルをサポートしており、 これらの NUL バイトが実際のディスクスペースを占有しないようにすることができます。

8. head を バイトシーケンス で、 fileContents の先頭から writePosition バイト分を含むものに設定します。

9. tail を空の バイトシーケンス に設定します。

10. もし writePosition + bufferSize が oldSize より小さい場合：

    1. tail を バイトシーケンス で、 fileContents の最後の oldSize − (writePosition + bufferSize) バイトを含むものに設定します。

11. newSize を head の 長さ + bufferSize + tail の 長さ に設定します。

12. もし newSize − oldSize が利用可能な ストレージクォータ を超える場合、 スロー します。 "QuotaExceededError" DOMException を。

13. this の [[file]] の バイナリデータ を head、buffer の内容、tail を連結したものに設定します。

    注: バッファーの内容にアクセスするメカニズムは意図的に曖昧にされています。 実装は、ホストオペレーティングシステムへの直接書き込みを実行することでパフォーマンスを重視する可能性が高く （バッファーのコピーを作成する代わりに）、書き込み順序と部分的な書き込みの結果の詳細な仕様を防ぎます。

14. もし前述のステップで this の[[file]] の バイナリデータ を変更する操作が失敗した場合：

    1. 部分的な書き込みがあり、buffer から書き込まれたバイト数がわかっている場合：

       1. bytesWritten を buffer から書き込まれたバイト数に設定します。

       2. this の ファイルポジションカーソル を writePosition + bytesWritten に設定します。

       3. bytesWritten を返します。

    2. それ以外の場合、スロー します。 "InvalidStateError" DOMException を。

15. this の ファイルポジションカーソル を writePosition + bufferSize に設定します。

16. bufferSize を返します。

1. もし this の [[state]] が "closed" の場合、 スロー します。"InvalidStateError" DOMException を。

2. fileContents を this の [[file]] の バイナリデータ のコピーに設定します。

3. oldSize を 長さ に設定します。this の [[file]] の バイナリデータ の。

4. もし基盤となるファイルシステムが newSize へのサイズ設定をサポートしていない場合、 スロー します。TypeError を。

5. もし newSize が oldSize より大きい場合：

   1. もし newSize − oldSize が利用可能な ストレージクォータ を超える場合、 スロー します。"QuotaExceededError" DOMException を。

   2. this の [[file]] を次の バイトシーケンス に設定します。 これは fileContents と バイトシーケンス を連結したものです。このバイトシーケンスは newSize − oldSize 分の 0x00 バイトを含みます。

   3. もし前述のステップで this の [[file]] の バイナリデータ を変更する操作が失敗した場合、 スロー します。"InvalidStateError" DOMException を。

6. それ以外の場合、もし newSize が oldSize より小さい場合：

   1. this の [[file]] を次の バイトシーケンス に設定します。 これは fileContents の最初の newSize バイトを含みます。

   2. もし前述のステップで this の [[file]] の バイナリデータ を変更する操作が失敗した場合、 スロー します。"InvalidStateError" DOMException を。

7. もし this の ファイルポジションカーソル が newSize より大きい場合、ファイルポジションカーソル を newSize に設定します。

1. もし this の [[state]] が "closed" の場合、 スロー します。"InvalidStateError" DOMException を。

2. this の [[file]] の バイナリデータ の 長さ を返します。

1. もし this の [[state]] が "closed" の場合、 スロー します。"InvalidStateError" DOMException を。

2. ファイルの内容に対するすべてのキャッシュされた変更を、ファイルシステムの基盤となるストレージデバイスに転送しようと試みます。

   注: これはフラッシュとも呼ばれます。一部のファイルシステム（例：インメモリファイルシステム）では、フラッシュする「ディスク」がないため、これは影響を与えない場合があります。

1. もし this の [[state]] が "closed" の場合、終了します。

2. this の [[state]] を "closed" に設定します。

3. lockReleased を false に設定します。

4. file を this の [[file]] に設定します。

5. 以下のステップをエンキューして ファイルシステムキュー に追加します：

   1. ロックを解除します。file の。

   2. lockReleased を true に設定します。

6. 一時停止 します。lockReleased が true になるまで。

注: このメソッドは、ファイルのすべての変更が基盤となるストレージデバイスに即座に反映されることを保証するものではありません。この保証が必要な場合は、flush() メソッドを先に呼び出してください。

1. environmentを、現在の設定オブジェクトとします。

2. 次のパラメーターenvironmentおよび"fileSystem"を使用して、ローカルストレージボトルマップを取得を実行した結果をmapとします。これが失敗を返した場合、"SecurityError" DOMExceptionで拒否されたプロミスを返します。

3. もしmap["root"]が存在しない場合：

   1. dirを、新しいディレクトリエントリとし、そのアクセスの照会および アクセスの要求アルゴリズムが常に ファイルシステムアクセス結果を返すものとします。 結果には、許可状態 "granted" と エラー名の空文字列を含むものとします。

   2. dirの名前を空文字列に設定します。

   3. dirの子要素を空の集合に設定します。

   4. map["root"]をdirに設定します。

4. rootを実装依存の不透明な文字列とします。

5. pathを« 空文字列 »とします。

6. handleを、現在のRealmで rootとpathを用いて新しい FileSystemDirectoryHandleを作成する結果とします。

   注: rootには ストレージバケットなどの関連する識別情報が含まれる場合があります。

7. 断言: エントリの位置特定をhandleのロケーターを与えて実行した結果は、 map["root"]と同じエントリである ディレクトリエントリを返します。

8. 解決されたPromiseとしてhandleを返します。