DirectoryEntrySync

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});

メソッド概要

メソッド

createReader()

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

DirectoryReaderSync createReader (
) raises (FileException);

戻り値

DirectoryReaderSync

ファイルシステム内のディレクトリを表します。

引数

なし

例外

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

getFile()

Depending on how you've set the options parameter, the method either creates a file or looks up an existing file.

void getFile (
  in DOMString path, in optional Flags options
) raises (FileException);

Parameter

path

Either an absolute path or a relative path from the directory to the file to be looked up or created. You cannot create a file whose immediate parent does not exist. Create the parent directory first.

options

An object literal describing the behavior of the method. If the file does not exist, it is created.

Returns

FileEntrySync

Represents a file in a file system.

Exceptions

This method can raise a FileException with the following codes:

getDirectory()

Creates or looks up a directory. The method is similar to getFile() with DirectoryEntrySync being passed.

void getDirectory (
  in DOMString path, in optional Flags options
) raises (FileException);

Parameter

path

Either an absolute path or a relative path from the directory to the file to be looked up or created. You cannot create a file whose immediate parent does not exist. Create the parent directory first.

options

An object literal describing the behavior of the method if the file does not exist.

Returns

DirectoryEntrySync

Represents a directory in a file system.

Exceptions

This method can raise a FileException with the following codes:

removeRecursively()

Deletes a directory and all of its contents. You cannot delete the root directory of a file system.

If you delete a directory that contains a file that cannot be removed or if an error occurs while the deletion is in progress, some of the contents might not be deleted. Catch these cases with error callbacks and retry the deletion.

void removeRecursively (
)  raises (FileException);

引数

なし

Returns

void

Exceptions

This method can raise a FileException with the following codes:

ブラウザの互換性

あわせて参照

仕様書: File API: Directories and System SpecificationWD

リファレンス: File System API

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