From a065e04d529da1d847b5062a12c46d916408bf32 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 21:46:22 -0500 Subject: update based on https://github.com/mdn/yari/issues/2028 --- .../checkinstalled/index.html | 49 ----------- .../getinstalled/index.html | 40 --------- .../api/domapplicationsregistry/getself/index.html | 47 ----------- .../ja/web/api/domapplicationsregistry/index.html | 45 ---------- .../api/domapplicationsregistry/install/index.html | 96 ---------------------- .../installpackage/index.html | 46 ----------- 6 files changed, 323 deletions(-) delete mode 100644 files/ja/web/api/domapplicationsregistry/checkinstalled/index.html delete mode 100644 files/ja/web/api/domapplicationsregistry/getinstalled/index.html delete mode 100644 files/ja/web/api/domapplicationsregistry/getself/index.html delete mode 100644 files/ja/web/api/domapplicationsregistry/index.html delete mode 100644 files/ja/web/api/domapplicationsregistry/install/index.html delete mode 100644 files/ja/web/api/domapplicationsregistry/installpackage/index.html (limited to 'files/ja/web/api/domapplicationsregistry') diff --git a/files/ja/web/api/domapplicationsregistry/checkinstalled/index.html b/files/ja/web/api/domapplicationsregistry/checkinstalled/index.html deleted file mode 100644 index 88b7ededb5..0000000000 --- a/files/ja/web/api/domapplicationsregistry/checkinstalled/index.html +++ /dev/null @@ -1,49 +0,0 @@ ---- -title: Apps.checkInstalled -slug: Web/API/DOMApplicationsRegistry/checkInstalled -tags: - - API - - Apps - - Apps API - - Firefox OS - - Method -translation_of: Archive/Marketplace/API/DOMApplicationsRegistry/checkInstalled ---- -

{{ ApiRef() }}

-

{{ non-standard_header() }}

-

概要

-

指定されたアプリについての情報を取得します。これを使って、そのアプリがインストールされているかどうかを判別できます。

-

構文

-
var request = window.navigator.mozApps.checkInstalled(url);
-
-

引数

-
-
- url
-
- アプリの マニフェスト の場所を含んだ 文字列型 の URL。
-
-

戻り値

-

checkInstalled() 関数は {{ domxref("DOMRequest") }} オブジェクトを返します。DOMRequest.result プロパティには App オブジェクト が含まれており、これはインストールされているアプリの情報を提供する JavaScript オブジェクトです。アプリがインストールされていない場合、DOMRequest.result は null となります。

-

例

-
var request = window.navigator.mozApps.checkInstalled("http://example.com/manifest.webapp");
-request.onerror = function(e) {
-  alert("checkInstalled 呼び出しエラー: " + request.error.name);
-};
-request.onsuccess = function(e) {
-  if (request.result) {
-    console.log("アプリはインストールされています");
-  }
-  else {
-    console.log("アプリはインストールされていません");
-  }
-};
-

呼び出し元スクリプトは、この例のように、戻り値オブジェクトの onsuccess/onerror コールバックプロパティを設定することが期待されます。呼び出しが成功した場合、戻り値オブジェクトの result プロパティには App オブジェクト が含まれています。この例では request.result に当たります。

-

エラー

-

DOMRequest.error において文字列の ERROR が返ります。

-

マニフェストが情報を要求したページとは異なるドメインにある場合、checkInstalled が呼び出された直後に例外 NS_ERROR_DOM_BAD_URI が投げられます。

- - diff --git a/files/ja/web/api/domapplicationsregistry/getinstalled/index.html b/files/ja/web/api/domapplicationsregistry/getinstalled/index.html deleted file mode 100644 index 1bfc36d895..0000000000 --- a/files/ja/web/api/domapplicationsregistry/getinstalled/index.html +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: Apps.getInstalled -slug: Web/API/DOMApplicationsRegistry/getInstalled -tags: - - API - - Apps - - Apps API - - Firefox OS - - Method -translation_of: Archive/Marketplace/API/DOMApplicationsRegistry/getInstalled ---- -

{{ ApiRef() }}

-

{{ non-standard_header() }}

-

概要

-

