스토리지 버킷 API

[SecureContext]
interface mixin NavigatorStorageBuckets {
  [SameObject] readonly attribute StorageBucketManager storageBuckets;
};
Navigator includes NavigatorStorageBuckets;
WorkerNavigator includes NavigatorStorageBuckets;

[Exposed=(Window,Worker),
 SecureContext]
interface StorageBucketManager {
    Promise<StorageBucket> open(DOMString name, optional StorageBucketOptions options = {});
    Promise<sequence<DOMString>> keys();
    Promise<undefined> delete(DOMString name);
};

dictionary StorageBucketOptions {
  boolean persisted = false;
  unsigned long long quota;
  DOMHighResTimeStamp expires;
};

open(name, options) 메서드 단계는 다음과 같다:

1. environment를 this의 관련 설정 객체로 둔다.

2. shelf를 environment가 주어졌을 때 로컬 스토리지 선반 획득을 실행한 결과로 둔다.

3. shelf가 failure이면, TypeError로 거부된 promise를 반환한다.

4. name으로 버킷 이름 검증을 수행한 결과가 failure이면, TypeError로 거부된 promise를 반환한다.

5. p를 새 promise로 둔다.

6. 다음 단계를 storage bucket manager에 큐에 넣는다:

   1. r를 shelf, name, options로 버킷 열기를 실행한 결과로 둔다.

   2. r가 failure이면, TypeError로 p를 reject하기 위해 스토리지 작업을 큐에 넣는다.

   3. 그렇지 않으면, r로 p를 resolve하기 위해 스토리지 작업을 큐에 넣는다.

7. p를 반환한다.

shelf에 대해, 버킷 name과 선택적 options가 주어졌을 때 버킷 열기를 하려면, 다음 단계를 실행한다:

1. expires를 undefined로 둔다.

2. options["expires"]가 존재하면 다음을 수행한다:

   1. expires를 options["expires"]로 설정한다.

   2. Unix epoch 이후 expires 밀리초가 관련 설정 객체의 현재 벽시계 시간보다 전이면 failure를 반환한다.

3. quota를 undefined로 둔다.

4. options["quota"]가 존재하면 다음을 수행한다:

   1. quota를 options["quota"]로 설정한다.

   2. quota가 0 이하이면 failure를 반환한다.

5. persisted를 false로 둔다.

6. options["persisted"]가 true이면 다음을 수행한다:

   1. permission을 "persistent-storage" 사용 권한을 요청한 결과로 둔다.

   2. permission이 "granted"이면, persisted를 true로 설정한다.

7. bucket을 shelf와 name으로 버킷 가져오기 또는 만료시키기를 실행한 결과로 둔다.

8. bucket이 null이면 다음을 수행한다:

   1. bucket을 이름이 name인 새 스토리지 버킷으로 설정한다.

   2. bucket의 할당량 값을 quota로 설정한다.

   3. shelf의 버킷 맵[name]을 bucket으로 설정한다.

9. persisted가 true이면, bucket의 버킷 모드를 "persistent"로 설정한다.

10. bucket의 만료를 Unix epoch 이후 expires 밀리초로 설정한다.

11. storageBucket을 새 StorageBucket으로 둔다.

12. storageBucket의 스토리지 버킷을 bucket으로 설정한다.

13. storageBucket을 반환한다.

문자열 name이 주어졌을 때 버킷 이름 검증을 하려면, 다음 단계를 실행한다:

1. name에 ASCII 소문자 알파벳, ASCII 숫자, U+005F (_), 또는 U+002D(-)가 아닌 코드 포인트가 포함되어 있으면 failure를 반환한다.

2. name의 코드 포인트 길이가 0이거나 64를 초과하면 failure를 반환한다.

3. name이 U+005F (_) 또는 U+002D(-)로 시작하면 failure를 반환한다.

4. 반환한다.

delete(name) 메서드 단계는 다음과 같다:

1. environment를 this의 관련 설정 객체로 둔다.

2. shelf를 environment가 주어졌을 때 로컬 스토리지 선반 획득을 실행한 결과로 둔다.

3. shelf가 failure이면, TypeError로 거부된 promise를 반환한다.

4. p를 새 promise로 둔다.

5. name으로 버킷 이름 검증을 수행한 결과가 failure이면, InvalidCharacterError로 p를 reject한다.

6. 그렇지 않으면, 다음 단계를 storage bucket manager에 큐에 넣는다:

   1. shelf와 name으로 버킷 제거를 실행한다.

   2. p를 resolve하기 위해 스토리지 작업을 큐에 넣는다.

7. p를 반환한다.

