DOMRequest

  • Raccourci de la révision : DOM/DOMRequest
  • Titre de la révision : DOMRequest
  • ID de la révision : 361521
  • Créé :
  • Créateur : tregagnon
  • Version actuelle ? Oui
  • Commentaire

Contenu de la révision

{{ domref() }}

{{ non-standard_header() }}

Un objet DOMRequest représente une opération en cours. Il fournit des callbacks qui sont appelés quand l'operation est finit, ainsi qu'une reférence au résultat de l'opération. Une méthode DOM qui initie une opération se poursuivant au cours du temps, retounera un objet DOMRequest que vous pouvez surveiller pour connaitre le déroulement de l'opération

Attributs

{{ domxref("DOMRequest.onsuccess") }}
Pour définir un callback à appeler quand l'opération représentée par DOMRequest est terminée
{{ domxref("DOMRequest.onerror") }}
Pour définir un callback qui sera appelé si une erreur survient pendant le déroulement de l'opération.
{{ domxref("DOMRequest.readyState") }}
Une chaîne de caractère indiquant si l'opération tourne toujours. Sa valeur est soit "done" ou "pending".
{{ domxref("DOMRequest.result") }}
Le résultat de l'opération.
{{ domxref("DOMRequest.error") }}
Information de l'erreur, si présent.

Exemple

Un exemple de l'utilisation des propriétés onsuccess, onerror, result et error de l'objet DOMRequest.

var pending = navigator.mozApps.install(manifestUrl);
pending.onsuccess = function () {
  // Enregistre l'objet App renvoyé
  var appRecord = this.result;
  alert('Installation réussie !');
};
pending.onerror = function () {
  // Affiche le nom de l'erreur
  alert('Installation échouée, erreur : ' + this.error.name);
};

Compatibilité des navigateurs

{{ CompatibilityTable() }}

Fonction Chrome Firefox (Gecko) Internet Explorer Opera Safari
Support de base {{ CompatUnknown() }} {{ CompatGeckoDesktop("13.0") }} {{ CompatUnknown() }} {{ CompatUnknown() }} {{ CompatUnknown() }}
Fonction Android Chrome pour Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Support de base {{ CompatUnknown() }} {{ CompatUnknown() }} {{ CompatGeckoMobile("13.0") }} {{ CompatUnknown() }} {{ CompatUnknown() }} {{ CompatUnknown() }}

Spécification

Ne fait actuellement partie d'aucune spécification

Source de la révision

<p>{{ domref() }}</p>
<p>{{ non-standard_header() }}</p>
<p>Un objet <code>DOMRequest</code> représente une opération en cours. Il fournit des callbacks qui sont appelés quand l'operation est finit, ainsi qu'une reférence au résultat de l'opération. Une méthode DOM qui initie une opération se poursuivant au cours du temps, retounera un objet <code>DOMRequest</code> que vous pouvez surveiller pour connaitre le déroulement de l'opération</p>
<h2 id="Attributs">Attributs</h2>
<dl>
  <dt>
    {{ domxref("DOMRequest.onsuccess") }}</dt>
  <dd>
    Pour définir un callback à appeler quand l'opération représentée par <code>DOMRequest</code> est terminée</dd>
  <dt>
    {{ domxref("DOMRequest.onerror") }}</dt>
  <dd>
    Pour définir un callback qui sera appelé si une erreur survient pendant le déroulement de l'opération.</dd>
  <dt>
    {{ domxref("DOMRequest.readyState") }}</dt>
  <dd>
    Une chaîne de caractère indiquant si l'opération tourne toujours. Sa valeur est soit "<code>done</code>" ou "<code>pending</code>".</dd>
  <dt>
    {{ domxref("DOMRequest.result") }}</dt>
  <dd>
    Le résultat de l'opération.</dd>
  <dt>
    {{ domxref("DOMRequest.error") }}</dt>
  <dd>
    Information de l'erreur, si présent.</dd>
</dl>
<h2 id="Exemple">Exemple</h2>
<p>Un exemple de l'utilisation des propriétés <code>onsuccess</code>, <code>onerror</code>, <code>result</code> et <code>error</code> de l'objet <code>DOMRequest</code>.</p>
<pre class="brush: js">
var pending = navigator.mozApps.install(manifestUrl);
pending.onsuccess = function () {
&nbsp; // Enregistre l'objet App renvoyé
&nbsp; var appRecord = this.result;
&nbsp;&nbsp;alert('Installation réussie !');
};
pending.onerror = function () {
  // Affiche le nom de l'erreur
&nbsp; alert('Installation échouée, erreur : ' + this.error.name);
};
</pre>
<h2 id="Compatibilit.C3.A9_des_navigateurs">Compatibilité des navigateurs</h2>
<p>{{ CompatibilityTable() }}</p>
<div id="compat-desktop">
  <table class="compat-table">
    <tbody>
      <tr>
        <th>Fonction</th>
        <th>Chrome</th>
        <th>Firefox (Gecko)</th>
        <th>Internet Explorer</th>
        <th>Opera</th>
        <th>Safari</th>
      </tr>
      <tr>
        <td>Support de base</td>
        <td>{{ CompatUnknown() }}</td>
        <td>{{ CompatGeckoDesktop("13.0") }}</td>
        <td>{{ CompatUnknown() }}</td>
        <td>{{ CompatUnknown() }}</td>
        <td>{{ CompatUnknown() }}</td>
      </tr>
    </tbody>
  </table>
</div>
<div id="compat-mobile">
  <table class="compat-table">
    <tbody>
      <tr>
        <th>Fonction</th>
        <th>Android</th>
        <th>Chrome pour Android</th>
        <th>Firefox Mobile (Gecko)</th>
        <th>IE Mobile</th>
        <th>Opera Mobile</th>
        <th>Safari Mobile</th>
      </tr>
      <tr>
        <td>Support de base</td>
        <td>{{ CompatUnknown() }}</td>
        <td>{{ CompatUnknown() }}</td>
        <td>{{ CompatGeckoMobile("13.0") }}</td>
        <td>{{ CompatUnknown() }}</td>
        <td>{{ CompatUnknown() }}</td>
        <td>{{ CompatUnknown() }}</td>
      </tr>
    </tbody>
  </table>
</div>
<h2 id="Sp.C3.A9cification">Spécification</h2>
<p>Ne fait actuellement partie d'aucune spécification</p>
Revenir à cette révision