この生成元からインストールされたアプリの一覧を取得します。例えば、これを Mozilla Marketplace を呼び出した場合、Mozilla Marketplace によってインストールされたアプリの一覧を取得できます。

-
-

注: ひとつの生成元 (オリジン) に複数のアプリをホストすることはできません。ひとつのドメインで複数のアプリを登録したい場合は、例えば myapp.mydomain.com、otherapp.mydomain.com のように、アプリごとにサブドメインを用意してください。

-
-

構文

-
var request = window.navigator.mozApps.getInstalled();
-
-

引数

-

ありません。

-

例

-
var request = window.navigator.mozApps.getInstalled();
-request.onerror = function(e) {
-  alert("getInstalled の呼び出し時にエラーが発生しました: " + request.error.name);
-};
-request.onsuccess = function(e) {
-  alert("成功しました。アプリの数は " + request.result.length);
-  var appsRecord = request.result;
-};
-

呼び出し元スクリプトは、この例のように、戻り値オブジェクトの onsuccess/onerror コールバックプロパティを設定することが期待されます。呼び出しが成功した場合、戻り値オブジェクトの result プロパティに App オブジェクト の配列が含まれています。この例では request.result に当たります。

-

エラー

-

DOMRequest.error において文字列の ERROR が返ります。

- - diff --git a/files/ja/web/api/domapplicationsregistry/getself/index.html b/files/ja/web/api/domapplicationsregistry/getself/index.html deleted file mode 100644 index 5fdd46a1ce..0000000000 --- a/files/ja/web/api/domapplicationsregistry/getself/index.html +++ /dev/null @@ -1,47 +0,0 @@ ---- -title: Apps.getSelf -slug: Web/API/DOMApplicationsRegistry/getSelf -tags: - - API - - Apps - - Apps API - - Firefox OS - - Method -translation_of: Archive/Marketplace/API/DOMApplicationsRegistry/getSelf ---- -

{{ ApiRef() }}

-

{{ non-standard_header() }}

-

概要

-

現在のアプリに関する情報を返します。つまり、呼び出し元アプリとドメインが一致するインストール済みアプリの情報です。これを使ってアプリがインストールされているかどうかを判別できます。

-
-

注: ひとつの生成元 (オリジン) に複数のアプリをホストすることはできません。ひとつのドメインで複数のアプリを登録したい場合は、例えば myapp.mydomain.com、otherapp.mydomain.com のように、アプリごとにサブドメインを用意してください。

-
-

構文

-
var request = window.navigator.mozApps.getSelf();
-
-

引数

-

ありません。

-

戻り値

-

getSelf() は DOMRequest オブジェクトを返します。success イベントが DOMRequest に対して通知されると、DOMRequest.result フィールドには、現在のアプリを表す App オブジェクト、あるいは getSelf() がアプリ外部から呼び出された (つまりアプリがインストールされていない) 場合は null が含まれます。操作が完了するまでは、DOMRequest.result は null です。

-

呼び出しが成功しなかった場合、error イベントが DOMRequest に対して通知され、DOMRequest.error には DOMError オブジェクトが含まれ、これにはエラーに関する情報が含まれます。

-

例

-

DOMRequest.onsuccess と DOMRequest.onerror コールバックプロパティとともに getSelf() を使う方法を示した例です。

-
var request = window.navigator.mozApps.getSelf();
-request.onsuccess = function() {
-  if (request.result) {
-    // App オブジェクトからアプリの名称を取得
-    alert("現在のアプリの名称: " + request.result.manifest.name);
-  } else {
-    alert("アプリ外部から呼び出されました");
-  }
-};
-request.onerror = function() {
-  // DOMError オブジェクトからエラー名を表示
-  alert("エラー: " + request.error.name);
-};
-

呼び出しが成功した場合、戻り値オブジェクトの result プロパティに App オブジェクトが含まれています。この例では request.result に当たります。request.result が null の場合、アプリがインストールされていないことが分かります。

-

アプリがそのプロトコルを HTTP から HTTPS へ変えている場合は、navigator.mozApps.checkInstalled() を使ってインストールされているか判別した方が良いでしょう。

