Os nossos voluntários ainda não traduziram este artigo para Português (Europeu). Junte-se a nós e ajude-nos a fazer o trabalho!
Pode também ler o artigo em English (US).

The requestPermission() method of the Notification interface requests permission from the user for the current origin to display notifications.

Note: This feature is not available in SharedWorker

Syntax

The latest spec has updated this method to a promise-based syntax that works like this:

Notification.requestPermission().then(function(permission) { ... });

Previously, the syntax was based on a simple callback; this version is now deprecated:

Notification.requestPermission(callback);

Parameters

callback Optional Deprecated since Gecko 46
An optional callback function that is called with the permission value. Deprecated in favor of the promise return value.

Returns

A Promise that resolves to a DOMString with the permission picked by the user. Possible values for this string are granted, denied, or default.

Example

The following snippet requests permission from the user, then logs a different result to the console depending on the users' choice.

Notification.requestPermission().then(function(result) {
  if (result === 'denied') {
    console.log('Permission wasn\'t granted. Allow a retry.');
    return;
  }
  if (result === 'default') {
    console.log('The permission request was dismissed.');
    return;
  }
  // Do something with the granted permission.
});

Specifications

Specification Status Comment
Notifications API Living Standard Living standard

Browser compatibility

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support46 ?47 No40 ?
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Basic support No46 ? Yes40 No ?

See also

Etiquetas do documento e contribuidores

Última atualização por: fscholz,