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 : 434375
  • Créé :
  • Créateur : darnuria
  • Version actuelle ? Non
  • Commentaire

Contenu de la révision

{{ non-standard_header() }}

Sommaire

Cette méthode est utilisée pour faire une requete 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 chaine de charactère représantant le nom de la ressource à verrouiller,  Gaia utilise trois noms de ressources basics : "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 vérrou.

Note: Quand la fenetre qui à requis un ou plusieurs WakeLocks est close ou détruite tout WakeLock impliquée est implicitement libérée. Une libération manuelle n'est pas néccessaire.

MozWakeLock

interface MozWakeLock
{
  readonly attribute DOMString topic

  void unlock();
}
topic
La chaine de charactère contenant le nom de la ressource à vérrouiller.
unlock
Une fonction qui dois être appellée pour libérer le verrou. Si plusieurs verroux ont été requis, chacun d'entre eux doient être libérés individuellements.
A function which have to be called to release the lock. If several locks have been asked, each of them must be released individualy.

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

Example

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

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

Specification

Not part of any specification

See also

  • {{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 requete 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 chaine de charactère représantant le nom de la ressource à verrouiller,&nbsp; <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 basics : <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 vérrou.</p>
<div class="note">
  <p><strong>Note:</strong> Quand la fenetre qui à requis un ou plusieurs WakeLocks est close ou détruite tout WakeLock impliquée est implicitement libérée. Une libération manuelle n'est pas néccessaire.</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 chaine de charactère contenant le nom de la ressource à vérrouiller.</dd>
  <dt>
    <code>unlock</code></dt>
  <dd>
    Une fonction qui dois être appellée pour libérer le verrou. Si plusieurs verroux ont été requis, chacun d'entre eux doient être libérés individuellements.</dd>
  <dd>
    A function which have to be called to release the lock. If several locks have been asked, each of them must be released individualy.</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">Example</h2>
<pre class="brush: js">
var lock = window.navigator.requestWakeLock('screen');

window.addEventListener('unload', function () {
    lock.unlock();
});</pre>
<h2 id="Specification" name="Specification">Specification</h2>
<p>Not part of any specification</p>
<h2 id="See_also">See also</h2>
<ul>
  <li>{{domxref("window.navigator.mozPower","navigator.mozPower")}}</li>
</ul>
Revenir à cette révision