window.navigator.requestWakeLock

  • Raccourci de la révision : Web/API/window.navigator.requestWakeLock
  • Titre de la révision : window.navigator.requestWakeLock
  • ID de la révision : 434415
  • Créé :
  • Créateur : Goofy
  • Version actuelle ? Non
  • Commentaire

Contenu de la révision

{{ non-standard_header() }}

Sommaire

Cette méthode est utilisée pour faire une requête de WakeLock, sur toute ressource de l'appareil elle retourne un objet {{ anch("MozWakeLock") }} utilisable pour garder une trace ou libérer le WakeLock.

Syntaxe

var lock = window.navigator.requestWakeLock(resourceName);
resourceName
Une chaîne de caractères représentant le nom de la ressource à verrouiller. Gaia utilise trois noms de ressources basiques : "screen, cpu et wifi" cependant toute application certifiée peut exposer de nouvelles ressources.

Valeur

navigator.requestWakeLock retourne un objet {{anch("MozWakeLock")}} que vous devriez utiliser pour libérer le verrou.

Note: Quand la fenêtre qui a requis un ou plusieurs WakeLocks est fermée ou supprimée, tout WakeLock impliquée est implicitement libérée. Une libération manuelle n'est pas nécessaire.

MozWakeLock

interface MozWakeLock
{
  readonly attribute DOMString topic

  void unlock();
}
topic
La chaîne de caractères contenant le nom de la ressource à verrouiller.
unlock
Une fonction qui dois être appelée pour libérer le verrou. Si plusieurs verrous ont été requis, chacun d'entre eux doivent être libérés individuellement.

Note: Appeler la méthode unlock sur WakeLock déjà  libéré lancera une erreur de type : NS_ERROR_DOM_INVALID_STATE_ERR.

Exemple

var lock = window.navigator.requestWakeLock('screen');

window.addEventListener('unload', function () {
    lock.unlock();
});

Spécification

Ne fait partie d'aucune spécification.

Voir aussi

  • {{domxref("window.navigator.mozPower","navigator.mozPower")}}

Source de la révision

<p>{{ non-standard_header() }}</p>
<h2 id="Summary" name="Summary">Sommaire</h2>
<p>Cette méthode est utilisée pour faire une requête de WakeLock, sur toute ressource de l'appareil elle retourne un objet {{ anch("MozWakeLock") }} utilisable pour garder une trace ou libérer le WakeLock.</p>
<h2 id="Syntax" name="Syntax">Syntaxe</h2>
<pre class="eval">
var lock = window.navigator.requestWakeLock(resourceName);
</pre>
<dl>
  <dt>
    resourceName</dt>
  <dd>
    Une chaîne de caractères représentant le nom de la ressource à verrouiller. <a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Gaia" title="/en-US/docs/Mozilla/Firefox_OS/Platform/Gaia">Gaia</a> utilise trois noms de ressources basiques : <code>"screen</code>, <code>cpu</code> et <code>wifi"</code> cependant toute application certifiée peut exposer de nouvelles ressources.</dd>
</dl>
<h2 id="Value" name="Value">Valeur</h2>
<p><code>navigator.requestWakeLock</code> retourne un objet {{anch("MozWakeLock")}} que vous devriez utiliser pour libérer le verrou.</p>
<div class="note">
  <p><strong>Note:</strong> Quand la fenêtre qui a requis un ou plusieurs WakeLocks est fermée ou supprimée, tout WakeLock impliquée est implicitement libérée. Une libération manuelle n'est pas nécessaire.</p>
</div>
<h3 id="MozWakeLock">MozWakeLock</h3>
<pre>
interface MozWakeLock
{
  readonly attribute DOMString topic

  void unlock();
}</pre>
<dl>
  <dt>
    <code>topic</code></dt>
  <dd>
    La chaîne de caractères contenant le nom de la ressource à verrouiller.</dd>
  <dt>
    <code>unlock</code></dt>
  <dd>
    Une fonction qui dois être appelée pour libérer le verrou. Si plusieurs verrous ont été requis, chacun d'entre eux doivent être libérés individuellement.</dd>
</dl>
<div class="note">
  <p><strong>Note:</strong> Appeler la méthode<code> unlock sur</code> WakeLock déjà&nbsp; libéré lancera une erreur de type : <code>NS_ERROR_DOM_INVALID_STATE_ERR</code>.</p>
</div>
<h2 id="Specification" name="Specification">Exemple</h2>
<pre class="brush: js">
var lock = window.navigator.requestWakeLock('screen');

window.addEventListener('unload', function () {
    lock.unlock();
});</pre>
<h2 id="Specification" name="Specification">Spécification</h2>
<p>Ne fait partie d'aucune spécification.</p>
<h2 id="Voir_aussi">Voir aussi</h2>
<ul>
  <li>{{domxref("window.navigator.mozPower","navigator.mozPower")}}</li>
</ul>
Revenir à cette révision