- - diff --git a/files/ja/web/api/domapplicationsregistry/index.html b/files/ja/web/api/domapplicationsregistry/index.html deleted file mode 100644 index 72bff00c25..0000000000 --- a/files/ja/web/api/domapplicationsregistry/index.html +++ /dev/null @@ -1,45 +0,0 @@ ---- -title: Apps -slug: Web/API/DOMApplicationsRegistry -tags: - - API - - Apps - - Apps API - - Non-standard -translation_of: Archive/Marketplace/API/DOMApplicationsRegistry ---- -
{{ ApiRef("Apps") }}
- -
-

マーケットプレイス機能の削除
- このページで説明されている機能は動作しなくなりました— Firefox Marketplaceは、Android、デスクトップ、タブレット、および支払い（その他の関連機能）のサポートを終了しました。詳細については、 Future of Marketplace FAQ をご覧ください。

-
- -

ブラウザ内で Open Web apps をインストール、管理する機能を提供します。現時点では {{domxref('window.navigator.mozApps')}} として実装されています。

- -

プロパティ

- -
-
{{domxref("DOMApplicationsRegistry.mgmt")}}
-
ダッシュボードがユーザに代わってアプリを管理、起動できるようにする関数を含む mgmt オブジェクト。
-
- -

メソッド

- -
-
{{ domxref("DOMApplicationsRegistry.checkInstalled()") }}
-
アプリが既にインストールされているかどうかを確認します。マニフェストを引数に取ります。
-
{{ domxref("DOMApplicationsRegistry.install()") }}
-
アプリのインストールを実行します。インストールの過程で、アプリは検証され、ユーザはインストールを許可するかどうか訪ねられます。
-
{{ domxref("DOMApplicationsRegistry.getSelf()") }}
-
該当するアプリの {{domxref('app')}} オブジェクトを含むオブジェクトを返します。
-
{{ domxref("DOMApplicationsRegistry.getInstalled()") }}
-
インストールされているアプリの一覧を取得します。
-
-

Obsolete methods

-
-
DOMApplicationsRegistry.amInstalled() {{Obsolete_Inline}}
-
アプリがインストールされているかどうかを確認する手段を提供します。
-
DOMApplicationsRegistry.getInstalledBy() {{Obsolete_Inline}}
-
呼び出し元のドメインによってインストールされたアプリを返します。 これにより、アプリのディレクトリまたはストアは、現在のユーザーに代わってインストールしたアプリを判別できます。
-
diff --git a/files/ja/web/api/domapplicationsregistry/install/index.html b/files/ja/web/api/domapplicationsregistry/install/index.html deleted file mode 100644 index af89013ff4..0000000000 --- a/files/ja/web/api/domapplicationsregistry/install/index.html +++ /dev/null @@ -1,96 +0,0 @@ ---- -title: Apps.install -slug: Web/API/DOMApplicationsRegistry/install -tags: - - API - - Apps - - Apps API - - Firefox OS - - Method -translation_of: Archive/Marketplace/API/DOMApplicationsRegistry/install ---- -
- {{ApiRef}} {{non-standard_header}}
-

概要

-

アプリのインストールを実行します。インストールの過程で、アプリは検証され、ユーザはインストールを許可するかどうか訪ねられます。

-

アプリが既に同じドメインからインストールされていた場合、install() を再度呼び出すことで既存のインストールデータが確認なく上書きされます。これは、例えばユーザが無料版からプレミアム版にアップグレードした場合など、購入レシートの変更に使用される場合があります。

-

構文

-
var request = window.navigator.mozApps.install(url, [receipt1, …]);
-

引数

-
- 注: 現在 (2012 年 5 月時点)、url 引数に相対パスを使った場合に生じるバグがあります。{{ Bug("745928") }} を参照してください。
-
-
- url
-
- インストールされる マニフェスト の場所を含んだ string 型の URL。独自配布の場合 (インストール元がアプリの生成元と同じ場合)、インストール元のサイトは URL の生成元部分を省略し、(/ で始まる) 絶対パスを使うことも可能です。
-
- receipts
-
- (オプション) 1 つあるいは複数のレシートの配列を含む配列。例:
-
- 
window.navigator.mozApps.install(url, ["receipt"])
-
-
- receipts が省略された場合、これは null として扱われます。詳しくは レシートの検証 を参照してください。
-
-

