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/fileexception/index.html | 145 ++++++++++++++++++++++++++++++ 1 file changed, 145 insertions(+) create mode 100644 files/ja/web/api/fileexception/index.html (limited to 'files/ja/web/api/fileexception') diff --git a/files/ja/web/api/fileexception/index.html b/files/ja/web/api/fileexception/index.html new file mode 100644 index 0000000000..3e35e66386 --- /dev/null +++ b/files/ja/web/api/fileexception/index.html @@ -0,0 +1,145 @@ +--- +title: FileException +slug: Web/API/FileException +tags: + - API + - File API + - File System API + - オフライン + - ファイルシステム + - リファレンス + - 廃止 + - 非標準 +translation_of: Web/API/FileException +--- +
{{APIRef("File System API")}}{{Non-standard_Header}}{{Obsolete_Header}}
+ +

File System API では、FileException オブジェクトは、同期 API を使用してファイルシステムにアクセスする際に発生する可能性のあるエラー状態を表します。File Writer で説明されている FileException インターフェイスを拡張し、いくつかの新しいエラーコードを追加します。

+ +

基本コンセプト

+ +

同期 API にはエラーコールバックがないため、エラーを捕捉することが困難です。この API で WebWorkers を使用することの複雑さが増すと、デバッグがさらに困難になります。簡単にするには、worker コードを try/catch でラップしてください。エラーが発生した場合は、次のように postMessage() を使用してメインアプリに転送します。

+ +
function onError(e) {
+  postMEssage('ERROR:' + e.toString());
+}
+
+try {
+  //Error is thrown if "log.txt" already exists.
+var fileEntry = fs.root.getFile('log.txt', {create: true, exclusive:true}0;
+} catch (e) {
+  onErrror(e);
+}
+ +

HTML5Rocks からサンプルコードを借用しました

+ +

属性

+ + + + + + + + + + + + + + + + +
属性タイプ説明
codeunsigned short条件に最も適切なエラーコード。
+ +

定数

+ +

{{Note("定数の数値には依存しないでください。仕様の変更に伴い変更される可能性があります。代わりに定数名を使用してください。")}}

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
定数値説明
ENCODING_ERR5URL の形式が正しくありません。URL が完全で有効であることを確認してください。
INVALID_MODIFICATION_ERR9要求された変更は許可されていません。無効な変更の例としては、ディレクトリを自身の子に移動すること、または名前を変更せずに親ディレクトリにファイルを移動することが含まれます。
INVALID_STATE_ERR7インターフェイスオブジェクトの現在の状態で操作を実行することはできません。たとえば、インターフェイスオブジェクトにキャッシュされた状態は、ディスクから最後に読み取られた後に変更されているなどです。
NO_MODIFICATION_ALLOWED_ERR6ベースとなるファイルシステムの状態により、ファイルまたはディレクトリへの書き込みが許可されていません。
NOT_FOUND_ERR1操作が処理された時点で、必要なファイルまたはディレクトリが見つかりませんでした。たとえば、ファイルが存在せず、開かれている場合です。
NOT_READABLE_ERR4 +

ファイルまたはディレクトリを読み取ることはできません。通常、ファイルへの参照が取得された後に発生するアクセス許可の問題が原因です (たとえば、ファイルまたはディレクトリが別のアプリケーションによって同時にロックされている場合)。

+
PATH_EXISTS_ERR12同じパスを持つファイルまたはディレクトリが既に存在します。
QUOTA_EXCEEDED_ERR10 +

残りのストレージスペースが不足しているか、ストレージクォータに達していて、ユーザーがデータベースにスペースを増やすことを拒否しました。

+
SECURITY_ERR2 +

ファイルへのアクセスは、次のいずれかの理由で拒否されました。

+ +
    +
  • これらのファイルは、Web アプリケーション内でアクセスするには安全でない可能性があります。
    • +
  • ファイルリソースの呼び出しが多すぎます。
    • +
  • その他の不特定のセキュリティエラーコードまたは状況。
    • +
+
TYPE_MISMATCH_ERR11ユーザーがファイルまたはディレクトリを検索しようとしましたが、見つかったエントリのタイプが間違っています。たとえば、ユーザーが FileEntry を要求しているときに、アプリケーションは DirectoryEntry にアクセスしている場合です。
+ +

ブラウザの互換性

+ + + +

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

+ +

あわせて参照

+ +

仕様: {{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