このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

Window: requestFileSystem() メソッド

非推奨;: この機能は非推奨になりました。まだ対応しているブラウザーがあるかもしれませんが、すでに関連するウェブ標準から削除されているか、削除の手続き中であるか、互換性のためだけに残されている可能性があります。使用を避け、できれば既存のコードは更新してください。このページの下部にある互換性一覧表を見て判断してください。この機能は突然動作しなくなる可能性があることに注意してください。

非標準: この機能は標準化されていません。非標準の機能はブラウザーの対応が限られ、将来的に変更または削除される可能性があるため、本番環境での使用は推奨されません。ただし、標準の選択肢が存在しない特定のケースでは、有効な代替手段となる場合があります。

標準外の WindowrequestFileSystem() メソッドは、 Google Chrome 固有のメソッドであり、ウェブサイトやアプリが自身の使用のためにサンドボックス化されたファイルシステムにアクセスできるようにします。返される FileSystem は、他のファイルシステム API と共に使用可能になります。

メモ: このメソッドは、実装するすべてのブラウザーにおいて webkit が接頭辞として付加されています

構文

js
requestFileSystem(type, size, successCallback)
requestFileSystem(type, size, successCallback, errorCallback)

引数

type

リクエストするストレージの種類。ブラウザーが独自の判断でファイルを削除しても問題ない場合(ストレージ容量が不足した場合など)は Window.TEMPORARY を指定し、ユーザーまたはウェブサイト/アプリが明示的に許可しない限りファイルを保持する必要がある場合は Window.PERSISTENT を指定します。 永続的ストレージを利用するには、ユーザーがサイトにクォータを付与する必要があります。

size

アプリの使用に割り当てたいストレージ容量。

successCallback

ファイルシステムが正常に取得された際に呼び出される関数。コールバックは単一の引数として、アプリが使用権限を持つファイルシステムを表す FileSystem オブジェクトを取ります。

errorCallback 省略可

ファイルシステムの取得中にエラーが発生した場合、またはユーザーがファイルシステムの作成またはアクセスを許可しなかった場合に呼び出される関数を指定するオプションの引数。コールバック関数は、エラーを説明する DOMException オブジェクトを単一の引数として受け取ります。

返値

なし (undefined)。

仕様書

このメソッドはファイルとディレクトリー項目 API の提案から削除されたため、W3C や WHATWG による公式仕様は存在しません。標準化プロセスからも外れています。

ブラウザーの互換性