파일 시스템

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의 로케이터의 루트와 다르다면, 해결 result를 null로 설정하고, 단계를 중지합니다.

   2. childPath를 child의 로케이터의 경로로 설정합니다.

   3. rootPath를 root의 로케이터의 경로로 설정합니다.

   4. 만약 childPath가 동일한 경로라면 rootPath, 해결 result를 « »로 설정하고, 단계를 중지합니다.

   5. 만약 rootPath의 크기가 childPath의 크기보다 크다면, 해결 result를 null로 설정하고, 단계를 중지합니다.

   6. 각각의 index에 대해 rootPath의 인덱스를 반복합니다:

      1. 만약 rootPath.[[index]]가 childPath.[[index]]와 다르다면, 해결 result를 null로 설정하고, 단계를 중지합니다.

   7. relativePath를 « »로 설정합니다.

   8. 각각의 index에 대해 범위를 반복합니다. rootPath의 크기에서 시작하여, rootPath의 크기까지 독점적으로 반복하며, 추가 childPath.[[index]]를 relativePath에 설정합니다.

   9. 해결 result를 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를 새로운 프라미스로 realm에 설정합니다.

3. 다음 단계를 큐에 추가하여 파일 시스템 큐에 실행합니다:

   1. 만약 this의 로케이터가 other의 로케이터와 동일한 로케이터라면, resolve p를 true로 설정합니다.

   2. 그 외에는 resolve p를 false로 설정합니다.

4. p를 반환합니다.

1. handle을 새로운 FileSystemFileHandle로 realm에 설정합니다.

2. childType을 "file"로 설정합니다.

3. childRoot를 parentLocator의 루트의 복사본으로 설정합니다.

4. childPath를 복제된 parentLocator의 경로에 추가된 name의 결과로 설정합니다.

5. handle의 로케이터를 파일 시스템 로케이터로 설정하며, 그 종류는 childType, 루트는 childRoot, 그리고 경로는 childPath입니다.

6. handle을 반환합니다.

1. handle을 새로운 FileSystemFileHandle로 realm에 설정합니다.

2. handle의 로케이터를 파일 시스템 로케이터로 설정하며, 그 종류는 "file", 루트는 root, 그리고 경로는 path입니다.

3. handle을 반환합니다.

1. result를 새로운 프라미스로 설정합니다.

2. locator를 this의 로케이터로 설정합니다.

3. global을 this의 관련 전역 객체로 설정합니다.

4. 다음 단계를 큐에 추가하여 파일 시스템 큐에 실행합니다:

   1. entry를 locator를 입력으로 받아 항목 찾기의 결과로 설정합니다.

   2. accessResult를 "read"를 입력으로 하여 entry의 쿼리 액세스를 실행한 결과로 설정합니다.

   3. 저장 작업을 큐에 추가하여 global에서 다음 단계를 실행합니다:

      1. 만약 accessResult의 권한 상태가 "granted"가 아니라면, accessResult의 오류 이름으로 result를 거부하고 이 단계를 중단합니다.

      2. 만약 entry가 null이라면, result를 "NotFoundError" DOMException으로 거부하고 이 단계를 중단합니다.

      3. 단언: entry는 파일 항목입니다.

      4. f를 새로운 File로 설정합니다.

      5. f의 스냅샷 상태를 entry의 현재 상태로 설정합니다.

      6. f의 기본 바이트 시퀀스를 entry의 바이너리 데이터의 복사본으로 설정합니다.

      7. f의 name을 entry의 이름으로 설정합니다.

      8. f의 lastModified를 entry의 수정 타임스탬프로 설정합니다.

      9. f의 type을 구현 정의된 값으로 설정하며, 이는 예를 들어 entry의 이름이나 파일 확장자를 기반으로 합니다.

         읽기 및 스냅샷 생성 동작은 [FILE-API] 명세에서 더 명확히 정의되어야 하며, 현재로서는 다소 모호합니다.

      10. result를 f로 해결합니다.

5. result를 반환합니다.

1. result를 새로운 프라미스로 설정합니다.

