diff options
Diffstat (limited to 'files/fr/web/api/notification/permission/index.html')
-rw-r--r-- | files/fr/web/api/notification/permission/index.html | 95 |
1 files changed, 95 insertions, 0 deletions
diff --git a/files/fr/web/api/notification/permission/index.html b/files/fr/web/api/notification/permission/index.html new file mode 100644 index 0000000000..dc74126304 --- /dev/null +++ b/files/fr/web/api/notification/permission/index.html @@ -0,0 +1,95 @@ +--- +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> + +<div class="hidden">Le tableau de compatibilité de cette page est généré à partir de données structurées. Si vous souhaitez contribuer aux données, veuillez consulter <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> et nous envoyer une pull request.</div> + +<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> |