shelf에 대해 버킷 name이 주어졌을 때 버킷 제거를 하려면, 다음 단계를 실행한다:

1. shelf의 버킷 맵[name]이 존재하면 이를 bucket으로 둔다. 그렇지 않으면 반환한다.

2. shelf의 버킷 맵에서 키 name을 제거한다.

3. bucket의 removed를 true로 설정한다.

4. 반환한다.

[IndexedDB-3]는 데이터가 할당량에 의해 축출될 때 삭제가 어떻게 일어나는지를 정의해야 한다.

[FS]는 데이터가 할당량에 의해 축출될 때 Bucket File System에 대한 삭제가 어떻게 일어나는지를 정의해야 한다.

[Service-Workers]는 데이터가 할당량에 의해 축출될 때 CacheStorage와 Service Workers에 대한 삭제가 어떻게 일어나는지를 정의해야 한다.

keys() 메서드 단계는 다음과 같다:

1. shelf를 로컬 스토리지 선반 획득을 실행한 결과로 둔다.

2. shelf가 failure이면, TypeError로 거부된 promise를 반환한다.

3. p를 새 promise로 둔다.

4. keys를 새 리스트로 둔다.

5. 다음 단계를 storage bucket manager에 큐에 넣는다:

   1. shelf의 버킷 맵에 있는 각 key에 대해, 다음 단계를 실행한다:

      1. bucket을 shelf와 key로 버킷 가져오기 또는 만료시키기를 실행한 결과로 둔다.

      2. bucket이 null이 아니면, key를 keys에 추가한다.

   2. keys로 p를 resolve하기 위해 스토리지 작업을 큐에 넣는다.

6. p를 반환한다.

[Exposed=(Window,Worker),
 SecureContext]
interface StorageBucket {
  readonly attribute DOMString name;

  [Exposed=Window] Promise<boolean> persist();
  Promise<boolean> persisted();

  Promise<StorageEstimate> estimate();

  Promise<undefined> setExpires(DOMHighResTimeStamp expires);
  Promise<DOMHighResTimeStamp?> expires();

  [SameObject] readonly attribute IDBFactory indexedDB;

  [SameObject] readonly attribute CacheStorage caches;

  Promise<FileSystemDirectoryHandle> getDirectory();
};

persist() 메서드 단계는 다음과 같다:

1. bucket을 this의 스토리지 버킷으로 둔다.

2. environment를 this의 관련 설정 객체로 둔다.

3. p를 새 promise로 둔다.

4. 다음 단계를 병렬로 실행한다:

   1. bucket의 removed 플래그가 true이면, InvalidStateError로 p를 reject하기 위해 스토리지 작업을 큐에 넣는다.

   2. bucket의 버킷 모드가 "persistent"이면 persisted를 true로 둔다.

   3. 그렇지 않으면,

      1. permission을 "persistent-storage"와 environment로 현재 권한 상태 가져오기를 수행한 결과로 둔다.

      2. permission이 "granted"이면, bucket의 버킷 모드를 "persistent"로 설정하고 persisted를 true로 설정한다.

      3. 그렇지 않으면, persisted를 false로 설정한다.

   4. persisted로 p를 resolve하기 위해 스토리지 작업을 큐에 넣는다.

5. p를 반환한다.

persisted() 메서드 단계는 다음과 같다:

1. p를 새 promise로 둔다.

2. bucket을 this의 스토리지 버킷으로 둔다.

3. 그렇지 않으면, 다음 단계를 병렬로 실행한다:

   1. bucket의 removed 플래그가 true이면, InvalidStateError로 p를 reject하기 위해 스토리지 작업을 큐에 넣는다.

   2. bucket의 버킷 모드가 "persistent"이면 persistent를 true로, 그렇지 않으면 false로 둔다.

   3. persistent로 p를 resolve하기 위해 스토리지 작업을 큐에 넣는다.

4. p를 반환한다.

estimate() 메서드 단계는 다음과 같다:

1. environment를 this의 관련 설정 객체로 둔다.

2. shelf를 environment로 로컬 스토리지 선반 획득을 실행한 결과로 둔다.

3. shelf가 failure이면, TypeError로 거부된 promise를 반환한다.

4. bucket을 this의 스토리지 버킷으로 둔다.

5. bucket의 removed 플래그가 true이면, InvalidStateError로 거부된 promise를 반환한다.

6. p를 새 promise로 둔다.