2. locator를 this의 로케이터로 설정합니다.

3. realm을 this의 관련 Realm으로 설정합니다.

4. global을 this의 관련 전역 객체로 설정합니다.

5. 다음 단계를 큐에 추가하여 파일 시스템 큐에 실행합니다:

   1. entry를 locator를 입력으로 받아 항목 찾기의 결과로 설정합니다.

   2. accessResult를 "readwrite"를 입력으로 하여 entry의 요청 액세스를 실행한 결과로 설정합니다.

   3. 만약 accessResult의 권한 상태가 "granted"가 아니라면, global에서 저장 작업을 큐에 추가하여 accessResult의 오류 이름으로 result를 거부하고 이 단계를 중단합니다.

   4. 만약 entry가 null이라면, global에서 저장 작업을 큐에 추가하여 result를 "NotFoundError" DOMException으로 거부하고 이 단계를 중단합니다.

   5. 단언: entry는 파일 항목입니다.

   6. lockResult를 entry에 대해 "shared"를 입력으로 하여 잠금 가져오기의 결과로 설정합니다.

   7. global에서 저장 작업을 큐에 추가하여 다음 단계를 실행합니다:

      1. 만약 lockResult가 "failure"라면, result를 "NoModificationAllowedError" DOMException으로 거부하고 이 단계를 중단합니다.

      2. stream을 entry에 대해 realm에서 새로운 FileSystemWritableFileStream 생성의 결과로 설정합니다.

      3. 만약 options["keepExistingData"] 가 true라면:

         1. stream의 [[buffer]]를 entry의 바이너리 데이터의 복사본으로 설정합니다.

      4. result를 stream으로 해결합니다.

6. result를 반환합니다.

1. result를 새로운 프라미스로 설정합니다.

2. locator를 this의 로케이터로 설정합니다.

3. realm을 this의 관련 Realm으로 설정합니다.

4. global을 this의 관련 전역 객체로 설정합니다.

5. isInABucketFileSystem을 this가 버킷 파일 시스템에 존재한다면 true로 설정하고, 그렇지 않으면 false로 설정합니다.

6. 다음 단계를 큐에 추가하여 파일 시스템 큐에 실행합니다:

   1. entry를 locator를 입력으로 받아 항목 찾기의 결과로 설정합니다.

   2. accessResult를 "readwrite"를 입력으로 하여 entry의 요청 액세스를 실행한 결과로 설정합니다.

   3. 만약 accessResult의 권한 상태가 "granted"가 아니라면, global에서 저장 작업을 큐에 추가하여 accessResult의 오류 이름으로 result를 거부하고 이 단계를 중단합니다.

   4. 만약 isInABucketFileSystem이 false라면, global에서 저장 작업을 큐에 추가하여 result를 "InvalidStateError" DOMException으로 거부하고 이 단계를 중단합니다.

   5. 만약 entry가 null이라면, global에서 저장 작업을 큐에 추가하여 result를 "NotFoundError" DOMException으로 거부하고 이 단계를 중단합니다.

   6. 단언: entry는 파일 항목입니다.

   7. lockResult를 entry에 대해 "exclusive"를 입력으로 하여 잠금 가져오기의 결과로 설정합니다.

   8. global에서 저장 작업을 큐에 추가하여 다음 단계를 실행합니다:

      1. 만약 lockResult가 "failure"라면, result를 "NoModificationAllowedError" DOMException으로 거부하고 이 단계를 중단합니다.

      2. handle을 entry에 대해 realm에서 새로운 FileSystemSyncAccessHandle 생성의 결과로 설정합니다.

      3. result를 handle으로 해결합니다.

7. result를 반환합니다.

1. handle을 새로운 FileSystemDirectoryHandle로 realm에 설정합니다.

2. childType을 "directory"로 설정합니다.

3. childRoot를 parentLocator의 루트의 복사본으로 설정합니다.

4. childPath를 복제된 parentLocator의 경로에 추가된 name의 결과로 설정합니다.