要求された引数 (url) が欠落していた場合、あるいは非対応の引数が与えられた場合、install() 関数は例外を投げます。

-

戻り値

-

install() 関数は {{ domxref("DOMRequest") }} オブジェクトを返します。DOMRequest.result フィールドには App オブジェクト が含まれ、これはインストールされたばかりのアプリを説明する JavaScript オブジェクトです。操作が完了するまでは、DOMRequest.result は null です。

-

インストールが成功しなかった場合、DOMRequest.error には DOMError オブジェクト が含まれ、これにはエラーに関する情報が含まれます。

-

例

-

DOMRequest.onsuccess と DOMRequest.onerror コールバックプロパティとともに install() を使う方法を示した例です。

-
var request = window.navigator.mozApps.install(manifestUrl);
-request.onsuccess = function () {
-  // 戻り値の App オブジェクトを保存
-  var appRecord = this.result;
-  alert('インストール成功！');
-};
-request.onerror = function () {
-  // DOMError オブジェクトからエラー情報を表示
-  alert('インストール失敗、エラー: ' + this.error.name);
-};
-
-

インストールが成功した場合、onsuccess コールバックが呼び出されます。これは、ここ に書かれているインストールアクションが発生したことを意味します。

-

インストールが成功しなかった場合、onerror コールバックが呼び出されます。失敗したインストールでは、DOMRequest.error にエラーに関する情報を含む DOMError オブジェクトが含まれます。

-

上のコードでは、既に呼び出された関数の後にリスナーが追加されているため、おかしな感じに見えるかもしれません。しかし、これが DOMRequest オブジェクトの操作方法なのです。関数の呼び出しはリスナーが定義されるまで待機し、リスナーは適切に呼び出されます。install() 関数は onsuccess や onerror リスナーが定義されていない場合でも動作します。

-

エラー

-

インストールが成功しなかった場合、以下のエラーのいずれかが DOMRequest.error に含まれて返ります。

-
-
- DENIED
-
- ユーザがインストールをキャンセルした。
-
- INVALID_MANIFEST
-
- マニフェストが、正しい JSON 形式ではあるものの、必要な項目を含んでいないか、何らかの不正な状態。
-
- MANIFEST_URL_ERROR
-
- HTTP 200 以外のステータスコードが返ってきた、あるいは何らかの接続エラー。
-
- MANIFEST_PARSE_ERROR
-
- マニフェストの JSON が不正な形式。
-
- NETWORK_ERROR
-
- 接続エラー。
-
- REINSTALL_FORBIDDEN
-
- アプリの再インストールが禁止されている。
-
- MULTIPLE_APPS_PER_ORIGIN_FORBIDDEN
-
- インストール可能なアプリには「オリジンごとにアプリひとつ」というセキュリティポリシーが適用され、基本的に 1 つのオリジンで 2 つ以上のアプリをホストできません。
-
- - diff --git a/files/ja/web/api/domapplicationsregistry/installpackage/index.html b/files/ja/web/api/domapplicationsregistry/installpackage/index.html deleted file mode 100644 index 12b2912820..0000000000 --- a/files/ja/web/api/domapplicationsregistry/installpackage/index.html +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: Apps.installPackage -slug: Web/API/DOMApplicationsRegistry/installPackage -tags: - - API - - Apps - - Firefox OS - - Method - - NeedsContent -translation_of: Archive/Marketplace/API/DOMApplicationsRegistry/installPackage ---- -

{{ ApiRef() }} {{non-standard_header}}

-

概要

-

パッケージ型アプリ をインストールします。

-

構文

-
installPackage: function(aURL[, aParams])
-

引数

-
-  
-
-
-
- aURL
-
- インストールしようとするアプリパッケージに関連付けられたミニマニフェストの URL。完全な絶対 URL でなければいけません。
-
- aParams
-
- (オプション) 以下の追加の情報を含むオブジェクト。
-
-
- -

戻り値

-
-
- DOMRequest
-
-

関連情報

- -- cgit v1.2.3-54-g00ecf