7. 그렇지 않으면, 다음 단계를 병렬로 실행한다:

   1. quota를 shelf에 대한 스토리지 할당량으로 둔다.

   2. bucket의 할당량 값이 null이 아니면, quota를 그 값으로 설정한다.

   3. usage를 bucket에 대한 스토리지 사용량으로 둔다.

   4. dictionary를 StorageEstimate dictionary로 새로 만들며, 그 usage 멤버는 usage이고 quota 멤버는 quota이다.

   5. dictionary로 p를 resolve하기 위해 스토리지 작업을 큐에 넣는다.

8. p를 반환한다.

setExpires(expires) 메서드 단계는 다음과 같다:

1. p를 새 promise로 둔다.

2. bucket을 this의 스토리지 버킷으로 둔다.

3. 그렇지 않으면, 다음 단계를 병렬로 실행한다:

   1. bucket의 removed 플래그가 true이면, InvalidStateError로 p를 reject하기 위해 스토리지 작업을 큐에 넣는다.

   2. 그렇지 않으면, bucket의 만료 시간을 Unix epoch 이후 expires 밀리초로 설정한다.

   3. p를 resolve하기 위해 스토리지 작업을 큐에 넣는다.

4. p를 반환한다.

expires() 메서드 단계는 다음과 같다:

1. p를 새 promise로 둔다.

2. bucket을 this의 스토리지 버킷으로 둔다.

3. 그렇지 않으면, 다음 단계를 병렬로 실행한다:

   1. bucket의 removed 플래그가 true이면, InvalidStateError로 p를 reject하기 위해 스토리지 작업을 큐에 넣는다.

   2. 그렇지 않으면, expiration을 bucket의 만료 시간으로 둔다.

   3. expiration으로 p를 resolve하기 위해 스토리지 작업을 큐에 넣는다.

4. p를 반환한다.

StorageBucket은 IDBFactory 객체를 가지며, 초기값은 null이다. indexedDB getter 단계는 다음과 같다:

1. this의 indexedDB가 null이면, 다음 단계를 실행한다:

   1. bucket을 this의 스토리지 버킷으로 둔다.

   2. bottle map을 bucket과 "indexedDB"로 로컬 스토리지 병 맵 획득을 수행한 결과로 둔다.

   3. indexedDB를 IDBFactory 객체로 둔다.

   4. indexedDB에 대한 스토리지 병 맵을 bottle map으로 설정한다.

   5. this의 indexedDB를 indexedDB로 설정한다.

2. this의 indexedDB를 반환한다.

StorageBucket은 CacheStorage 객체를 가지며, 초기값은 null이다. caches getter 단계는 다음과 같다:

1. this의 caches가 null이면, 다음 단계를 실행한다:

   1. bucket을 this의 스토리지 버킷으로 둔다.

   2. bottle map을 bucket과 "cacheStorage"로 로컬 스토리지 병 맵 획득을 수행한 결과로 둔다.

   3. cacheStorage를 CacheStorage 객체로 둔다.

   4. cacheStorage에 대한 관련 이름-캐시 맵을 bottle map으로 설정한다.

   5. this의 caches를 cacheStorage로 설정한다.

2. this의 caches를 반환한다.

getDirectory() 단계는 다음과 같다:

1. map을 this의 스토리지 버킷과 "fileSystem"으로 로컬 스토리지 병 맵 획득을 수행한 결과로 둔다.

2. map으로 getDirectory를 수행한 결과를 반환한다.

버킷이 있는 Clear-Site-Data 헤더 구문 분석을 하려면, 다음 단계를 실행한다:

1. header의 각 type에 대해, 다음 단계를 실행한다:

   1. type이 "storage:"로 시작하지 않으면, 이 단계를 중단한다.

   2. bucket name을 type의 8부터 끝까지의 코드 단위 부분 문자열로 둔다.

   3. bucket name으로 버킷 이름 검증을 수행한 결과가 failure이면, 이 단계를 중단한다.

   4. ("storage-bucket", bucket name)으로 구성된 튜플을 types에 추가한다

bucket name이 주어졌을 때 버킷이 있는 데이터 지우기를 하려면, 다음 단계를 실행한다:

1. environment를 this의 관련 설정 객체로 둔다.

2. shelf를 environment가 주어졌을 때 로컬 스토리지 선반 획득을 실행한 결과로 둔다.

3. shelf가 failure이면, TypeError를 throw하고 이 단계를 중단한다.

4. types의 각 type에 대해, 다음 단계를 실행한다:

   1. type이 튜플이 아니거나 type[0]이 "storage-bucket"이 아니면, 이 단계를 중단한다.

   2. shelf의 버킷 맵[bucket name]이 존재하면 이를 bucket으로 둔다. 그렇지 않으면 이 단계를 중단한다

   3. bucket을 제거한다.