5. handle의 로케이터를 파일 시스템 로케이터로 설정하며, 그 종류는 childType, 루트는 childRoot, 그리고 경로는 childPath입니다.

6. handle을 반환합니다.

1. handle을 새로운 FileSystemDirectoryHandle로 realm에 설정합니다.

2. handle의 로케이터를 파일 시스템 로케이터로 설정하며, 그 종류는 "directory", 루트는 root, 그리고 경로는 path입니다.

3. handle을 반환합니다.

1. iterator의 이전 결과를 빈 집합으로 설정합니다.

1. promise를 새로운 프라미스로 설정합니다.

2. 다음 단계를 큐에 추가하여 파일 시스템 큐에 실행합니다:

   1. directory를 handle의 로케이터를 입력으로 받아 항목 찾기의 결과로 설정합니다.

   2. accessResult를 "read"를 입력으로 하여 directory의 쿼리 액세스를 실행한 결과로 설정합니다.

   3. handle의 관련 전역 객체에서 저장 작업을 큐에 추가하여 다음 단계를 실행합니다:

      1. 만약 accessResult의 권한 상태가 "granted"가 아니라면, accessResult의 오류 이름으로 promise를 거부하고 이 단계를 중단합니다.

      2. 만약 directory가 null이라면, result를 "NotFoundError" DOMException으로 거부하고 이 단계를 중단합니다.

         1. 단언: directory는 디렉토리 항목입니다.

      3. child를 directory의 자식 항목 중 하나로 설정하며, child의 이름이 iterator의 이전 결과에 포함되지 않은 항목이어야 합니다. 그러한 항목이 없으면 null로 설정합니다.

         참고: 이는 반복 순서에 대해 의도적으로 모호하게 정의되어 있습니다. 서로 다른 플랫폼과 파일 시스템은 반복 순서에 대해 서로 다른 보장을 제공하며, 모든 플랫폼에서 효율적으로 구현할 수 있도록 하기 위해 정확한 순서에 대한 보장은 제공되지 않습니다.

      4. 만약 child가 null이라면, promise를 undefined로 해결하고 이 단계를 중단합니다.

      5. child의 이름을 iterator의 이전 결과에 추가합니다.

      6. 만약 child가 파일 항목이라면:

         1. result를 handle의 로케이터와 child의 이름, 그리고 handle의 관련 Realm을 사용하여 자식 FileSystemFileHandle 생성의 결과로 설정합니다.

      7. 그 외에는:

         1. result를 handle의 로케이터와 child의 이름, 그리고 handle의 관련 Realm을 사용하여 자식 FileSystemDirectoryHandle 생성의 결과로 설정합니다.

      8. promise를 (child의 이름, result)로 해결합니다.

3. promise를 반환합니다.

1. result를 새로운 프라미스로 설정합니다.

2. realm을 this의 관련 Realm으로 설정합니다.

3. locator를 this의 로케이터로 설정합니다.

4. global을 this의 관련 전역 객체로 설정합니다.

