From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/ja/web/api/directoryentrysync/index.html | 379 +++++++++++++++++++++++++ 1 file changed, 379 insertions(+) create mode 100644 files/ja/web/api/directoryentrysync/index.html (limited to 'files/ja/web/api/directoryentrysync/index.html') diff --git a/files/ja/web/api/directoryentrysync/index.html b/files/ja/web/api/directoryentrysync/index.html new file mode 100644 index 0000000000..4b3818da0d --- /dev/null +++ b/files/ja/web/api/directoryentrysync/index.html @@ -0,0 +1,379 @@ +--- +title: DirectoryEntrySync +slug: Web/API/DirectoryEntrySync +translation_of: Web/API/DirectoryEntrySync +--- +

{{APIRef("File System API")}}{{Non-standard_header}}

+ +

File System API の DirectoryEntrySync インターフェイスは、ファイルシステム内のディレクトリを表します。ディレクトリ内のファイルの作成、読み込み、検索、および再帰的に削除するためのメソッドが含まれています。

+ +
+

このインターフェイスは放棄されました。これは標準的なトラックにあり、良い考えではありません。もう使用しないでください。

+
+ +

このドキュメントについて

+ +

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

+ +

この仕様はかなり放棄されており、大きな牽引力には達していません。

+ +

基本的なコンセプト

+ +

サブディレクトリを作成する場合は、順番に各子ディレクトリを作成する必要があります。まだ存在しない親ディレクトリを含むフルパスを使用してディレクトリを作成しようとすると、エラーが発生します。したがって、親ディレクトリを作成した後、新しいパスを再帰的に追加して階層を作成します。

+ +

例

+ +

getFile() メソッドは、ファイルシステム内のファイルを表す FileEntrySync を返します。以下は、ルートディレクトリに seekrits.txt という名前の空のファイルを作成します。

+ +
var fileEntry = fs.root.getFile('seekrits.txt', {create: true});
+
+ +

getDirectory() メソッドは、ファイルシステム内のファイルを表す DirectoryEntrySync を返します。以下は、ルートディレクトリに superseekrit という新しいディレクトリを作成します。

+ +
var dirEntry = fs.root.getDirectory('superseekrit', {create: true});
+ +

メソッド概要

+ + + + + + + + + + + + + + + + +
DirectoryReaderSync createReader () raises (FileException);
FileEntrySync getFile (in DOMString path, in optional Flags options) raises (FileException);
DirectoryEntrySync getDirectory (in DOMString path, in optional Flags options) raises (FileException);
void removeRecursively () raises (FileException);
+ +

メソッド

+ +

createReader()

+ +

このディレクトリからエントリを読み込むための新しい DirectoryReaderSync を作成します。

+ +
DirectoryReaderSync createReader (
+) raises (FileException);
+ +
戻り値
+ +
+
DirectoryReaderSync
+
ファイルシステム内のディレクトリを表します。
+
+ +
引数
+ +

なし

+ +
例外
+ +

このメソッドは、次のコードで FileException が発生する場合があります。

+ + + + + + + + + + + + + + + + + + +
例外説明
NOT_FOUND_ERRディレクトリが存在しません。
SECURITY_ERRブラウザはメタデータを検索するのは安全ではないと判断しました。[ TODO: 理由を説明してください ]
+ +

getFile()

+ +

options パラメータをどのように設定したかに応じて、このメソッドはファイルを作成するか、既存のファイルを検索します。

+ +
void getFile (
+  in DOMString path, in optional Flags options
+) raises (FileException);
+ +
パラメータ
+ +
+
path
+
検索または作成するファイルへのディレクトリからの絶対パスまたは相対パス。直属の親が存在しないファイルを作成することはできません。最初に親ディレクトリを作成してください。
+
options
+
メソッドの動作を記述するオブジェクトリテラル。ファイルが存在しない場合は作成されます。
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
オブジェクトリテラル条件結果
create: true
+ exclusive: true		パスは既に存在するエラーが発生します。
create: true
+ exclusive: false		パスが存在せず、他のエラーが発生しないファイルが作成されます。ファイルが既に存在する場合は、エラーは発生しません。
create: false
+ (exclusive は無視される)		パスが存在するファイルが返されます。
create: false
+ (exclusive は無視される)		パスが存在しないエラーが発生します。
create: false
+ (exclusive は無視される)		パスは存在するが、ディレクトリであるエラーが発生します。
+ +
戻り値
+ +
+
FileEntrySync
+
ファイルシステム内のファイルを表します。
+
+ +
例外
+ +

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

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
例外説明
ENCODING_ERR指定されたパスは無効です。
NOT_FOUND_ERRパスは構造的には正しいのですが、存在しないリソースを参照しています。
NO_MODIFICATION_ALLOWED_ERRこれはパーミッションの問題です。対象のディレクトリまたはファイルは書き込み可能ではありません。
PATH_EXISTS_ERRファイルは既に存在しています。同じパスで別のファイルを作成することはできません。
QUOTA_EXCEEDED_ERRORこの操作により、アプリケーションがストレージのクォータを超えてしまいます。
SECURITY_ERRアプリケーションは path で参照される要素にアクセスする権限を持っていません。[ todo: 理由を説明してください ]
TYPE_MISMATCH_ERR指定されたパスは存在しますが、ディレクトリではありません。
+ +

