blob: 55405894aa94fe282a2296b38466a54666cd6f21 (
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
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
|
---
title: Notification.permission
slug: Web/API/notification/permission
tags:
- API
- API Notifications
- Notification
- Notifications
- Propriété
- Reference
translation_of: Web/API/Notification/permission
---
<p>{{APIRef("Web Notifications")}}{{AvailableInWorkers}}{{securecontext_header}}</p>
<p><span class="seoSummary">La propriété en lecture seule <strong><code>permission</code></strong> de l'interface {{domxref ("Notification")}} indique l'autorisation actuelle accordée par l'utilisateur à l'origine actuelle pour afficher des notifications.</span></p>
<h2 id="Syntax" name="Syntax">Syntaxe</h2>
<pre class="syntaxbox notranslate">Notification.permission</pre>
<h3 id="Return_Value" name="Return_Value">Valeur</h3>
<p>Une {{domxref("DOMString")}} représentant l'autorisation actuelle. La valeur peut être:</p>
<ul>
<li><code>granted</code>: L'utilisateur a explicitement accordé l'autorisation à l'origine actuelle d'afficher les notifications système.</li>
<li><code>denied</code>: L'utilisateur a explicitement refusé l'autorisation pour l'origine actuelle d'afficher les notifications système.</li>
<li><code>default</code>: La décision de l'utilisateur est inconnue; dans ce cas, l'application agira comme si l'autorisation était <code>denied</code>.</li>
</ul>
<h2 id="Exemples">Exemples</h2>
<p>L'extrait suivant peut être utilisé si vous souhaitez d'abord vérifier si les notifications sont prises en charge, puis vérifier si l'autorisation a été accordée pour l'origine actuelle pour envoyer des notifications, puis demander l'autorisation si nécessaire, avant d'envoyer une notification.</p>
<pre class="brush: js notranslate">function notifyMe() {
// Let's check if the browser supports notifications
if (!('Notification' in window)) {
console.log('This browser does not support desktop notification')
}
// Let's check whether notification permissions have alredy been granted
else if (Notification.permission === 'granted') {
// If it's okay let's create a notification
const notification = new Notification('Hi there!')
}
// Otherwise, we need to ask the user for permission
else if (
Notification.permission !== 'denied' ||
Notification.permission === 'default'
) {
Notification.requestPermission((permission) => {
// If the user accepts, let's create a notification
if (permission === 'granted') {
const notification = new Notification('Hi there!')
}
})
}
// At last, if the user has denied notifications, and you
// want to be respectful there is no need to bother them any more.
}
</pre>
<h2 id="Spécifications">Spécifications</h2>
<table class="standard-table">
<tbody>
<tr>
<th scope="col">Spécification</th>
<th scope="col">État</th>
<th scope="col">Commentaire</th>
</tr>
<tr>
<td>{{SpecName("Web Notifications","#dom-notification-permission","permission")}}</td>
<td>{{Spec2('Web Notifications')}}</td>
<td>Living standard</td>
</tr>
</tbody>
</table>
<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>
<p>{{Compat("api.Notification.permission")}}</p>
<h2 id="Voir_également">Voir également</h2>
<ul>
<li><a href="/docs/Web/API/Notifications_API">API de notifications</a></li>
<li><a href="/en-US/docs/Web/API/Notifications_API/Using_the_Notifications_API">Utilisation de l'API Notifications</a></li>
<li><a href="/en-US/docs/Web/API/Permissions_API">Permissions d'API</a></li>
<li><a href="/en-US/docs/Web/API/Permissions_API/Using_the_Permissions_API">Utilisation des permissions d'API</a></li>
</ul>
|