LocalFileSystemSync

The LocalFileSystemSync interface of the File System API gives you access to a sandboxed file system. It is intended to be used with WebWorkers. The methods are implemented by worker objects.

このドキュメントは 2012年3月2日に最後に更新され、2011年4月19日に作成された W3C の仕様 (作業中のドラフト) に準拠しています。

この仕様は現在放棄されており、大きな牽引力を得ることはできません。

Web Worker 内から LocalFileSystemSync オブジェクトを要求することで、サンドボックス化されたファイルシステムへのアクセスを要求することができます。window オブジェクトの requestFileSystemSync() メソッドと resolveLocalFileSystemSyncURL() メソッドのグローバル メソッドは、Worker のグローバル スコープに公開されます。window.requestFileSystemSync() を呼び出すと、Web アプリのための新しいストレージが作成されます。

より多くの概念については、非同期APIの対応する記事を参照してください。

// ブラウザ固有のプレフィックスの扱い
window.requestFileSystemSync  = window.requestFileSystemSync || window.webkitRequestFileSystemSync;

// The first parameter defines the type of storage: persistent or temporary
// Next, set the size of space needed (in bytes)
// initFs is the success callback
// And the last one is the error callback
// for denial of access and other errors.

var fs = requestFileSystemSync(TEMPORARY, 1024*1024 /*1MB*/);

同期APIを使用しているので、成功とエラーのコールバックは必要ありません。

データが保存されるべきファイルシステムを要求します。このグローバル メソッド window.requestFileSystemSync() を使用して、Web ワーカー内から LocalFileSystemSync オブジェクトを要求することで、サンドボックス化されたファイルシステムにアクセスします。[ RESEARCH ]

FileSystemSync requestFileSystemSync(
  in unsigned short type,
  in unsigned long long size
);

パラメータ

type

ファイルシステムのストレージタイプ。値は、TEMPORARY または PERSISTENT のいずれかです。

size

アプリに必要なストレージ容量 (バイト単位)。

戻り値

FileSystemSync

ファイルシステムを表すオブジェクト。

例外

このメソッドは、以下のコードで FileException が発生する可能性があります。

ローカル URL で参照されたファイルやディレクトリの Entry を検索します。

void resolveLocalFileSystemURL(
  in DOMString url
);

パラメータ

url

ファイルシステム内のローカルファイルの URL。

戻り値

EntrySync

ファイルシステム内のエントリを表すオブジェクト。

例外

このメソッドは、以下のコードで FileException が発生する可能性があります。

Specification:File API: Directories and System SpecificationWD

Reference: File System API

Introduction: Basic Concepts About the File System API