getDirectory()

+ +

ディレクトリを作成または検索します。このメソッドは DirectoryEntrySync が渡される getFile() に似ています。

+ +
void getDirectory (
+  in DOMString path, in optional Flags options
+) raises (FileException);
+ +
Parameter
+ +
+
path
+
検索または作成するファイルへのディレクトリからの絶対パスまたは相対パス。直属の親が存在しないファイルを作成することはできません。最初に親ディレクトリを作成してください。
+
options
+
ファイルが存在しない場合のメソッドの動作を記述するオブジェクトリテラル。
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
オブジェクトリテラル条件結果
create: true
+ exclusive: true		パスは既に存在するエラーが発生します。
create: true
+ exclusive: false		パスが存在せず、他のエラーが発生しないディレクトリが作成されます。既にファイルが存在する場合はエラーは発生しません。
create: false
+ (exclusive は無視される)		パスが存在するディレクトリが返されます。
create: false
+ (exclusive は無視される)		パスが存在しないエラーが発生します。
create: false
+ (exclusive は無視される)		パスは存在するが、ディレクトリであるエラーが発生します。
+ +
Returns
+ +
+
DirectoryEntrySync
+
ファイルシステム内のディレクトリを表します。
+
+ +
Exceptions
+ +

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

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
例外説明
ENCODING_ERR指定されたパスは無効です。
NOT_FOUND_ERRパスは構造的には正しいのですが、存在しないリソースを参照しています。
NO_MODIFICATION_ALLOWED_ERRこれはパーミッションの問題です。対象のディレクトリまたはファイルは書き込み可能ではありません。
PATH_EXISTS_ERRファイルは既に存在しています。同じパスで別のファイルを作成することはできません。
QUOTA_EXCEEDED_ERRORこの操作により、アプリケーションがストレージのクォータを超えてしまいます。
SECURITY_ERRアプリケーションは path で参照される要素にアクセスする権限を持っていません。[ todo: 理由を説明してください ]
TYPE_MISMATCH_ERR指定されたパスは存在しますが、ディレクトリではありません。
+ +

removeRecursively()

+ +

ディレクトリとそのすべての内容を削除します。ファイルシステムのルートディレクトリは削除できません。

+ +

削除できないファイルを含むディレクトリを削除した場合や、削除中にエラーが発生した場合、内容の一部が削除されないことがあります。このような場合は、エラーコールバックでキャッチし、削除を再試行してください。

+ +
void removeRecursively (
+)  raises (FileException);
+ +
引数
+ +

なし

+ +
戻り値
+ +

void

+ +
例外
+ +

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

+ + + + + + + + + + + + + + + + + + + + + + + + + + +
例外説明
NOT_FOUND_ERR対象となるディレクトリが存在しません。
INVALID_STATE_ERR +

このディレクトリは、削除された以外の何らかの理由で有効でなくなっています。[todo: 説明してください]

+
NO_MODIFICATION_ALLOWED_ERRディレクトリ、その親ディレクトリ、ディレクトリ内のコンテンツの一部が書き込み不可となります。
SECURITY_ERRこのアプリケーションは、ターゲットディレクトリ、その親ディレクトリ、またはそのコンテンツの一部にアクセスする権限を持っていません。
+ +

ブラウザの互換性

+ +
+ + +

{{Compat("api.DirectoryEntrySync")}}

+
+ +

あわせて参照

+ +

仕様書: {{ spec("http://dev.w3.org/2009/dap/file-system/pub/FileSystem/", "File API: Directories and System Specification", "WD") }}

+ +

リファレンス: File System API

+ +

イントロダクション: Basic Concepts About the File System API

-- cgit v1.2.3-54-g00ecf