From 05e0e6d50d996472ed622726651fbd88250e97cb Mon Sep 17 00:00:00 2001 From: Anderson Vallejo <48649209+Vallejoanderson@users.noreply.github.com> Date: Fri, 11 Feb 2022 11:49:26 -0500 Subject: Content sync and updated to md | Notification.requestpermission [ES] (#4056) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * sync and updated to md * fix typo * Update files/es/web/api/notification/requestpermission/index.md Co-authored-by: Carolyn Wu <87150472+cw118@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: Juan Vásquez * Update index.md * Update index.md * Apply suggestions from code review Co-authored-by: Alexander Co-authored-by: Carolyn Wu <87150472+cw118@users.noreply.github.com> Co-authored-by: Juan Vásquez Co-authored-by: Alexander --- .../api/notification/requestpermission/index.html | 143 --------------------- .../api/notification/requestpermission/index.md | 100 ++++++++++++++ 2 files changed, 100 insertions(+), 143 deletions(-) delete mode 100644 files/es/web/api/notification/requestpermission/index.html create mode 100644 files/es/web/api/notification/requestpermission/index.md diff --git a/files/es/web/api/notification/requestpermission/index.html b/files/es/web/api/notification/requestpermission/index.html deleted file mode 100644 index 6c4b8080b3..0000000000 --- a/files/es/web/api/notification/requestpermission/index.html +++ /dev/null @@ -1,143 +0,0 @@ ---- -title: Notification.requestPermission() -slug: Web/API/notification/requestPermission -translation_of: Web/API/Notification/requestPermission ---- -

{{APIRef("Web Notifications")}}

- -

El método requestPermission() de la interfaz {{domxref("Notification")}} realiza una petición de permiso al usuario para que en ese dominio web se puedan mostrar notificaciones. 

- -

Sintaxis

- -

La ultima especificación ha actualizado este método a una sintaxis basada en Promise:

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

Anteriormente, la sintaxis se basaba en una simple retrollamada (callback); esta especificación ahora está obsoleta.

- -
Notification.requestPermission(callback);
- -

Parámetros

- -
-
callback {{optional_inline}} {{deprecated_inline("gecko46")}}
-
Una retrollamada (callback) opcional que es ejecutado con el valor del permiso elegido por el usuario. Obsoleto y reemplazado por el valor de retorno de Promise.
-
- -

Retorno

- -

Devuleve un Promise que se transforma a DOMString con el permiso escogido por el usuario. Los valores posibles para este son granted, denied, ó default.

- -

Ejemplo

- -

El siguiente fragmento realiza la petición de permiso al usuario, después registra un resultado diferente dependiendo de la elección del usuario.

- -
Notification.requestPermission(function(result) {
-  if (result === 'denied') {
-    console.log('Permission wasn\'t granted. Allow a retry.');
-    return;
-  } else if (result === 'default') {
-    console.log('The permission request was dismissed.');
-    return;
-  }
-  // Hacer algo con el permiso concedido.
-});
- -

Especificaciones

- - - - - - - - - - - - - - -
EspecificaciónEstadoComentario
{{SpecName('Web Notifications')}}{{Spec2('Web Notifications')}}Living standard
- -

Compatibilidad con los buscadores

- -

{{ CompatibilityTable() }}

- -
- - - - - - - - - - - - - - - - - - - -
CaracterísticaChromeFirefox (Gecko)Internet ExplorerOperaSafari
Soporte básico5 {{ property_prefix("webkit") }} (ver notas)
- 22		4.0 {{ property_prefix("moz") }} (ver notas)
- 22		{{ CompatNo() }}256 (ver notas)
-
- -
- - - - - - - - - - - - - - - - - - - - - - - - - -
CaracterísticaAndroidAndroid WebviewFirefox Mobile (Gecko)Firefox OSIE MobileOpera MobileSafari MobileChrome for Android
Soporte básico{{ CompatUnknown() }} -

{{CompatVersionUnknown}}

- 		4.0 {{ property_prefix("moz") }} (ver notas)
- 22		1.0.1 {{ property_prefix("moz") }} (ver notas)
- 1.2		{{ CompatNo() }}{{ CompatUnknown() }}{{ CompatNo() }} -

{{CompatVersionUnknown}}

-
-
- -

Notas de Firefox OS

- -

{{Page("/en-US/docs/Web/API/Notifications_API", "Firefox OS notes")}}

- -

Notas de Chrome

- -

{{Page("/en-US/docs/Web/API/Notifications_API", "Chrome notes")}}

- -

Notas de Safari

- -

{{Page("/en-US/docs/Web/API/Notifications_API", "Safari notes")}}

- -

Ver también

- - diff --git a/files/es/web/api/notification/requestpermission/index.md b/files/es/web/api/notification/requestpermission/index.md new file mode 100644 index 0000000000..33954b8843 --- /dev/null +++ b/files/es/web/api/notification/requestpermission/index.md @@ -0,0 +1,100 @@ +--- +title: Notification.requestPermission() +slug: Web/API/Notification/requestPermission +tags: + - API + - Method + - Notification + - Notifications + - Notifications API + - Reference +translation_of: Web/API/Notification/requestPermission +browser-compat: api.Notification.requestPermission +--- +{{APIRef("Web Notifications")}}{{securecontext_header}} + +> **Nota:** Safari aún usa la sintaxis callback para obtener el permiso. Lee [Usando la API de Notificaciones](/es/docs/Web/API/Notifications_API/Using_the_Notifications_API) para un buen ejemplo de como detectar esto y ejecutar el código de forma apropiada. + +El método **`requestPermission`** de la interfaz {{domxref("Notification")}} solicita un permiso del usuario al origen actual para mostrar notificaciones. + +## Sintaxis + +La ultima especificación ha actualizado este método a una sintaxis de tipo promesa que funciona así: + +```js +Notification.requestPermission().then(function(permission) { /* ... */ }); +``` + +Anteriormente, la sintaxis se basaba en un simple callback; esta versión ahora está obsoleta: + +```js +Notification.requestPermission(callback); +``` + +### Parámetros + +- `callback` {{optional_inline}} {{deprecated_inline}} + - : Una callback opcional que es ejecutado con el valor del permiso. Obsoleto y reemplazado por el valor de retorno de la promesa. + +### Valor de retorno + +Una {{jsxref("Promise")}} que se convierte en una {{domxref("DOMString")}} con el permiso elegido por el usuario. Los valores posibles para este son: + +- `granted` +- `denied` +- `default` + +## Ejemplos + +Asume este HTML básico: + +```html + +``` + +Es posible enviar una notificación de la siguiente forma: aquí presentamos un conjunto de código bastante detallado y completo que podrías usar si quisieras primero comprobar si las notificaciones son soportadas, luego comprobar si el permiso ha sido concedido para el origen actual para enviar notificaciones y luego solicitar permiso de ser requerido, antes de enviar una notificación. + +```js +function notifyMe() { + // Comprobamos si el navegador soporta las notificaciones + if (!("Notification" in window)) { + alert("Este navegador no es compatible con las notificaciones de escritorio"); + } + + // Comprobamos si los permisos han sido concedidos anteriormente + else if (Notification.permission === "granted") { + // Si es correcto, lanzamos una notificación + var notification = new Notification("¡Hola!"); + } + + // Si no, pedimos permiso para la notificación + else if (Notification.permission !== "denied") { + Notification.requestPermission().then(function (permission) { + // Si el usuario nos lo concede, creamos la notificación + if (permission === "granted") { + var notification = new Notification("¡Hola!"); + } + }); + } + + // Por último, si el usuario ha denegado el permiso, + // y quiere ser respetuoso, no hay necesidad de molestarlo. +} +``` + +Ya no mostramos ejemplos corriendo en tiempo real en esta página, ya que Chrome y Firefox ya no conceden permisos de notificación para ser solicitados desde el origen {{htmlelement("iframe")}}, para seguir con otros navegadores. Para ver un ejemplo en acción, revisa nuestro [Ejemplo de lista de Todos](https://github.com/mdn/to-do-notifications/tree/gh-pages) (véase también [la app corriendo en vivo](https://mdn.github.io/to-do-notifications/).) + +> **Nota:** En el ejemplo de arriba generamos notificaciones en respuesta a una acción del usuario (hacer click en un botón). Esta no es la única mejor práctica — no deberias molestar a los usuarios con notificaciones que ellos no aceptaron — pero pronto los navegadores explicitamente deshabilitaran las notificaciones que no son ejecutadas en respuesta a una acción del usuario. Firefox ya está haciendo esto desde la versión 72, por ejemplo. + +## Especificaciones + +{{Specifications}} + +## Compatibilidad con navegadores + +{{Compat}} + +## Véase también + +- [Usando la API de Notificaciones](/es/docs/Web/API/Notifications_API/Using_the_Notifications_API) + -- cgit v1.2.3-54-g00ecf