aboutsummaryrefslogtreecommitdiff
path: root/files/fr/archive/marketplace/api/domapplicationsregistry/install
diff options
context:
space:
mode:
Diffstat (limited to 'files/fr/archive/marketplace/api/domapplicationsregistry/install')
-rw-r--r--files/fr/archive/marketplace/api/domapplicationsregistry/install/index.html86
1 files changed, 0 insertions, 86 deletions
diff --git a/files/fr/archive/marketplace/api/domapplicationsregistry/install/index.html b/files/fr/archive/marketplace/api/domapplicationsregistry/install/index.html
deleted file mode 100644
index ba677690fa..0000000000
--- a/files/fr/archive/marketplace/api/domapplicationsregistry/install/index.html
+++ /dev/null
@@ -1,86 +0,0 @@
----
-title: Apps.install
-slug: Archive/Marketplace/API/DOMApplicationsRegistry/install
-tags:
- - API Apps
- - Apps
-translation_of: Archive/Marketplace/API/DOMApplicationsRegistry/install
----
-<div>
- {{ApiRef}} {{non-standard_header}}</div>
-<h2 id="Summary" name="Summary">Résumé</h2>
-<p>Déclenche l'installation d'une application. Pendant le processus d'installation, l'application est validée et l'utilisateur doit approuver l'installation.</p>
-<p>Si une application a déjà été installé depuis le même domaine, appeler <code>install()</code> à nouveau peux écraser silencieusement, les données déjà installées. Ceci peut être utilisé pour modifier le reçu d'achat, par exemple, quand un utilisateur passe d'une application gratuite à une application premium.</p>
-<h2 id="Syntax" name="Syntax">Syntaxe</h2>
-<pre class="syntaxbox"><code>var <em>request</em> = window.navigator.mozApps.install(<em>url</em>, <em>[receipts]</em>)</code>;</pre>
-<h3 id="Parameters" name="Parameters">Paramètres</h3>
-<div class="note">
- <strong>Note :</strong> Il y a actuellement (Février 2013) un bug lorsque l'on passe un chemin relatif dans le paramètre <code>url</code>. Voir {{ Bug("745928") }}.</div>
-<dl>
- <dt>
- <code>url</code></dt>
- <dd>
- Une chaîne de caractères d'URL contenant l'adresse du <a href="/fr/docs/Applications/Manifeste" title="/fr/docs/Applications/Manifeste">manifeste</a> à installer. Dans le cas d'une distribution personnel (quand l'origine d'installation est la même que celle de l'application), le site peut omettre l'origine dans l'URL et fournir un chemin absolu (commençant par <code>/</code>).</dd>
- <dt>
- <code><strong>receipts</strong></code></dt>
- <dd>
- (facultatif) un objet <a href="/en-US/docs/JSON" title="/en-US/docs/JSON">JSON</a> contenant un tableau d'un ou plusieurs reçus.</dd>
- <dd>
- <pre>window.navigator.mozApps.install(url, {receipts: ["receipt1", ...]})</pre>
- </dd>
- <dd>
- Si <code>receipts</code> n'est pas renseigné, il est traité comme <code>null</code>.</dd>
-</dl>
-<p>La fonction <code>install()</code> lève une exception si l'argument requis  (<code>url</code>) est absent, ou si des arguments non supportés sont présent.</p>
-<h2 id="Returns" name="Returns">Renvoie</h2>
-<div class="note">
- <strong>Note :</strong> Il y a actuellement (Février 2013) un bug avec l'attribut <code>DOMRequest.result</code> affectant les appareils Android et les ordinateurs. Voir {{ Bug("806597") }}.</div>
-<p>La fonction <code>install()</code> renvoie un objet {{ domxref("DOMRequest") }}. Le champ <code>DOMRequest.result</code> contient un <a href="/fr/docs/DOM/App" title="/en-US/docs/DOM/App">objet <code>App</code></a>, qui est un objet JavaScript décrivant l'application venant d'être installée. Avant que l'opération soit finie, <code>DOMRequest.result</code> est <code>null</code>.</p>
-<p>Si l'installation est infructueuse, <code>DOMRequest.error</code> contient un <a href="/en-US/docs/JavaScript_API/Error_object" title="/en-US/docs/JavaScript_API/Error_object">objet <code>DOMError</code></a>, qui a les informations à propos de l'erreur.</p>
-<h2 id="Example" name="Example">Exemple</h2>
-<p>Un exemple montrant comment utiliser <code>install()</code> avec les propriétés de callback <code>DOMRequest.onsuccess</code> et <code>DOMRequest.onerror</code>.</p>
-<pre class="brush: js">var request = window.navigator.mozApps.install(manifestUrl);
-request.onsuccess = function () {
- // Enregistre l'objet App qui est renvoyé
- var appRecord = this.result;
- alert('Installation réussie !');
-};
-request.onerror = function () {
- // Affiche le nom de l'erreur depuis l'objet DOMError
- alert('Installation échouée, erreur : ' + this.error.name);
-};
-</pre>
-<p>Le callback <code>onsuccess</code> est appelé si l'installation est réussie. Ceci veut dire que les <a href="/fr/docs/Applications/Détails_spécifiques_à_la_plateforme" title="/fr/docs/Applications/Détails_spécifiques_à_la_plateforme">actions de l'installation</a> ont eu lieu.</p>
-<p>Si l'installation est un échec, le callback <code>onerror</code> est appelé. Sur une installation échouée, <code>DOMRequest.error </code>contient un objet <code>DOMError </code>qui a des informations sur l'erreur.</p>
-<p>Le code peut vous apparaître étrange, avec les guetteurs d'évènement ajoutés après que la fonction ait été appelée. Cependant, c'est la façon dont l'objet <code>DOMRequest</code> opère. L'appel de la fonction attendra que les guetteurs d'évènement aient été définis, et ils seront déclenchés en fonction de la situation. La fonction <code>install()</code> marche aussi par elle-même sans les guetteurs d'évènement<code>.onsuccess</code> et <code>.onerror</code>.</p>
-<h2 id="Error" name="Error">Erreurs</h2>
-<p>Quand l'installation est un échec, l'une de ces erreurs peut être retournée dans <code>DOMRequest.error</code>.</p>
-<dl>
- <dt>
- <code>DENIED</code></dt>
- <dd>
- L'utilisateur a annulé l'installation.</dd>
- <dt>
- <code>INVALID_MANIFEST</code></dt>
- <dd>
- Le manifeste, bien qu'étant un JSON correctement formé, n'a pas certains champs requis, ou est pour une raison quelconque non valide.</dd>
- <dt>
- <code>MANIFEST_URL_ERROR</code></dt>
- <dd>
- Un autre code HTTP que le code statut 200 a été reçu, ou une autre erreur de connection.</dd>
- <dt>
- <code>MANIFEST_PARSE_ERROR</code></dt>
- <dd>
- JSON mal formé pour le manifeste.</dd>
- <dt>
- <code>NETWORK_ERROR</code></dt>
- <dd>
- Erreur de connection.</dd>
-</dl>
-<h2 id="Related_topics" name="Related_topics">Sujets en relation</h2>
-<ul>
- <li><a href="/fr/docs/Applications/Détails_spécifiques_à_la_plateforme">Détails spécifiques à la plateforme lors de l'installation d'une Application</a></li>
- <li><a href="/fr/docs/DOM/App">L'objet <code>App</code></a></li>
- <li><a href="/fr/docs/DOM/DOMError">L'objet <code>DOMError</code></a></li>
- <li><a href="/fr/docs/Applications/API_JavaScript_Apps">API JavaScript Apps</a></li>
-</ul>