blob: db973f15a949ffab92499d3526dc6f58ba134b82 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
|
---
title: JavaScript OS.File
slug: JavaScript_OS.File
tags:
- File
- IO
- JavaScript
- OS
- add-on
- platform
translation_of: Mozilla/JavaScript_code_modules/OSFile.jsm
---
<p>JavaScript モジュールの <code>OS.File</code> には、メインスレッド外でファイルを操作するためのプリミティブが含まれています。</p>
<h2 id="よくある質問_(FAQ)">よくある質問 (FAQ)</h2>
<dl>
<dt>
OS.File とは何か?</dt>
<dd>
OS.File は、<em>効率的</em>に、<em>メインスレッド外</em>で、<em>特権つき JavaScript</em> コードによりファイルを操作するために設計された新しい API です。この API は、JavaScript コードによるほとんどの XPCOM ベースのファイル操作 (nsIFile、nsIIOService のサブセット、他) を置き換える目的でつくられています。</dd>
<dt>
HTML5 File API との関係は？</dt>
<dd>
全く関係ありません。File API は、Web アプリケーションによる高レベルで制限の多いファイル操作向けに設計されています。OS.File は、Firefox 自身やアドオンにより、効率的に制限なくファイルを操作するために設計されています。</dd>
<dt>
なぜメインスレッド外の File I/O (入出力) が重要なのか？</dt>
<dd>
すべての開発者が覚えておくべきことの一つは、File I/O 操作の遅延に<em>制限がない</em>ことです。この遅延は、現在のカーネルの負荷や現在のディスク動作、現在のバスの負荷、現在のディスクの回転速度、バッテリーの残り容量など、それぞれの操作にかかる時間に依存します。私たちは、ファイルを閉じたり最終更新日時を確認したりするなど、些細に見える操作を実行する<strong>数秒間</strong>についての話をしています。<br>
このファイル操作がメインスレッドで呼び出された場合、すべてのユーザ体験がそこで数秒間つっかえることになり、全く良くありません。</dd>
<dt>
なぜ I/O 効率が重要なのか？</dt>
<dd>
I/O 効率は、<em>実際の I/O 呼び出し回数を最少化すること</em>がすべてです。一部のプラットフォーム (スマートフォンやタブレット) が極端に遅いストレージを抱えていることや、あなたのアプリケーションだけでなく潜在的にシステムで実行されているすべてのアプリケーションで I/O 操作が多いことは、プラットフォームに関係なく致命的です。これはユーザ体験のために全く良くありません。最後に、I/O はエネルギー効率の面でも不経済なため、<em>I/O を多用することはバッテリー消費を増やす</em>ことになります。<br>
必然的に、OS.File を設計の鍵の一つとして取り入れることは、すべてのプラットフォームが、同じ機能を持っていたり、開発者がそのプラットフォーム向けにアルゴリズムの最適化に使用できるようなシステム固有の情報を与えているとは限らないため、OS.File を使用することにより、開発者にどの I/O も隠さない十分な低レベルの操作を提供する (開発者がより多くの I/O 操作をできるようになる) ことができます。</dd>
</dl>
<h2 id="OS.File_の使用方法">OS.File の使用方法</h2>
<h3 id="..._メインスレッドから">... メインスレッドから</h3>
<p>OS.File は、多くの場合メインスレッドから使用します。このモードでは、メインスレッドのクライアントが API を使用して、メインスレッド外のファイル I/O を要求します。</p>
<dl>
<dt>
<a href="/ja/docs/JavaScript_OS.File/OS.File_for_the_main_thread" title="/ja/docs/JavaScript_OS.File/OS.File_for_the_main_thread">メインスレッドから OS.File を呼び出す</a></dt>
<dd>
非同期、メインスレッド外のファイル I/O、メインスレッド API。</dd>
<dt>
<a href="/ja/docs/JavaScript_OS.File/OS.File.DirectoryIterator_for_the_main_thread" title="/ja/docs/JavaScript_OS.File/OS.File.DirectoryIterator_for_the_main_thread">メインスレッドから OS.File.DirectoryIterator を呼び出す</a></dt>
<dd>
非同期、メインスレッド外のファイルディレクトリへのアクセス、メインスレッド API。</dd>
</dl>
<h3 id="..._ワーカースレッドから">... ワーカースレッドから</h3>
<p>場合によっては、OS.File のメインスレッド API の使用は適切ではありません。多くのメッセージ受け渡しを必要とする場合や、ファイル I/O を必要とするコードがワーカースレッド上ですでに実行されている場合があるためです。このような理由で、API のクライアントは、自身のワーカースレッドを生成し、OS.File をそれらのスレッドから直接使用するようにできます。</p>
<dl>
<dt>
<a href="/ja/docs/JavaScript_OS.File/OS.File_for_workers" title="/ja/docs/JavaScript_OS.File/OS.File_for_workers">ワーカースレッド用の OS.File</a></dt>
<dd>
ワーカースレッド用の同期ファイル I/O。</dd>
<dt>
<a href="/ja/docs/JavaScript_OS.File/OS.File.DirectoryIterator_for_workers" title="/ja/docs/JavaScript_OS.File/OS.File.DirectoryIterator_for_workers">ワーカースレッド用の OS.File.DirectoryIterator</a></dt>
<dd>
ワーカースレッドから直接同期的にディレクトリにアクセスします。</dd>
</dl>
<h3 id="..._共有コンポーネント">... 共有コンポーネント</h3>
<dl>
<dt>
<a href="/ja/docs/JavaScript_OS.File/OS.Path" title="/ja/docs/JavaScript_OS.File/OS.Path">OS.Path と OS.Constants.Path</a></dt>
<dd>
パスの操作。</dd>
<dt>
<a href="/ja/docs/JavaScript_OS.File/OS.File.Error" title="/ja/docs/JavaScript_OS.File/OS.File.Error">OS.File.Error</a></dt>
<dd>
フィル関連のエラーを提供します。</dd>
<dt>
<a href="/ja/docs/JavaScript_OS.File/OS.File.Info" title="/ja/docs/JavaScript_OS.File/OS.File.Info">OS.File.Info</a></dt>
<dd>
ファイル情報 (サイズ、作成日、他) を提供します。</dd>
<dt>
<a href="/ja/docs/JavaScript_OS.File/OS.File.DirectoryIterator.Entry" title="/ja/docs/JavaScript_OS.File/OS.File.DirectoryIterator.Entry">OS.File.DirectoryIterator.Entry</a></dt>
<dd>
ディレクトリへのアクセス中に取得できるファイル情報。</dd>
</dl>
|