5. 다음 단계를 큐에 추가하여 파일 시스템 큐에 실행합니다:

   1. 만약 name이 유효한 파일 이름이 아니라면, global에서 저장 작업을 큐에 추가하여 result를 TypeError로 거부하고 이 단계를 중단합니다.

   2. entry를 locator를 입력으로 받아 항목 찾기의 결과로 설정합니다.

   3. 만약 options["create"] 가 true라면:

      1. accessResult를 "readwrite"를 입력으로 하여 entry의 요청 액세스를 실행한 결과로 설정합니다.

   4. 그 외에는:

      1. accessResult를 "read"를 입력으로 하여 entry의 쿼리 액세스를 실행한 결과로 설정합니다.

   5. global에서 저장 작업을 큐에 추가하여 다음 단계를 실행합니다:

      1. 만약 accessResult의 권한 상태가 "granted"가 아니라면, accessResult의 오류 이름으로 result를 거부하고 이 단계를 중단합니다.

      2. 만약 entry가 null이라면, result를 "NotFoundError" DOMException으로 거부하고 이 단계를 중단합니다.

      3. 단언: entry는 디렉토리 항목입니다.

      4. entry의 자식 항목을 각각 child에 대해 반복합니다:

         1. 만약 child의 이름이 name과 같다면:

            1. 만약 child가 디렉토리 항목이라면:

               1. result를 "TypeMismatchError" DOMException으로 거부하고 이 단계를 중단합니다.

            2. result를 locator와 child의 이름, realm을 사용하여 자식 FileSystemFileHandle 생성의 결과로 해결하고 이 단계를 중단합니다.

      5. 만약 options["create"] 가 false라면:

         1. result를 "NotFoundError" DOMException으로 거부하고 이 단계를 중단합니다.

      6. child를 새 파일 항목으로 설정하며, child의 쿼리 액세스 및 요청 액세스 알고리즘은 entry와 동일하게 합니다.

      7. child의 이름을 name으로 설정합니다.

      8. child의 바이너리 데이터를 빈 바이트 시퀀스로 설정합니다.

      9. child의 수정 타임스탬프를 현재 시간으로 설정합니다.

      10. entry의 자식 항목에 child를 추가합니다.

      11. 기본 파일 시스템에서 child를 생성하는 동안 예외가 발생하면, 해당 예외로 result를 거부하고 이 단계를 중단합니다.

          발생할 수 있는 예외를 더 잘 명시해야 합니다. [Issue #11]

      12. result를 locator와 child의 이름, realm을 사용하여 자식 FileSystemFileHandle 생성의 결과로 해결합니다.

6. result를 반환합니다.

1. result를 새로운 프라미스로 설정합니다.

2. realm을 this의 관련 Realm으로 설정합니다.

3. locator를 this의 로케이터로 설정합니다.

4. global을 this의 관련 전역 객체로 설정합니다.

5. 다음 단계를 큐에 추가하여 파일 시스템 큐에 실행합니다:

   1. 만약 name이 유효한 파일 이름이 아니라면, global에서 저장 작업을 큐에 추가하여 result를 TypeError로 거부하고 이 단계를 중단합니다.

   2. entry를 locator를 입력으로 받아 항목 찾기의 결과로 설정합니다.

   3. 만약 options["create"] 가 true라면:

      1. accessResult를 "readwrite"를 입력으로 하여 entry의 요청 액세스를 실행한 결과로 설정합니다.

   4. 그 외에는:

      1. accessResult를 "read"를 입력으로 하여 entry의 쿼리 액세스를 실행한 결과로 설정합니다.

   5. global에서 저장 작업을 큐에 추가하여 다음 단계를 실행합니다:

      1. 만약 accessResult의 권한 상태가 "granted"가 아니라면, accessResult의 오류 이름으로 result를 거부하고 이 단계를 중단합니다.

      2. 만약 entry가 null이라면, result를 "NotFoundError" DOMException으로 거부하고 이 단계를 중단합니다.

      3. 단언: entry는 디렉토리 항목입니다.

      4. entry의 자식 항목을 각각 child에 대해 반복합니다:

         1. 만약 child의 이름이 name과 같다면:

            1. 만약 child가 파일 항목이라면:

               1. result를 "TypeMismatchError" DOMException으로 거부하고 이 단계를 중단합니다.

            2. result를 locator와 child의 이름, realm을 사용하여 자식 FileSystemDirectoryHandle 생성의 결과로 해결하고 이 단계를 중단합니다.

      5. 만약 options["create"] 가 false라면:

         1. result를 "NotFoundError" DOMException으로 거부하고 이 단계를 중단합니다.

      6. child를 새 디렉토리 항목으로 설정하며, child의 쿼리 액세스 및 요청 액세스 알고리즘은 entry와 동일하게 합니다.

      7. child의 이름을 name으로 설정합니다.

      8. child의 자식 항목을 빈 집합으로 설정합니다.

      9. entry의 자식 항목에 child를 추가합니다.

      10. 기본 파일 시스템에서 child를 생성하는 동안 예외가 발생하면, 해당 예외로 result를 거부하고 이 단계를 중단합니다.

          발생할 수 있는 예외를 더 잘 명시해야 합니다. [Issue #11]

      11. result를 locator와 child의 이름, realm을 사용하여 자식 FileSystemDirectoryHandle 생성의 결과로 해결합니다.

6. result를 반환합니다.

1. result를 새로운 프라미스로 설정합니다.

2. locator를 this의 로케이터로 설정합니다.

3. global을 this의 관련 전역 객체로 설정합니다.

4. 다음 단계를 큐에 추가하여 파일 시스템 큐에 실행합니다:

   1. 만약 name이 유효한 파일 이름이 아니라면, global에서 저장 작업을 큐에 추가하여 result를 TypeError로 거부하고 이 단계를 중단합니다.

   2. entry를 locator를 입력으로 받아 항목 찾기의 결과로 설정합니다.

   3. accessResult를 "readwrite"를 입력으로 하여 entry의 요청 액세스를 실행한 결과로 설정합니다.

   4. global에서 저장 작업을 큐에 추가하여 다음 단계를 실행합니다:

      1. 만약 accessResult의 권한 상태가 "granted"가 아니라면, accessResult의 오류 이름으로 result를 거부하고 이 단계를 중단합니다.

      2. 만약 entry가 null이라면, result를 "NotFoundError" DOMException으로 거부하고 이 단계를 중단합니다.

      3. 단언: entry는 디렉토리 항목입니다.

      4. entry의 자식 항목을 각각 child에 대해 반복합니다:

         1. 만약 child의 이름이 name과 같다면:

            1. 만약 child가 디렉토리 항목이라면:

               1. 만약 child의 자식 항목이 비어 있지 않으며, options["recursive"] 가 false라면:

                  1. result를 "InvalidModificationError" DOMException으로 거부하고 이 단계를 중단합니다.

            2. child를 entry의 자식 항목에서 제거합니다.

            3. 기본 파일 시스템에서 child를 제거하는 동안 예외가 발생하면, 해당 예외로 result를 거부하고 이 단계를 중단합니다.

               참고: recursive 가 true인 경우, 제거는 비원자적일 수 있습니다. 일부 파일 또는 디렉토리는 제거된 반면, 다른 파일 또는 디렉토리는 여전히 존재할 수 있습니다.

               발생할 수 있는 예외를 더 잘 명시해야 합니다. [Issue #11]

            4. result를 undefined로 해결합니다.

      5. result를 "NotFoundError" DOMException으로 거부합니다.

5. result를 반환합니다.

1. stream을 새로운 FileSystemWritableFileStream 으로 realm에 설정합니다.

2. stream의 [[file]]을 file로 설정합니다.

3. writeAlgorithm을 chunk 인수를 받아들이고 write a chunk 알고리즘을 stream과 chunk로 실행한 결과를 반환하는 알고리즘으로 설정합니다.

4. closeAlgorithm을 다음 단계로 설정합니다:

   1. closeResult를 새로운 프라미스로 설정합니다.

   2. 다음 단계를 큐에 추가하여, 파일 시스템 큐에 실행합니다:

      1. accessResult를 "readwrite"를 입력으로 하여 file의 쿼리 액세스를 실행한 결과로 설정합니다.

      2. file의 관련 전역 객체에서 저장 작업을 큐에 추가하여 다음 단계를 실행합니다:

         1. 만약 accessResult의 권한 상태가 "granted"가 아니라면, accessResult의 오류 이름으로 closeResult를 거부하고 이 단계를 중단합니다.

         2. 구현 정의된 악성코드 스캔 및 안전 브라우징 검사를 실행합니다. 이러한 검사가 실패하면, closeResult를 "AbortError" DOMException으로 거부하고 이 단계를 중단합니다.

         3. stream의 [[file]]의 바이너리 데이터를 stream의 [[buffer]]로 설정합니다. 예외가 발생하면, closeResult를 해당 예외로 거부하고 이 단계를 중단합니다.

            참고: 이는 디스크에 기록 중인 파일의 내용을 원자적으로 업데이트할 것으로 예상됩니다.

         4. 다음 단계를 큐에 추가하여 파일 시스템 큐에 실행합니다:

            1. stream의 [[file]]에 대한 잠금 해제를 실행합니다.

            2. file의 관련 전역 객체에서 저장 작업을 큐에 추가하여, closeResult를 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을 변환하여 chunk를 FileSystemWriteChunkType으로 설정합니다. 변환 중 예외가 발생하면, 해당 예외로 거부된 프라미스를 반환합니다.

2. p를 새로운 프라미스로 설정합니다.

3. 다음 단계를 큐에 추가하여 파일 시스템 큐에 실행합니다:

   1. accessResult를 stream의 [[file]]의 쿼리 액세스를 "readwrite"로 실행한 결과로 설정합니다.

   2. 저장 작업을 큐에 추가하여 stream의 관련 전역 객체에서 다음 단계를 실행합니다:

      1. 만약 accessResult의 권한 상태가 "granted"가 아니라면, accessResult의 오류 이름으로 p를 거부하고 이 단계를 중단합니다.

      2. command를 input["type"] 로 설정합니다. 단, input이 딕셔너리가 아닌 경우, "write"로 설정합니다.

      3. 만약 command가 "write"라면:

         1. 만약 input이 undefined이거나 input이 딕셔너리이고 input["data"] 가 존재하지 않는다면, p를 TypeError로 거부하고 이 단계를 중단합니다.

         2. data를 input["data"] 로 설정합니다. 단, input이 딕셔너리가 아닌 경우, 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를 읽기 작업을 수행한 결과로 설정합니다. 예외가 발생하면, p를 해당 예외로 거부하고 이 단계를 중단합니다.

         8. 그 외:

            1. 단언: data는 USVString입니다.

            2. dataBytes를 UTF-8로 인코딩한 결과로 설정합니다.

         9. 만약 writePosition이 oldSize보다 크다면, writePosition - oldSize 만큼의 0x00 (NUL) 바이트를 stream의 [[buffer]] 끝에 추가합니다.

            참고: 구현체는 건너뛴 파일 내용이 실제로 NUL 바이트로 채워진 것처럼 동작해야 합니다. 이것이 실제로 디스크에 작성되어 공간을 차지해야 한다는 의미는 아닙니다. 대부분의 파일 시스템은 이러한 NUL 바이트가 실제 디스크 공간을 차지하지 않는 희소 파일을 지원합니다.

         10. head를 바이트 시퀀스로 설정하며, stream의 [[buffer]]의 처음 writePosition 바이트를 포함합니다.

         11. tail를 빈 바이트 시퀀스로 설정합니다.

         12. 만약 writePosition + data의 길이가 oldSize보다 작다면:

             1. tail를 바이트 시퀀스로 설정하며, stream의 [[buffer]]의 마지막 oldSize - (writePosition + data의 길이) 바이트를 포함합니다.

         13. stream의 [[buffer]]를 head, data, tail의 연결로 설정합니다.

         14. 만약 이전 단계에서 stream의 [[buffer]]를 수정하는 작업이 저장소 할당량을 초과하여 실패한 경우, p를 "QuotaExceededError" DOMException로 거부하고 이 단계를 중단하며, stream의 [[buffer]]는 수정하지 않습니다.

             참고: 저장소 할당량은 버킷 파일 시스템에 저장된 파일에만 적용됩니다. 그러나 이 작업은 여전히 다른 파일에서도 실패할 수 있습니다. 예를 들어, 쓰기를 시도하는 디스크의 공간이 부족한 경우입니다.

         15. stream의 [[seekOffset]]를 writePosition + data의 길이로 설정합니다.

         16. Resolve p.

      4. 그 외, 만약 command가 "seek"라면:

         1. 단언: chunk는 딕셔너리입니다.

         2. 만약 chunk["position"] 가 존재하지 않는다면, p를 TypeError로 거부하고 이 단계를 중단합니다.

         3. stream의 [[seekOffset]]를 chunk["position"]로 설정합니다.

         4. Resolve 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. Resolve p.

4. p를 반환합니다.

1. writer를 writer 가져오기를 통해 this에서 가져온 결과로 설정합니다.

2. result를 청크 쓰기를 writer와 data를 사용하여 실행한 결과로 설정합니다.

3. writer 해제를 실행합니다.

4. result를 반환합니다.

1. writer를 writer 가져오기를 통해 this에서 가져온 결과로 설정합니다.

2. result를 청크 쓰기를 writer와 «[ "type" → "seek", "position" → position ]»를 사용하여 실행한 결과로 설정합니다.

3. writer 해제를 실행합니다.

4. result를 반환합니다.

1. writer를 writer 가져오기를 통해 this에서 가져온 결과로 설정합니다.

2. result를 청크 쓰기를 writer와 «[ "type" → "truncate", "size" → size ]»를 사용하여 실행한 결과로 설정합니다.

3. writer 해제를 실행합니다.

4. result를 반환합니다.

1. handle을 새로운 FileSystemSyncAccessHandle 으로 realm에 설정합니다.

2. handle의 [[file]]을 file로 설정합니다.

3. handle의 [[state]]를 "open"으로 설정합니다.

4. handle을 반환합니다.

1. 만약 this의 [[state]]가 "closed"라면, "InvalidStateError" DOMException을 throw합니다.

2. bufferSize를 buffer의 바이트 길이로 설정합니다.

3. fileContents를 this의 [[file]]의 바이너리 데이터로 설정합니다.

4. fileSize를 fileContents의 길이로 설정합니다.

5. readStart를 options["at"] 로 설정합니다. 단, options["at"] 가 존재하지 않는다면, this의 파일 위치 커서로 설정합니다.

6. 만약 기본 파일 시스템이 readStart 파일 오프셋에서 읽기를 지원하지 않는다면, throw 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. Write bytes를 arrayBuffer에 씁니다.

15. this의 파일 위치 커서를 readStart + result로 설정합니다.

16. result를 반환합니다.

1. 만약 this의 [[state]]가 "closed"라면, "InvalidStateError" DOMException을 throw합니다.

2. writePosition를 options["at"] 로 설정합니다. 단, options["at"] 가 존재하지 않는다면, this의 파일 위치 커서로 설정합니다.

3. 만약 기본 파일 시스템이 writePosition 파일 오프셋에서 쓰기를 지원하지 않는다면, throw 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가 사용 가능한 저장소 할당량을 초과한다면, throw "QuotaExceededError" DOMException.

13. this의 [[file]]의 바이너리 데이터를 head, buffer의 내용, tail의 연결로 설정합니다.

    참고: 버퍼의 내용을 접근하는 메커니즘은 의도적으로 모호하게 설정되었습니다. 구현체는 성능을 중점으로 하여 호스트 운영 체제에 직접 쓰기 호출을 실행하는 방식을 선택할 가능성이 높습니다 (버퍼의 복사본을 생성하는 대신), 이는 쓰기 순서와 부분 쓰기의 결과에 대한 자세한 명세를 방해합니다.

14. 만약 이전 단계를 통해 this의[[file]]의 바이너리 데이터를 수정하는 작업이 실패했다면:

    1. 부분적으로 기록된 바이트가 있고 buffer에서 기록된 바이트 수를 아는 경우:

       1. bytesWritten을 buffer에서 기록된 바이트 수로 설정합니다.

       2. this의 파일 위치 커서를 writePosition + bytesWritten으로 설정합니다.

       3. bytesWritten을 반환합니다.

    2. 그 외에는 throw "InvalidStateError" DOMException.

15. this의 파일 위치 커서를 writePosition + bufferSize로 설정합니다.

16. bufferSize를 반환합니다.

1. 만약 this의 [[state]]가 "closed"라면, "InvalidStateError" DOMException을 throw합니다.

2. fileContents를 this의 [[file]]의 바이너리 데이터의 복사본으로 설정합니다.

3. oldSize를 길이로 설정하고 this의 [[file]]의 바이너리 데이터로 설정합니다.

4. 만약 기본 파일 시스템이 파일 크기를 newSize로 설정하는 것을 지원하지 않는다면, throw TypeError.

5. 만약 newSize가 oldSize보다 크다면:

   1. 만약 newSize − oldSize가 사용 가능한 저장소 할당량을 초과한다면, throw "QuotaExceededError" DOMException.

   2. this의 [[file]]를 fileContents와 newSize − oldSize 0x00 바이트를 포함하는 바이트 시퀀스로 연결하여 설정합니다.

   3. 만약 이전 단계에서 this의 [[file]]의 바이너리 데이터를 수정하는 작업이 실패했다면, "InvalidStateError" DOMException을 throw합니다.

6. 그 외, 만약 newSize가 oldSize보다 작다면:

   1. this의 [[file]]를 fileContents의 처음 newSize 바이트를 포함하는 바이트 시퀀스로 설정합니다.

   2. 만약 이전 단계에서 this의 [[file]]의 바이너리 데이터를 수정하는 작업이 실패했다면, "InvalidStateError" DOMException을 throw합니다.

7. 만약 this의 파일 위치 커서가 newSize보다 크다면, 파일 위치 커서를 newSize로 설정합니다.

1. 만약 this의 [[state]]가 "closed"라면, "InvalidStateError" DOMException을 throw합니다.

2. this의 [[file]]의 바이너리 데이터의 길이를 반환합니다.

1. 만약 this의 [[state]]가 "closed"라면, "InvalidStateError" DOMException을 throw합니다.

2. 파일 내용의 모든 캐시된 수정 사항을 파일 시스템의 기본 저장 장치로 전송하려고 시도합니다.

   참고: 이는 플러싱(flushing)이라고도 알려져 있습니다. 일부 메모리 파일 시스템과 같이 "디스크"로 플러시할 필요가 없는 파일 시스템에서는 이 작업이 아무 작업도 수행하지 않을 수 있습니다.

1. 만약 this의 [[state]]가 "closed"라면, 반환합니다.

2. this의 [[state]]를 "closed"로 설정합니다.

3. lockReleased를 false로 설정합니다.

4. file을 this의 [[file]]로 설정합니다.

5. 다음 단계를 큐에 추가하여 파일 시스템 큐에 실행합니다:

   1. 잠금을 해제합니다. file에 대해.

   2. lockReleased를 true로 설정합니다.

6. Pause하여 lockReleased가 true가 될 때까지 대기합니다.

참고: 이 메서드는 모든 파일 수정 사항이 기본 저장 장치에 즉시 반영될 것을 보장하지 않습니다. 이러한 보장이 필요한 경우 flush() 메서드를 먼저 호출하세요.

1. environment를 현재 설정 객체로 설정합니다.

2. map를 environment와 "fileSystem"을 사용하여 로컬 저장소 병 맵 획득을 실행한 결과로 설정합니다. 실패를 반환하면, "SecurityError" DOMException으로 거부된 프라미스를 반환합니다.

3. 만약 map["root"]이 존재하지 않는다면:

   1. dir을 디렉토리 항목으로 설정합니다. 이 항목의 쿼리 액세스와 요청 액세스 알고리즘은 항상 "granted" 파일 시스템 액세스 결과를 반환하며, 오류 이름은 빈 문자열로 설정합니다.

   2. dir의 이름을 빈 문자열로 설정합니다.

   3. dir의 하위 항목을 빈 집합으로 설정합니다.

   4. map["root"]을 dir로 설정합니다.

4. root를 구현 정의 불투명한 문자열로 설정합니다.

5. path를 « 빈 문자열 »로 설정합니다.

6. handle을 새로운 FileSystemDirectoryHandle 생성을 실행한 결과로 설정합니다. root와 path를 현재 Realm에서 사용하여.

   참고: root는 관련 식별 정보(예: 저장소 버킷)를 포함할 수 있습니다.

7. 단언: 항목 위치 찾기를 handle의 로케이터 를 사용하여 실행하면 map["root"]와 동일한 디렉토리 항목을 반환합니다.

8. 프라미스가 해결된 handle을 반환합니다.