blob: b9cf1367d43397a38b9e17fd890628507dea04fe (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
|
---
title: window.navigator.requestWakeLock
slug: Archive/B2G_OS/API/Navigator/requestWakeLock
tags:
- B2G
- Firefox OS
- Non Standard
- Power Management
- WebAPI
translation_of: Archive/B2G_OS/API/Navigator/requestWakeLock
---
<p>{{ non-standard_header() }}</p>
<h2 id="Summary" name="Summary">Résumé</h2>
<p>Cette méthode est utilisée pour faire une requête de blocage de mise en veille de n'importe quelle ressource de l'appareil. Elle renvoie un objet {{ anch("MozWakeLock") }} utilisable pour garder une trace ou libérer le verrou de blocage.</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")}} qu'il est nécessaire d'utiliser pour libérer le verrou.</p>
<div class="note">
<p><strong>Note :</strong> quand la fenêtre qui a requis un ou plusieurs verrou est fermée ou supprimée, tout verrou impliqué est implicitement libéré. 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 doit être appelée pour libérer le verrou. Si plusieurs verrous ont été requis, chacun d'entre eux doit être libéré individuellement.</dd>
</dl>
<div class="note">
<p><strong>Note :</strong> appeler la méthode<code> unlock </code>sur un verrou déjà 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>Cette API 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>
|
