diff options
Diffstat (limited to 'files/ja/web/api/storagemanager')
-rw-r--r-- | files/ja/web/api/storagemanager/estimate/index.html | 104 | ||||
-rw-r--r-- | files/ja/web/api/storagemanager/index.html | 53 | ||||
-rw-r--r-- | files/ja/web/api/storagemanager/persist/index.html | 59 | ||||
-rw-r--r-- | files/ja/web/api/storagemanager/persisted/index.html | 59 |
4 files changed, 275 insertions, 0 deletions
diff --git a/files/ja/web/api/storagemanager/estimate/index.html b/files/ja/web/api/storagemanager/estimate/index.html new file mode 100644 index 0000000000..aaa52aae3f --- /dev/null +++ b/files/ja/web/api/storagemanager/estimate/index.html @@ -0,0 +1,104 @@ +--- +title: StorageManager.estimate() +slug: Web/API/StorageManager/estimate +tags: + - API + - Method + - Quota + - Reference + - Secure context + - Storage + - Storage API + - StorageManager + - Usage + - estimate + - メソッド +translation_of: Web/API/StorageManager/estimate +--- +<p>{{securecontext_header}}{{APIRef("Storage")}}</p> + +<p><span class="seoSummary"><strong><code>estimate()</code></strong> は {{domxref("StorageManager")}} インターフェイスのメソッドで、ストレージマネージャーに、現在の<a href="/ja/docs/Glossary/Same-origin_policy">オリジン</a>が使用しているストレージの大きさ (<code>usage</code>) と、利用可能な空間の量 (<code>quota</code>) を要求します。</span></p> + +<p>このメソッドは非同期的に動作するので、情報が利用可能になると解決する {{jsxref("Promise")}} を返します。プロミスの成功ハンドラーは、使用量とクォータのデータを含む {{domxref("StorageEstimate")}} を入力として受け取ります。</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="brush: js notranslate">const <var>estimatePromise</var> = <var>StorageManager</var>.estimate();</pre> + +<h3 id="Parameters" name="Parameters">引数</h3> + +<p>なし。</p> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>{{jsxref('Promise')}} で、これは {{domxref('StorageEstimate')}} 辞書に準拠したオブジェクトに解決します。この辞書には、このオリジンで利用可能なおよその大きさが {{domxref("StorageEstimate.quota")}} に、現在使用されているおよその量が {{domxref("StorageEstimate.usage")}} に入ります。</p> + +<div class="blockIndicator note"> +<p><strong>これらは正確な数値ではありません。</strong>圧縮、重複排除セキュリティ上の理由による難読化などが行われるため、正確な値にはなりません。</p> +</div> + +<p><code>quota</code> はオリジンごとに異なることに気づくかもしれません。この違いは次のような要因に基づきます。</p> + +<ul> + <li>ユーザーが訪れる頻度</li> + <li>公開されたサイトの有名度データ</li> + <li>ブックマーク、ホーム画面へ追加、プッシュ通知の受付などのユーザーのエンゲージメントの印</li> +</ul> + +<h2 id="Example" name="Example">例</h2> + +<p>この例では、使用量の概算値を取得し、現在使用しているストレージ容量のパーセント値をユーザーに提示します。</p> + +<h3 id="HTML_content" name="HTML_content">HTML の内容</h3> + +<pre class="brush: html notranslate"><label> + 現在、使用可能なストレージの約 <output id="percent"> + </output>% を使用しています。 +</label> +</pre> + +<h3 id="JavaScript_content" name="JavaScript_content">JavaScript の内容</h3> + +<pre class="brush: js notranslate">navigator.storage.estimate().then(function(estimate) { + document.getElementById("percent").value = + (estimate.usage / estimate.quota * 100).toFixed(2); +}); +</pre> + +<h3 id="Result" name="Result">結果</h3> + +<p>{{ EmbedLiveSample('Example', 600, 40) }}</p> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + <th scope="col">状態</th> + <th scope="col">備考</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('Storage','#dom-storagemanager-estimate','estimate()')}}</td> + <td>{{Spec2('Storage')}}</td> + <td>初回定義</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("api.StorageManager.estimate")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>Storage API</li> + <li>{{domxref("Storage")}}: {{domxref("Window.localStorage")}} から返されるオブジェクト</li> + <li>{{domxref("StorageManager")}}</li> + <li>{{domxref("navigator.storage")}}</li> +</ul> diff --git a/files/ja/web/api/storagemanager/index.html b/files/ja/web/api/storagemanager/index.html new file mode 100644 index 0000000000..21c5ebcaee --- /dev/null +++ b/files/ja/web/api/storagemanager/index.html @@ -0,0 +1,53 @@ +--- +title: StorageManager +slug: Web/API/StorageManager +tags: + - API + - Interface + - Persistence + - Quotas + - Reference + - Secure context + - Storage + - Storage API + - StorageManager + - Usage +translation_of: Web/API/StorageManager +--- +<p>{{securecontext_header}}{{SeeCompatTable}}{{APIRef("Storage")}}</p> + +<p><span class="seoSummary"><a href="/ja/docs/Web/API/Storage_API">Storage API</a> の <strong><code>StorageManager</code></strong> インターフェイスは、永続性のパーミッションの管理と、利用可能なストレージの見積もりのインターフェイスを提供します。{{domxref("navigator.storage")}} か {{domxref("WorkerNavigator.storage")}} のいずれかを使用して、このインターフェイスへの参照を取得できます。</span></p> + +<h2 id="Methods" name="Methods">メソッド</h2> + +<dl> + <dt>{{domxref("StorageManager.estimate()")}} {{securecontext_inline}}</dt> + <dd>オリジンの使用量とクォータを含む {{domxref("StorageEstimate")}} オブジェクトを返します。</dd> + <dt>{{domxref("StorageManager.persist()")}} {{securecontext_inline}}</dt> + <dd>ユーザーエージェントがサイトのストレージを永続化できる場合に <code>true</code> に解決される {{jsxref('Promise')}} を返します。</dd> + <dt>{{domxref("StorageManager.persisted()")}} {{securecontext_inline}}</dt> + <dd>サイトのストレージに永続性がすでに付与されている場合に <code>true</code> に解決される {{jsxref('Promise')}} を返します。</dd> +</dl> + +<h2 id="Specifications" name="Specifications">仕様</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">仕様</th> + <th scope="col">状態</th> + <th scope="col">コメント</th> + </tr> + <tr> + <td>{{SpecName('Storage','#storagemanager','StorageManger')}}</td> + <td>{{Spec2('Storage')}}</td> + <td>初期定義</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + + + +<p>{{Compat("api.StorageManager")}}</p> diff --git a/files/ja/web/api/storagemanager/persist/index.html b/files/ja/web/api/storagemanager/persist/index.html new file mode 100644 index 0000000000..eecad3accc --- /dev/null +++ b/files/ja/web/api/storagemanager/persist/index.html @@ -0,0 +1,59 @@ +--- +title: StorageManager.persist() +slug: Web/API/StorageManager/persist +tags: + - Method + - Reference + - Secure context + - Storage API + - persist() +translation_of: Web/API/StorageManager/persist +--- +<p>{{securecontext_header}}{{APIRef("Storage")}}{{SeeCompatTable}}</p> + +<p><span class="seoSummary">{{domxref("StorageManager")}} インターフェイスの <strong><code>persist()</code></strong> メソッドは、永続的ストレージ(persistent storage)を使用するパーミッションを要求します。 そして、パーミッションが付与されてボックスモードが永続的な場合は <code>true</code> に、そうでない場合は <code>false</code> に解決される {{jsxref("Promise")}} を返します。</span></p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox">navigator.storage.persist().then(function(persistent) { ... })</pre> + +<h3 id="Parameters" name="Parameters">パラメーター</h3> + +<p>なし。</p> + +<h3 id="Return_value" name="Return_value">戻り値</h3> + +<p>{{jsxref('Boolean')}} に解決される {{jsxref("Promise")}}。</p> + +<h2 id="Example" name="Example">例</h2> + +<pre class="brush: js">if (navigator.storage && navigator.storage.persist) + navigator.storage.persist().then(function(persistent) { + if (persistent) + console.log("明示的なユーザー操作以外では、ストレージは消去されません。"); + else + console.log("ストレージは UA によってストレージの圧力により消去されるかもしれません。"); + });</pre> + +<h2 id="Specifications" name="Specifications">仕様</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">仕様</th> + <th scope="col">状態</th> + <th scope="col">コメント</th> + </tr> + <tr> + <td>{{SpecName('Storage','#dom-storagemanager-persist','persist')}}</td> + <td>{{Spec2('Storage')}}</td> + <td>初期定義</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_Compatibility" name="Browser_Compatibility">ブラウザーの互換性</h2> + + + +<p>{{Compat("api.StorageManager.persist")}}</p> diff --git a/files/ja/web/api/storagemanager/persisted/index.html b/files/ja/web/api/storagemanager/persisted/index.html new file mode 100644 index 0000000000..116fa8cddb --- /dev/null +++ b/files/ja/web/api/storagemanager/persisted/index.html @@ -0,0 +1,59 @@ +--- +title: StorageManager.persisted() +slug: Web/API/StorageManager/persisted +tags: + - Method + - Reference + - Secure context + - Storage API + - persisted() +translation_of: Web/API/StorageManager/persisted +--- +<p>{{securecontext_header}}{{APIRef("Storage")}}{{SeeCompatTable}}</p> + +<p><span class="seoSummary">{{domxref("StorageManager")}} インターフェイスの <strong><code>persisted()</code></strong> メソッドは、サイトのストレージに対してボックスモードが永続的であれば <code>true</code> に解決される {{jsxref("Promise")}} を返します。</span></p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox">navigator.storage.persisted().then(function(persistent) { ... })</pre> + +<h3 id="Parameters" name="Parameters">パラメーター</h3> + +<p>なし。</p> + +<h3 id="Returns" name="Returns">戻り値</h3> + +<p>{{jsxref('Boolean')}} に解決される {{jsxref("Promise")}}。</p> + +<h2 id="Example" name="Example">例</h2> + +<pre class="brush: js"><code>if (navigator.storage && navigator.storage.persist) + navigator.storage.persisted().then(function(persistent) { + if (persistent) + console.log("明示的なユーザー操作以外では、ストレージは消去されません。"); + else + console.log("ストレージは UA によってストレージの圧力により消去されるかもしれません。"); + });</code></pre> + +<h2 id="Specifications" name="Specifications">仕様</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">仕様</th> + <th scope="col">状態</th> + <th scope="col">コメント</th> + </tr> + <tr> + <td>{{SpecName('Storage','#dom-storagemanager-persisted','persisted')}}</td> + <td>{{Spec2('Storage')}}</td> + <td>初期定義</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_Compatibility" name="Browser_Compatibility">ブラウザーの互換性</h2> + + + +<p>{{Compat("api.StorageManager.persisted")}}</p> |