aboutsummaryrefslogtreecommitdiff
path: root/files/ja/web/api/storagemanager
diff options
context:
space:
mode:
Diffstat (limited to 'files/ja/web/api/storagemanager')
-rw-r--r--files/ja/web/api/storagemanager/estimate/index.html104
-rw-r--r--files/ja/web/api/storagemanager/index.html53
-rw-r--r--files/ja/web/api/storagemanager/persist/index.html59
-rw-r--r--files/ja/web/api/storagemanager/persisted/index.html59
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">&lt;label&gt;
+ 現在、使用可能なストレージの約 &lt;output id="percent"&gt;
+ &lt;/output&gt;% を使用しています。
+&lt;/label&gt;
+</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 &amp;&amp; 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 &amp;&amp; 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>