From e5d12d8d1ce346105ec0cc64e1b8fc3dcda19bac Mon Sep 17 00:00:00 2001 From: Juan Vasquez Date: Tue, 18 Oct 2022 15:54:32 -0500 Subject: [PATCH] Change to md web/api/navigator - [x] donottrack/ - [x] geolocation/ - [x] getbattery/ - [x] getusermedia/ - [x] registerprotocolhandler/ - [x] vibrate/ - [x] index.md Related to https://github.com/mdn/translated-content/issues/8635 --- .../web/api/navigator/donottrack/index.html | 56 ------ .../es/web/api/navigator/donottrack/index.md | 43 +++++ .../web/api/navigator/geolocation/index.html | 57 ------ .../es/web/api/navigator/geolocation/index.md | 39 ++++ .../web/api/navigator/getusermedia/index.html | 136 -------------- .../web/api/navigator/getusermedia/index.md | 99 +++++++++++ files/es/web/api/navigator/index.html | 141 --------------- files/es/web/api/navigator/index.md | 166 ++++++++++++++++++ .../registerprotocolhandler/index.html | 32 ---- .../registerprotocolhandler/index.md | 45 +++++ .../web-based_protocol_handlers/index.html | 130 -------------- .../web-based_protocol_handlers/index.md | 130 ++++++++++++++ files/es/web/api/navigator/vibrate/index.html | 36 ---- files/es/web/api/navigator/vibrate/index.md | 41 +++++ 14 files changed, 563 insertions(+), 588 deletions(-) delete mode 100644 files/es/web/api/navigator/donottrack/index.html create mode 100644 files/es/web/api/navigator/donottrack/index.md delete mode 100644 files/es/web/api/navigator/geolocation/index.html create mode 100644 files/es/web/api/navigator/geolocation/index.md delete mode 100644 files/es/web/api/navigator/getusermedia/index.html create mode 100644 files/es/web/api/navigator/getusermedia/index.md delete mode 100644 files/es/web/api/navigator/index.html create mode 100644 files/es/web/api/navigator/index.md delete mode 100644 files/es/web/api/navigator/registerprotocolhandler/index.html create mode 100644 files/es/web/api/navigator/registerprotocolhandler/index.md delete mode 100644 files/es/web/api/navigator/registerprotocolhandler/web-based_protocol_handlers/index.html create mode 100644 files/es/web/api/navigator/registerprotocolhandler/web-based_protocol_handlers/index.md delete mode 100644 files/es/web/api/navigator/vibrate/index.html create mode 100644 files/es/web/api/navigator/vibrate/index.md diff --git a/files/es/web/api/navigator/donottrack/index.html b/files/es/web/api/navigator/donottrack/index.html deleted file mode 100644 index 80c8c12bef5c3a..00000000000000 --- a/files/es/web/api/navigator/donottrack/index.html +++ /dev/null @@ -1,56 +0,0 @@ ---- -title: Navigator.doNotTrack -slug: Web/API/Navigator/doNotTrack -tags: - - API - - DOM - - Experimental - - Propiedad - - Referencia -translation_of: Web/API/Navigator/doNotTrack ---- -
{{ApiRef("HTML DOM")}}{{SeeCompatTable}}
- -

Devuelve los ajustes de do-not-track del usuario. Esto es "1" si el usuario ha solicitado no ser rastreado por sitios web, contenidos, o anuncios.

- -

Sintaxis

- -
dnt = navigator.doNotTrack;
-
- -

El valor refleja el de la cabecera do-not-track, ej. valores de {"1", "0", "unspecified" }. Nota: Antes de Gecko 32, Gecko empleaba los valores { "yes", "no", "unspecified"} (bug 887703).

- -

Ejemplo

- -
console.log(navigator.doNotTrack);
-// imprime "1" si DNT está habilitado; "0" si el usuario ha aceptado el rastreo; en caso contrario es "unspecified"
-
- -

Especificaciones

- - - - - - - - - - - - - - - - -
EspecificaciónEstadoComentario
{{SpecName("Tracking", "#widl-Navigator-doNotTrack", "Navigator.doNotTrack")}}{{Spec2("Tracking")}}Definición inicial
- -

Compatibilidad con navegadores

- -{{Compat("api.Navigator.doNotTrack")}} - -

Vea también

- - diff --git a/files/es/web/api/navigator/donottrack/index.md b/files/es/web/api/navigator/donottrack/index.md new file mode 100644 index 00000000000000..27590c6176fe1c --- /dev/null +++ b/files/es/web/api/navigator/donottrack/index.md @@ -0,0 +1,43 @@ +--- +title: Navigator.doNotTrack +slug: Web/API/Navigator/doNotTrack +tags: + - API + - DOM + - Experimental + - Propiedad + - Referencia +translation_of: Web/API/Navigator/doNotTrack +--- +{{ApiRef("HTML DOM")}}{{SeeCompatTable}} + +Devuelve los ajustes de do-not-track del usuario. Esto es `"1"` si el usuario ha solicitado no ser rastreado por sitios web, contenidos, o anuncios. + +## Sintaxis + +``` +dnt = navigator.doNotTrack; +``` + +El valor refleja el de la cabecera do-not-track, ej. valores de {"1", "0", "unspecified" }. Nota: Antes de Gecko 32, Gecko empleaba los valores { "yes", "no", "unspecified"} ([bug 887703](https://bugzilla.mozilla.org/show_bug.cgi?id=887703)). + +## Ejemplo + +```js +console.log(navigator.doNotTrack); +// imprime "1" si DNT está habilitado; "0" si el usuario ha aceptado el rastreo; en caso contrario es "unspecified" +``` + +## Especificaciones + +| Especificación | Estado | Comentario | +| -------------------------------------------------------------------------------------------------------- | ---------------------------- | ------------------ | +| {{SpecName("Tracking", "#widl-Navigator-doNotTrack", "Navigator.doNotTrack")}} | {{Spec2("Tracking")}} | Definición inicial | + +## Compatibilidad con navegadores + +{{Compat("api.Navigator.doNotTrack")}} + +## Vea también + +- [Guía sobre el campo Do Not Track](/es/docs/Web/Security/Do_not_track_field_guide) diff --git a/files/es/web/api/navigator/geolocation/index.html b/files/es/web/api/navigator/geolocation/index.html deleted file mode 100644 index a3308ad6f137a4..00000000000000 --- a/files/es/web/api/navigator/geolocation/index.html +++ /dev/null @@ -1,57 +0,0 @@ ---- -title: window.navigator.geolocation -slug: Web/API/Navigator/geolocation -translation_of: Web/API/Navigator/geolocation -original_slug: Web/API/NavigatorGeolocation/geolocation ---- -

{{APIRef("Geolocation API")}}
- La propiedad de sólo lectura Navigator.geolocation devuelve un objeto Geolocation que proporciona acceso web a la ubicación de un dispositivo. Esto permite ofrecer al sitio web o aplicación resultados personalizados basados en la ubicación del usuario.

- -
-

Nota: Por motivos de seguridad, cuando una página web trata de acceder a la información de ubicación, se solicita permiso al usuario. Cada navegador tiene sus propias reglas sobre cómo y cuándo obtener dicho permiso.

-
- -

Sintaxis

- -
geo = navigator.geolocation
-
- -

Métodos

- -
-
{{domxref("geolocation.getCurrentPosition", "geolocation.getCurrentPosition()")}}
-
Utilizado para obtener la posición actual.
-
{{domxref("geolocation.watchPosition", "geolocation.watchPosition()")}}
-
Utilizado para asignar un manejador para dar seguimiento a cualquier cambio de ubicación.
-
{{domxref("geolocation.clearWatch", "geolocation.clearWatch()")}}
-
Utilizado para eliminar un manejador asignado a los cambios de ubicación.
-
- -

Especificaciones

- - - - - - - - - - - - - - - - -
EspecificaciónEstadoComentario
{{SpecName('Geolocation')}}{{Spec2('Geolocation')}}Especificación inicial
- -

Compatibilidad en navegadores

- -{{Compat("api.Navigator.geolocation")}} - -

Ver también

- - diff --git a/files/es/web/api/navigator/geolocation/index.md b/files/es/web/api/navigator/geolocation/index.md new file mode 100644 index 00000000000000..c6da44b1982859 --- /dev/null +++ b/files/es/web/api/navigator/geolocation/index.md @@ -0,0 +1,39 @@ +--- +title: window.navigator.geolocation +slug: Web/API/Navigator/geolocation +translation_of: Web/API/Navigator/geolocation +original_slug: Web/API/NavigatorGeolocation/geolocation +--- +{{APIRef("Geolocation API")}} +La propiedad de sólo lectura **`Navigator.geolocation`** devuelve un objeto [`Geolocation`](/es/docs/Web/API/Geolocation "La interfaz Geolocalización representa un objeto capaz de obtener mediante programación la posición del dispositivo. Se da acceso Web de la ubicación del dispositivo. Esto permite a un sitio Web o aplicación ofrecer resultados personalizados basados ​​en la ubicación del usuario.") que proporciona acceso web a la ubicación de un dispositivo. Esto permite ofrecer al sitio web o aplicación resultados personalizados basados en la ubicación del usuario. + +> **Nota:** Por motivos de seguridad, cuando una página web trata de acceder a la información de ubicación, se solicita permiso al usuario. Cada navegador tiene sus propias reglas sobre cómo y cuándo obtener dicho permiso. + +## Sintaxis + +``` +geo = navigator.geolocation +``` + +## Métodos + +- {{domxref("geolocation.getCurrentPosition", "geolocation.getCurrentPosition()")}} + - : Utilizado para obtener la posición actual. +- {{domxref("geolocation.watchPosition", "geolocation.watchPosition()")}} + - : Utilizado para asignar un manejador para dar seguimiento a cualquier cambio de ubicación. +- {{domxref("geolocation.clearWatch", "geolocation.clearWatch()")}} + - : Utilizado para eliminar un manejador asignado a los cambios de ubicación. + +## Especificaciones + +| Especificación | Estado | Comentario | +| ------------------------------------ | -------------------------------- | ---------------------- | +| {{SpecName('Geolocation')}} | {{Spec2('Geolocation')}} | Especificación inicial | + +## Compatibilidad en navegadores + +{{Compat("api.Navigator.geolocation")}} + +## Ver también + +- [Utilizando la geolocalización](/docs/WebAPI/Using_geolocation "/en-US/docs/WebAPI/Using_geolocation") diff --git a/files/es/web/api/navigator/getusermedia/index.html b/files/es/web/api/navigator/getusermedia/index.html deleted file mode 100644 index b3c1a00516480c..00000000000000 --- a/files/es/web/api/navigator/getusermedia/index.html +++ /dev/null @@ -1,136 +0,0 @@ ---- -title: Navigator.getUserMedia -slug: Web/API/Navigator/getUserMedia -translation_of: Web/API/Navigator/getUserMedia ---- -

Pide al usuario permiso para usar un dispositivo multimedia como una cámara o micrófono. Si el usuario concede este permiso, el successCallback es invocado en la aplicación llamada con un objeto LocalMediaStream como argumento.

- -

Sintaxis

- -
navigator.getUserMedia ( constraints, successCallback, errorCallback );
- -

Ejemplo

- -

Aquí hay un ejemplo usando getUserMedia() con los prefijos del navegador.

- -
navigator.getMedia = ( navigator.getUserMedia ||
-                       navigator.webkitGetUserMedia ||
-                       navigator.mozGetUserMedia);
-
-navigator.getMedia (
-
-   // Restricciones (contraints) *Requerido
-   {
-      video: true,
-      audio: true
-   },
-
-   // Funcion de finalizacion (Succes-Callback) *Requerido
-   function(localMediaStream) {
-      var video = document.querySelector('video');
-      video.src = window.URL.createObjectURL(localMediaStream);
-      video.onloadedmetadata = function(e) {
-         // Haz algo con el video aquí.
-      };
-   },
-
-   // errorCallback *Opcional
-   function(err) {
-    console.log("Ocurrió el siguiente error: " + err);
-   }
-
-);
- -

Parámetros

- - - - - - - - - - - - - - - - - - - - - - - - - - -
Parámetro -

Requerido/Opcional

- 		Descripción
constraintsRequeridoEl tipo de multimedia que soporta el objeto LocalMediaStream devuelto en el successCallback.
successCallback RequeridoLa función a invocar cuando se pasa el objeto LocalMediaStream.
errorCallbackOpcionalLa función que se invoca en la aplicación si falla la llamada.
- -

constraints

- -

El parámetro constraints es un objeto MediaStreamConstraints con dos miembros booleanos: video y audio. Estos describen el los tipos de multimedia soportados por el objeto LocalMediaStream. Uno o ambos deben ser especificados para validar el argumento del parametro constraint. Si un constraint especificado no es soportado por el navegador, getUserMedia llama a la función errorCallback con el error NOT_SUPPORTED_ERROR. Si el navegador no puede encontrar ninguna fuente multimedia con el tipo especificado, getUserMedia llama a la función errorCallback con el error MANDATORY_UNSATISFIED_ERR.

- -

Si el valor o el miembro no es especificado en el objeto, el valor del miembro por defecto será falso. El siguiente ejemplo muestra como definir el constraints para audio y video:

- -
{ video: true, audio: true }
- -

successCallback

- -

La función getUserMedia llamará a la función especificada en el successCallback con el objeto LocalMediaStream que contenga la secuencia multimedia. Puedes asignar el objeto al elemento apropiado y trabajar con él, como se muestra en el siguiente ejemplo:

- -
function(localMediaStream) {
-   var video = document.querySelector('video');
-   video.src = window.URL.createObjectURL(localMediaStream);
-   video.onloadedmetadata = function(e) {
-      // Haz algo aquí con el video.
-   };
-},
- -

errorCallback

- -

La función getUserMedia llama a la función indicada en el errorCallback con un código como argumento. Los códigos de error se describen a continuación:

- - - - - - - - - - - - - - - - - - - - - - - - - - -
Error Descripción
PERMISSION_DENIED El usuario denegó el permiso para usar el dispositivo multimadia requerido para esta operación.
NOT_SUPPORTED_ERROR Un constraint especificado no es soportado por el navegador.
MANDATORY_UNSATISFIED_ERROR No se encontraron fuentes multimedia del tipo especificado en el constraints.
NO_DEVICES_FOUNDNo se encontró ninguna webcam instalada.
- -

Compatibilidad con los navegadores

- -{{Compat("api.Navigator.getUserMedia")}} - -

Vease también

- - diff --git a/files/es/web/api/navigator/getusermedia/index.md b/files/es/web/api/navigator/getusermedia/index.md new file mode 100644 index 00000000000000..4f17eafff670bc --- /dev/null +++ b/files/es/web/api/navigator/getusermedia/index.md @@ -0,0 +1,99 @@ +--- +title: Navigator.getUserMedia +slug: Web/API/Navigator/getUserMedia +translation_of: Web/API/Navigator/getUserMedia +--- +Pide al usuario permiso para usar un dispositivo multimedia como una cámara o micrófono. Si el usuario concede este permiso, el successCallback es invocado en la aplicación llamada con un objeto [LocalMediaStream](/es/docs/WebRTC/MediaStream_API#LocalMediaStream "WebRTC/MediaStream_API#LocalMediaStream") como argumento. + +## Sintaxis + +``` +navigator.getUserMedia ( constraints, successCallback, errorCallback ); +``` + +**Ejemplo** + +Aquí hay un ejemplo usando getUserMedia() con los prefijos del navegador. + +```js +navigator.getMedia = ( navigator.getUserMedia || + navigator.webkitGetUserMedia || + navigator.mozGetUserMedia); + +navigator.getMedia ( + + // Restricciones (contraints) *Requerido + { + video: true, + audio: true + }, + + // Funcion de finalizacion (Succes-Callback) *Requerido + function(localMediaStream) { + var video = document.querySelector('video'); + video.src = window.URL.createObjectURL(localMediaStream); + video.onloadedmetadata = function(e) { + // Haz algo con el video aquí. + }; + }, + + // errorCallback *Opcional + function(err) { + console.log("Ocurrió el siguiente error: " + err); + } + +); +``` + +## Parámetros + +| Parámetro | Requerido/Opcional | Descripción | +| --------------- | ------------------ | -------------------------------------------------------------------------------------------- | +| constraints | Requerido | El tipo de multimedia que soporta el objeto LocalMediaStream devuelto en el successCallback. | +| successCallback | Requerido | La función a invocar cuando se pasa el objeto LocalMediaStream. | +| errorCallback | Opcional | La función que se invoca en la aplicación si falla la llamada. | + +### constraints + +El parámetro `constraints` es un objeto `MediaStreamConstraints` con dos miembros booleanos: `video` y `audio`. Estos describen el los tipos de multimedia soportados por el objeto [LocalMediaStream](/es/docs/WebRTC/MediaStream_API#LocalMediaStream "WebRTC/MediaStream_API#LocalMediaStream"). Uno o ambos deben ser especificados para validar el argumento del parametro constraint. Si un constraint especificado no es soportado por el navegador, `getUserMedia `llama a la función `errorCallback `con el error `NOT_SUPPORTED_ERROR`. Si el navegador no puede encontrar ninguna fuente multimedia con el tipo especificado, `getUserMedia `llama a la función `errorCallback `con el error `MANDATORY_UNSATISFIED_ERR`. + +Si el valor o el miembro no es especificado en el objeto, el valor del miembro por defecto será falso. El siguiente ejemplo muestra como definir el constraints para audio y video: + +``` +{ video: true, audio: true } +``` + +### successCallback + +La función getUserMedia llamará a la función especificada en el `successCallback `con el objeto [LocalMediaStream](/es/docs/WebRTC/MediaStream_API#LocalMediaStream "WebRTC/MediaStream_API#LocalMediaStream") que contenga la secuencia multimedia. Puedes asignar el objeto al elemento apropiado y trabajar con él, como se muestra en el siguiente ejemplo: + +``` +function(localMediaStream) { + var video = document.querySelector('video'); + video.src = window.URL.createObjectURL(localMediaStream); + video.onloadedmetadata = function(e) { + // Haz algo aquí con el video. + }; +}, +``` + +### errorCallback + +La función `getUserMedia `llama a la función indicada en el errorCallback con un `código` como argumento. Los códigos de error se describen a continuación: + +| Error | Descripción | +| --------------------------- | ----------------------------------------------------------------------------------------------- | +| PERMISSION_DENIED | El usuario denegó el permiso para usar el dispositivo multimadia requerido para esta operación. | +| NOT_SUPPORTED_ERROR | Un constraint especificado no es soportado por el navegador. | +| MANDATORY_UNSATISFIED_ERROR | No se encontraron fuentes multimedia del tipo especificado en el constraints. | +| NO_DEVICES_FOUND | No se encontró ninguna webcam instalada. | + +## Compatibilidad con los navegadores + +{{Compat("api.Navigator.getUserMedia")}} + +## Vease también + +- [WebRTC](/es/docs/WebRTC "WebRTC") - la página introductoria a la API +- [MediaStream API](/es/docs/WebRTC/MediaStream_API "WebRTC/MediaStream_API") - la API para los objetos multimedia +- [Taking webcam photos](/es/docs/WebRTC/taking_webcam_photos "WebRTC/taking_webcam_photos") - un tutorial acerca del uso de getUserMedia() diff --git a/files/es/web/api/navigator/index.html b/files/es/web/api/navigator/index.html deleted file mode 100644 index cc6fa7ca85d3a2..00000000000000 --- a/files/es/web/api/navigator/index.html +++ /dev/null @@ -1,141 +0,0 @@ ---- -title: Navigator -slug: Web/API/Navigator -tags: - - API - - HTML-DOM -translation_of: Web/API/Navigator ---- -

{{Apiref}}

- -

La interfaz Navigator representa el estado y la identidad del user agent. Es completamente consultable y es posible registrar scripts para que ejecuten diversas actividades.

- -

Un objeto Navigator puede ser obtenido usando la propiedad de sólo lectura {{domxref("Window.navigator")}}.

- -

Propiedades

- -

No hereda ninguna propiedad, pero implementa las definidas en {{domxref("NavigatorID")}}, {{domxref("NavigatorLanguage")}}, {{domxref("NavigatorOnLine")}}, {{domxref("NavigatorContentUtils")}}, {{domxref("NavigatorStorageUtils")}}, {{domxref("NavigatorCookies")}}, {{domxref("NavigatorConcurrentHardware")}}, {{domxref("NavigatorPlugins")}}, y {{domxref("NavigatorUserMedia")}}.

- -

Estándar

- -
-
{{domxref("Navigator.activeVRDisplays")}} {{readonlyInline}}{{experimental_inline}}
-
Devuelve un arreglo que contiene cada objeto {{domxref("VRDisplay")}} que está siendo presentado en el momento ({{domxref("VRDisplay.ispresenting")}} es true).
-
{{domxref("NavigatorID.appCodeName")}} {{readonlyInline}}{{experimental_inline}}
-
Devuelve el nombre código interno del navegador actual. No confie en que esta propiedad devuelva siempre el valor correcto.
-
{{domxref("NavigatorID.appName")}} {{readonlyInline}}{{experimental_inline}}
-
Devuelve un {{domxref("DOMString")}} con el nombre oficial del navegador. No confie en que esta propiedad devuelva siempre el valor correcto.
-
{{domxref("NavigatorID.appVersion")}} {{readonlyInline}}{{experimental_inline}}
-
Devuelve la versión del navegador como un {{domxref("DOMString")}}. No confie en que esta propiedad devuelva siempre el valor correcto.
-
{{domxref("Navigator.battery")}} {{readonlyInline}}
-
Devuelve un objeto de tipo {{domxref("BatteryManager")}} que puede utilizar para obtener la información del estado de carga de la batería.
-
{{domxref("NetworkInformation.connection")}} {{readonlyInline}}{{experimental_inline}}
-
Provee un objeto {{domxref("NetworkInformation")}} con la información sobre la conexión a la red de un dispositivo.
-
{{domxref("NavigatorGeolocation.geolocation")}} {{readonlyInline}}
-
Devuelve un objeto {{domxref("Geolocation")}} que permite el acceso a la ubicación del dispositivo.
-
{{domxref("NavigatorConcurrentHardware.hardwareConcurrency")}} {{readOnlyInline}}
-
Devuelve el número de núcleos de procesador lógicos disponibles.
-
{{domxref("NavigatorPlugins.javaEnabled")}} {{readonlyInline}}{{experimental_inline}}
-
Devuelve un valor {{domxref("Boolean")}} que indica si el navegador tiene o no habilitado Java.
-
{{domxref("NavigatorLanguage.language")}} {{readonlyInline}}
-
Devuelve un valor {{domxref("DOMString")}} que representa el idioma elegido por el usuario, generalmente el idioma de la interfaz del navegador. Si no se puede identificar el idioma, devuelve un valor null.
-
{{domxref("NavigatorLanguage.languages")}} {{readonlyInline}}
-
Devuelve un arreglo de {{domxref("DOMString")}} que representan los idiomas conocidos por el usuario, en orden de preferencia.
-
{{domxref("NavigatorPlugins.mimeTypes")}} {{readonlyInline}}{{experimental_inline}}
-
Devieñve im {{domxref("MimeTypeArray")}} que enlista los tipos MIME soportados por el navegador.
-
{{domxref("NavigatorOnLine.onLine")}} {{readonlyInline}}
-
Devuelve un valor {{domxref("Boolean")}} que indica si el navegador está trabajando en línea.
-
{{domxref("Navigator.oscpu")}}
-
Devuelve una cadena de texto que representa al sistema operativo actual.
-
{{domxref("Navigator.permissions")}} {{readonlyinline}}{{experimental_inline}}
-
;
-
Devuelve un objeto {{domxref("Permissions")}} que puede ser usado para consultar y actualizar estatus de permisos de las APIs, acorde a la API Permissions.
-
{{domxref("NavigatorID.platform")}} {{readonlyInline}}{{experimental_inline}}
-
Devuelve una cadena de texto que representa la plataforma del navegador. No confíe en que esta función devuelva un valor significativo.
-
{{domxref("NavigatorPlugins.plugins")}} {{readonlyInline}}{{experimental_inline}}
-
Devuelve un {{domxref("PluginArray")}} que enlista los plugins instalados en el navegador.
-
{{domxref("NavigatorID.product")}} {{readonlyInline}} {{experimental_inline}}
-
Siempre devuelve 'Gecko', en cualquier navegador. Esta propiedad es mantenido únicamente por razones de compatibilidad.
-
{{domxref("NavigatorID.userAgent")}} {{readonlyInline}}
-
Devuelve la cadena de agente usuario del navegador actual.
-
{{domxref("Navigator.serviceWorker")}} {{readonlyInline}}
-
Devuelve un objeto {{domxref("ServiceWorkerContainer")}}, el cual provee acceso a registro, eliminación, actualización y comunicación con los objetos {{domxref("ServiceWorker")}} para documentos asociados.
-
- -

No Estándar

- -
-

Dispositivos con Firefox OS añaden más propiedades no estándares. Puede consultarlas en el artículo de extensiones de Navigator de Firefox OS.

-
- -
-
{{domxref("Navigator.buildID")}} {{non-standard_inline}}
-
Devuelve el identificador de la compilación del navegador(p.ej., "2006090803").
-
{{domxref("Navigator.cookieEnabled")}} {{non-standard_inline}}
-
Devuelve un booleano que indica si el navegador tiene activadas las cookies.
-
{{domxref("Navigator.credentials")}} {{non-standard_inline}}
-
Devuelve la interfaz {{domxref("CredentialsContainer")}}, la cual expone métodos para solicitar credenciales y notificar al agente usuario cuando ocurran eventos de interés, como inicios o cierres de sesión.
-
{{domxref("Navigator.doNotTrack")}} {{non-standard_inline}}
-
Reporta el valor de la preferencia do-not-track. Cuando su valor es positivo ("yes", "1"), el sitio o aplicación web no debe rastrear al usuario.
-
{{domxref("Navigator.id")}} {{non-standard_inline}}
-
Devuelve el objeto {{domxref("window.navigator.id", "id")}}, el cual se puede usar para añadir soporte a BrowserID en el sitio web.
-
{{domxref("Navigator.mediaDevices")}} {{non-standard_inline}}
-
Devuelve una referencia a la interfaz {{domxref("MediaDevices")}}.
-
{{domxref("Navigator.mozNotification")}} {{deprecated_inline("22")}} {{non-standard_inline}}
- {{domxref("Navigator.webkitNotification")}}
-
Devuelve un objeto {{domxref("navigator.mozNotification", "notification")}} que puede ser usado para enviar notificaciones al usuario desde la aplicación web.
-
{{domxref("Navigator.mozSocial")}} {{non-standard_inline}}
-
El objeto devuelto por la propiedad navigator.mozSocial, está disponible en el panel de proveedor de medios sociales para proporcionar funcionalidad la que se necesite.
-
{{domxref("Navigator.presentation")}} {{non-standard_inline}}
-
Devuelve una referencia a la API {{domxref("Presentation")}}.
-
{{domxref("Navigator.productSub")}} {{non-standard_inline}}
-
Devuelve el número de compilación del navegador actual (p.ej., "20060909").
-
{{domxref("Navigator.securitypolicy")}} {{non-standard_inline}}
-
Devuelve una cadena de texto vacía. En Netscape 4.7x, devuelve "US & CA domestic policy" o "Export policy".
-
{{domxref("Navigator.standalone")}} {{non-standard_inline}}
-
Devuelve un booleano que indica si el navegador está ejecutándose en modo standalone. Disponible sólo para Safari de iOS de Apple.
-
{{domxref("Navigator.vendor")}} {{non-standard_inline}}
-
Devuelve el nombre del fabricante del navegador actual (p.ej., "Netscape6").
-
{{domxref("Navigator.vendorSub")}} {{non-standard_inline}}
-
Devuelve la versión de fabricante (p.ej. "6.1").
-
{{domxref("Navigator.webkitPointer")}} {{non-standard_inline}}
-
Devuelve un objeto PointerLock para la API Mouse Lock.
-
- -

Métodos

- -

No hereda ninguna propiedad, pero implementa las definidas en {{domxref("NavigatorID")}}, {{domxref("NavigatorContentUtils")}}, {{domxref("NavigatorUserMedia")}}, y {{domxref("NavigatorStorageUtils")}}.

- -

Estándar

- -
-
{{domxref("Navigator.getVRDisplays()")}} {{experimental_inline}}
-
Devuelve una promesa que se resuelve en un arreglo de objetos {{domxref("VRDisplay")}} que representan cualquier dispositivo VR conectado a la computadora que esté disponible.
-
{{domxref("Navigator.getUserMedia", "NavigatorUserMedia.getUserMedia()")}}
-
Después de solicitar permiso al usuario, devuelve el stream de audio o video asociado a la cámara o micrófono de la computadora local.
-
{{domxref("Navigator.registerContentHandler()")}}
-
Permite a los web sites registrarse como posibles controladores de un tipo MIME determinado.
-
{{domxref("Navigator.registerProtocolHandler()")}}
-
Permite a los sitios webs registrarse como posibles controladores de un protocolo determinado.
-
{{domxref("Navigator.requestMediaKeySystemAccess()")}} {{experimental_inline}}
-
Devuelve un objeto {{jsxref("Promise")}} para un objeto MediaKeySystemAccess.
-
{{domxref("Navigator.sendBeacon()")}}{{experimental_inline}}
-
Usado para transferir, de forma asíncrona, conjuntos pequeños de datos HTTP del agente usuario al servidor.
-
{{domxref("NavigatorID.taintEnabled()")}} {{deprecated_inline("1.7.8")}} {{obsolete_inline("9.0")}} {{experimental_inline}}
-
Devuelve false. Las funciones taint/untaint de JavaScript fueron desaprobadas en JavaScript 1.2.
-
{{domxref("Navigator.vibrate()")}} {{gecko_minversion_inline("11.0")}}
-
Causa vibración en el dispositivo que la soporta. No hace nada si el soporte para vibración no está disponible.
-
- -

No Estándar

- -
-

Dispositivos con Firefox OS añaden más métodos no estándares. Puede consultarlas en el artículo de extensiones de Navigator de Firefox OS.

-
- -
-
{{domxref("Navigator.mozIsLocallyAvailable()")}} {{non-standard_inline}}
-
Permite al código verificar si el documento en una URI determinada está disponible sin usar la red.
-
{{domxref("Navigator.mozPay()")}} {{non-standard_inline}}
-
Permite pagos dentro de la aplicación.
-
diff --git a/files/es/web/api/navigator/index.md b/files/es/web/api/navigator/index.md new file mode 100644 index 00000000000000..646ed4e69b9e14 --- /dev/null +++ b/files/es/web/api/navigator/index.md @@ -0,0 +1,166 @@ +--- +title: Navigator +slug: Web/API/Navigator +page-type: web-api-interface +translation_of: Web/API/Navigator +l10n: + sourceCommit: 165b70e57270af4ba85526d92cce74d51d12c39d165b70e57270af4ba85526d92cce74d51d12c39d +browser-compat: api.Navigator +--- + +{{APIRef("DOM")}} + +La interfaz **`Navigator`** representa el estado y la identidad del _user agent_. Es completamente consultable y es posible registrar scripts para que ejecuten diversas actividades. + +Un objeto `Navigator` puede ser obtenido usando la propiedad de sólo lectura {{domxref("Window.navigator")}}. + +## Propiedades de instancia + +_No hereda ninguna propiedad_ + +### Propiedadedes estandard + +- {{domxref("Navigator.connection")}} {{ReadOnlyInline}} {{Experimental_Inline}} + - : Proporciona un objeto {{domxref("NetworkInformation")}} que contiene información sobre la conexión de red de un dispositivo. +- {{domxref("Navigator.cookieEnabled")}} {{ReadOnlyInline}} + - : Devuelve false si se ignorará la configuración de una cookie y true en caso contrario. +- {{domxref("Navigator.credentials")}} {{ReadOnlyInline}} + - : Devuelve la interfaz {{domxref("CredentialsContainer")}} que expone métodos para solicitar credenciales y notificar al agente de usuario cuando ocurren eventos interesantes, como iniciar o cerrar sesión correctamente. +- {{domxref("Navigator.deviceMemory")}} {{ReadOnlyInline}} {{Experimental_Inline}} + - : Devuelve la cantidad de memoria del dispositivo en gigabytes. Este valor es una aproximación dada redondeando a la potencia de 2 más cercana y dividiendo ese número por 1024. +- {{domxref("Navigator.geolocation")}} {{ReadOnlyInline}} + - : Devuelve un objeto {{domxref("Geolocalización")}} que permite acceder a la ubicación del dispositivo. +- {{domxref("Navigator.hid")}} {{ReadOnlyInline}} {{Experimental_Inline}} + - : Devuelve un objeto {{domxref("HID")}} que proporciona métodos para conectarse a dispositivos HID, listar dispositivos HID conectados y controladores de eventos para dispositivos HID conectados. +- {{domxref("Navigator.hardwareConcurrency")}} {{ReadOnlyInline}} + - : Devuelve el número de núcleos de procesador lógico disponibles. +- {{domxref('Navigator.keyboard')}} {{ReadOnlyInline}} {{Experimental_Inline}} + - : Devuelve un objeto {{domxref('Keyboard')}} que brinda acceso a funciones que recuperan mapas de diseño de teclado y alternan la captura de pulsaciones de teclas desde el teclado físico. +- {{domxref("Navigator.language")}} {{ReadOnlyInline}} + - : Devuelve una cadena que representa el idioma preferido del usuario, generalmente el idioma de la interfaz de usuario del navegador. El valor `null` se devuelve cuando se desconoce. +- {{domxref("Navigator.languages")}} {{ReadOnlyInline}} + - :Devuelve una matriz de cadenas que representan los idiomas que conoce el usuario, por orden de preferencia. +- {{domxref("Navigator.locks")}} {{ReadOnlyInline}} + - : Devuelve un objeto {{domxref("LockManager")}} que proporciona métodos para solicitar un nuevo objeto {{domxref('Lock')}} y consultar un objeto {{domxref('Lock')}} existente. +- {{domxref("Navigator.maxTouchPoints")}} {{ReadOnlyInline}} + - : Devuelve el número máximo de puntos de contacto táctiles simultáneos admitidos por el dispositivo actual. +- {{domxref("Navigator.mediaCapabilities")}} {{ReadOnlyInline}} + - : Devuelve un objeto {{domxref("MediaCapabilities")}} que puede exponer información sobre las capacidades de decodificación y codificación para un formato y capacidades de salida determinados. +- {{domxref("Navigator.mediaDevices")}} {{ReadOnlyInline}} + - : Devuelve una referencia a un objeto {{domxref("MediaDevices")}} que luego se puede usar para obtener información sobre los dispositivos de medios disponibles ({{domxref("MediaDevices.enumerateDevices()")}}), averiguar qué propiedades restringibles son compatibles con los medios en la computadora del usuario y el agente de usuario ({{domxref("MediaDevices.getSupportedConstraints()")}}) y para solicitar acceso a los medios usando {{domxref("MediaDevices.getUserMedia()")}}. +- {{domxref("Navigator.mediaSession")}} {{ReadOnlyInline}} + - : Devuelve el objeto {{domxref("MediaSession")}} que se puede usar para proporcionar metadatos que el navegador puede usar para presentar información sobre los medios que se están reproduciendo actualmente al usuario, como en una interfaz de usuario de controles de medios globales. +- {{domxref("Navigator.onLine")}} {{ReadOnlyInline}} + - : Devuelve un valor booleano que indica si el navegador está funcionando en línea. +- {{domxref("Navigator.pdfViewerEnabled")}} {{ReadOnlyInline}} + - : Devuelve "verdadero" si el navegador puede mostrar archivos PDF en línea cuando se navega hacia ellos, y "falso" en caso contrario. +- {{domxref("Navigator.permissions")}} {{ReadOnlyInline}} + - : Devuelve un objeto {{domxref("Permisos")}} que se puede usar para consultar y actualizar el estado de los permisos de las API cubiertas por la [API de permisos](/es/docs/Web/API/Permissions_API). +- {{domxref("Navigator.presentation")}} {{ReadOnlyInline}} + - : Returns a reference to the {{domxref("Presentation")}} API. +- {{domxref("Navigator.serial")}} {{ReadOnlyInline}} {{Experimental_Inline}} + - : Devuelve un objeto {{domxref("Serial")}}, que representa el punto de entrada a {{domxref("Web Serial API")}} para habilitar el control de los puertos serie. +- {{domxref("Navigator.serviceWorker")}} {{ReadOnlyInline}} + - : Devuelve un objeto {{domxref("ServiceWorkerContainer")}}, que proporciona acceso al registro, eliminación, actualización y comunicación con los objetos {{domxref("ServiceWorker")}} para el [documento asociado](https:// html.spec.whatwg.org/multipage/browsers.html#concept-document-window). +- {{domxref("Navigator.storage")}} {{ReadOnlyInline}} + - : Devuelve el objeto singleton {{domxref('StorageManager')}} que se usa para administrar los permisos de persistencia y estimar el almacenamiento disponible sitio por sitio y aplicación por aplicación. +- {{domxref("Navigator.userActivation")}} {{ReadOnlyInline}} {{Experimental_Inline}} + - : Devuelve un objeto {{domxref("UserActivation")}} que contiene información sobre el estado de activación del usuario de la ventana actual. +- {{domxref("Navigator.userAgent")}} {{ReadOnlyInline}} + - : Devuelve la cadena de agente de usuario para el navegador actual. +- {{domxref("Navigator.userAgentData")}} {{ReadOnlyInline}} {{Experimental_Inline}} + - : Devuelve un objeto {{domxref("NavigatorUAData")}}, que da acceso a información sobre el navegador y el sistema operativo del usuario. +- {{domxref("Navigator.webdriver")}} {{ReadOnlyInline}} + - : Indica si el agente de usuario está controlado por automatización. +- {{domxref("Navigator.windowControlsOverlay")}} {{ReadOnlyInline}} + - : Devuelve la interfaz {{domxref("WindowControlsOverlay")}} que expone información sobre la geometría de la barra de título en aplicaciones web progresivas de escritorio y un evento para saber cuándo cambia. +- {{domxref("Navigator.xr")}} {{ReadOnlyInline}} {{Experimental_Inline}} + - : Devuelve el objeto {{domxref("XRSystem")}}, que representa el punto de entrada a [WebXR API](/es/docs/Web/API/WebXR_Device_API). + +### Propiedades no estandares + +- {{domxref("Navigator.buildID")}} {{Non-standard_Inline}} + - : Devuelve el identificador de compilación del navegador. En los navegadores modernos, esta propiedad ahora devuelve una marca de tiempo fija como medida de privacidad, p. `20181001000000` en Firefox 64 en adelante. +- {{domxref("Navigator.contacts")}} {{ReadOnlyInline}} {{Experimental_Inline}} + - : Devuelve una interfaz {{domxref('ContactsManager')}} que permite a los usuarios seleccionar entradas de su lista de contactos y compartir detalles limitados de las entradas seleccionadas con un sitio web o una aplicación. +- {{domxref("Navigator.globalPrivacyControl")}} {{Non-standard_Inline}} {{Experimental_Inline}} + - : Devuelve un valor booleano que indica el consentimiento de un usuario para que su información sea compartida o vendida. +- {{domxref("Navigator.securitypolicy")}} {{Non-standard_Inline}} + - : Devuelve una cadena vacía. En Netscape 4.7x, devuelve "Política nacional de EE. UU. y CA" o "Política de exportación". +- {{domxref("Navigator.standalone")}} {{Non-standard_Inline}} + - : Devuelve un valor booleano que indica si el navegador se está ejecutando en modo independiente. Disponible solo en iOS Safari de Apple. +- {{domxref("Navigator.wakeLock")}} {{ReadOnlyInline}} {{Experimental_Inline}} + - : Devuelve una interfaz {{domxref("WakeLock")}} que puede usar para solicitar bloqueos de activación de pantalla y evitar que la pantalla se atenúe, apague o muestre un protector de pantalla. + +### Propiedades deprecadas + +- {{domxref("Navigator.appCodeName")}} {{ReadOnlyInline}} {{Deprecated_Inline}} + - : Siempre devuelve `'Mozilla'`, en cualquier navegador. +- {{domxref("Navigator.appName")}} {{ReadOnlyInline}} {{Deprecated_Inline}} + - : Siempre devuelve `'Netscape'`, en cualquier navegador. +- {{domxref("Navigator.appVersion")}} {{ReadOnlyInline}} {{Deprecated_Inline}} + - : Devuelve la versión del navegador como una cadena. No confíe en esta propiedad para devolver el valor correcto. +- {{domxref("Navigator.activeVRDisplays")}} {{ReadOnlyInline}} {{Deprecated_Inline}} {{Non-standard_Inline}} + - : Devuelve una matriz que contiene cada objeto {{domxref("VRDisplay")}} que se está presentando actualmente ({{domxref("VRDisplay.ispresenting")}} es `true`). +- {{domxref("Navigator.doNotTrack")}} {{ReadOnlyInline}} {{Deprecated_Inline}} + - : Informa el valor de la preferencia de no rastrear del usuario. Cuando este valor es "sí", su sitio web o aplicación no debe rastrear al usuario. +- {{domxref("Navigator.mimeTypes")}} {{ReadOnlyInline}} {{Deprecated_Inline}} + - : Devuelve un {{domxref("MimeTypeArray")}} que enumera los tipos MIME admitidos por el navegador. +- {{domxref("Navigator.oscpu")}} {{ReadOnlyInline}} {{Deprecated_Inline}} + - : Devuelve una cadena que representa el sistema operativo actual. +- {{domxref("Navigator.platform")}} {{ReadOnlyInline}} {{Deprecated_Inline}} + - : Devuelve una cadena que representa la plataforma del navegador. No confíe en esta función para devolver un valor significativo. +- {{domxref("Navigator.plugins")}} {{ReadOnlyInline}} {{Deprecated_Inline}} + - : Devuelve un {{domxref("PluginArray")}} que enumera los complementos instalados en el navegador. +- {{domxref("Navigator.product")}} {{ReadOnlyInline}} {{Deprecated_Inline}} + - : Siempre devuelve `'Gecko'`, en cualquier navegador. +- {{domxref("Navigator.productSub")}} {{ReadOnlyInline}} {{Deprecated_Inline}} + - : Devuelve la cadena `'20030107'', o `'"20100101''. +- {{domxref("Navigator.vendor")}} {{ReadOnlyInline}} {{Deprecated_Inline}} + - : Devuelve la cadena vacía, `'Apple Computer Inc.'` o `'Google Inc.'`. +- {{domxref("Navigator.vendorSub")}} {{ReadOnlyInline}} {{Deprecated_Inline}} + - : Siempre devuelve la cadena vacía. + +## Metodos de instancia + +_No hereda ningun metodo_ + +- {{domxref("Navigator.canShare()")}} + - : Devuelve `verdadero` si una llamada a `Navigator.share()` tiene éxito. +- {{domxref("Navigator.clearAppBadge()")}} {{Experimental_Inline}} + - : Borra una insignia en el ícono de la aplicación actual y devuelve un {{jsxref("Promise")}} que se resuelve con {{jsxref("undefined")}}. +- {{domxref("Navigator.getBattery()")}} + - : Devuelve una promesa que se resuelve con un objeto {{domxref("BatteryManager")}} que devuelve información sobre el estado de carga de la batería. +- {{domxref("Navigator.registerProtocolHandler()")}} + - : Permite que los sitios web se registren como un posible controlador para un protocolo determinado. +- {{domxref("Navigator.requestMediaKeySystemAccess()")}} + - : Devuelve un {{jsxref("Promise")}} para un objeto MediaKeySystemAccess. +- {{domxref("Navigator.requestMIDIAccess()")}} + - : Devuelve un {{jsxref('Promise')}} que representa una solicitud de acceso a dispositivos MIDI en el sistema del usuario. +- {{domxref("Navigator.sendBeacon()")}} + - : se utiliza para transferir de forma asíncrona una pequeña cantidad de datos mediante {{Glossary("HTTP")}} desde el agente de usuario a un servidor web. +- {{domxref("Navigator.setAppBadge()")}} {{Experimental_Inline}} + - : establece una insignia en el ícono asociado con esta aplicación y devuelve un {{jsxref("Promise")}} que se resuelve con {{jsxref("undefined")}}. +- {{domxref("Navigator.share()")}} + - : Invoca el mecanismo de uso compartido nativo de la plataforma actual. +- {{domxref("Navigator.vibrate()")}} + - : Provoca vibración en dispositivos compatibles. No hace nada si el soporte de vibración no está disponible. + +### Metodos deprecados + +- {{domxref("Navigator.getVRDisplays()")}} {{Deprecated_Inline}} {{Non-standard_Inline}} + - : Devuelve una promesa que se resuelve en una matriz de {{domxref("VRDisplay")}} objetos que representan cualquier dispositivo VR disponible conectado a la computadora. +- {{domxref("Navigator.getUserMedia()")}} {{Deprecated_Inline}} + - : Después de haber solicitado permiso al usuario, devuelve el flujo de audio o video asociado a una cámara o micrófono en la computadora local. +- {{domxref("Navigator.taintEnabled()")}} {{Deprecated_Inline}} + - : Devuelve `falso`. Las funciones de corrupción/no corrupción de JavaScript se eliminaron en JavaScript 1.2. +- {{domxref("Navigator.javaEnabled()")}} {{Deprecated_Inline}} + - : Siempre devuelve falso. + +## Especificaciones + +{{Specifications}} + +## Compatibilidad con navegadores + +{{Compat}} diff --git a/files/es/web/api/navigator/registerprotocolhandler/index.html b/files/es/web/api/navigator/registerprotocolhandler/index.html deleted file mode 100644 index de317305294700..00000000000000 --- a/files/es/web/api/navigator/registerprotocolhandler/index.html +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: window.navigator.registerProtocolHandler -slug: Web/API/Navigator/registerProtocolHandler -tags: - - Firefox 3 - - Referencia_DOM_de_Gecko -translation_of: Web/API/Navigator/registerProtocolHandler ---- -

{{ ApiRef() }}

-

Resumen

-

Permite que las páginas web se registren por si mismas como posibles manejadores para protocolos concretos.

-

Sintaxis

-
window.navigator.registerProtocolHandler(protocol,uri,title);
-
- -

Ejemplo

-
navigator.registerProtocolHandler("mailto",
-                                 "https://mail.google.com/mail?view=cm&tf=0&to=%s",
-                                 "Google Mail");
-
-

Esto crea un nuevo manejador que permite a los enlaces de tipo "mailto:" dirigir al usuario a Google Mail, insertando la dirección de correo especificada en el enlace, en la URL.

-

Especificación

-

Especificado en el documento del WHATWG: Web Applications 1.0 working draft.

-

-

-
-
-

{{ languages( { "en": "en/DOM/window.navigator.registerProtocolHandler", "fr": "fr/DOM/window.navigator.registerProtocolHandler", "ja": "ja/DOM/window.navigator.registerProtocolHandler", "ko": "ko/DOM/window.navigator.registerProtocolHandler", "pl": "pl/DOM/window.navigator.registerProtocolHandler" } ) }}

diff --git a/files/es/web/api/navigator/registerprotocolhandler/index.md b/files/es/web/api/navigator/registerprotocolhandler/index.md new file mode 100644 index 00000000000000..396a38eb4e8a0f --- /dev/null +++ b/files/es/web/api/navigator/registerprotocolhandler/index.md @@ -0,0 +1,45 @@ +--- +title: window.navigator.registerProtocolHandler +slug: Web/API/Navigator/registerProtocolHandler +page-type: web-api-instance-method +translation_of: Web/API/Navigator/registerProtocolHandler +browser-compat: api.Navigator.registerProtocolHandler +--- +{{ ApiRef() }} + +### Resumen + +Permite que las páginas web se registren por si mismas como posibles manejadores para protocolos concretos. + +### Sintaxis + +``` +window.navigator.registerProtocolHandler(protocol,uri,title); +``` + +- `protocol` es el protocolo que el sitio quiere manejar, especificado como una cadena. +- `uri` es la URI del manejador en forma de cadena. Puedes incluir "%s" para indicar dónde debe insertarse la URI (en formato escaped) del documento a manejar. +- `title` es el título del manejador presentado al usuario como una cadena. + +### Ejemplo + +``` +navigator.registerProtocolHandler("mailto", + "https://mail.google.com/mail?view=cm&tf=0&to=%s", + "Google Mail"); +``` + +Esto crea un nuevo manejador que permite a los enlaces de tipo "mailto:" dirigir al usuario a Google Mail, insertando la dirección de correo especificada en el enlace, en la URL. + +### Especificación + +{{Specifications}} + +## Compatibilidad con navegadores + +{{Compat}} + +## Véase también + +- [Manejadores de protocolos basados en Web](/es/docs/Web/API/Navigator/registerProtocolHandler/Web-based_protocol_handlers) +- [RegisterProtocolHandler Mejora de la web federada](https://blog.mozilla.org/webdev/2010/07/26/registerprotocolhandler-enhancing-the-federated-web/) (Mozilla Webdev) diff --git a/files/es/web/api/navigator/registerprotocolhandler/web-based_protocol_handlers/index.html b/files/es/web/api/navigator/registerprotocolhandler/web-based_protocol_handlers/index.html deleted file mode 100644 index 8c429b21e4f913..00000000000000 --- a/files/es/web/api/navigator/registerprotocolhandler/web-based_protocol_handlers/index.html +++ /dev/null @@ -1,130 +0,0 @@ ---- -title: Controladores de protocolos basados en web -slug: Web/API/Navigator/registerProtocolHandler/Web-based_protocol_handlers -tags: - - Avanzado - - Controladores de Protocolos Basados en Web - - HTML5 -translation_of: Web/API/Navigator/registerProtocolHandler/Web-based_protocol_handlers ---- -

Antecedentes

- -

Es bastante común encontrar enlaces de páginas web a recursos que no usan protocolos http. Un ejemplo es el protocolo mailto::

- -
-
<a href="mailto:webmaster@example.com">Web Master</a>
-
- -

Los autores de la Web pueden usar un enlace mailto: cuando quieren proporcionar una forma conveniente para que los usuarios envién un correo electrónico, directamente desde la página web. Cuando el enlace está activo, el navegador debería lanzar la aplicación de escritorio predeterminada para gestionar correos electrónicos. Se puede pensar en esto como un controlador de protocolos basados en escritorio.

- -

Los controladores de protocolos basados en web permiten a las aplicaciones basadas en web participar en el proceso también. Esto es cada vez más importante a medida que más tipos de aplicaciones migren a la web. De hecho, hay muchas aplicaciones basadas en web que gestionan correo electrónicos podrían procesar un enlace mailto.

- -

Registro

- -

Configurar una aplicación web como un controlador de protocolo no es un proceso difícil. Básicamente la aplicación web usa registerProtocolHandler() para registrarse a sí mismo con el navegador como un controlador potencial para un protocolo dado. Por ejemplo:

- -
navigator.registerProtocolHandler("burger",
-                                  "http://www.google.co.uk/?uri=%s",
-                                  "Burger handler");
- -

En donde los parámetros son:

- - - -

Cuando un navegador ejecuta este código, se le mostrará un mensaje al usuario, pidiendo permiso para permitir a la aplicación web registrase como controlador para el protocolo. Firefox muestra un mensaje en el área de la barra de notificaciones:

- -

- -
Nota: La plantila de la URL proporcionada al registrar debe ser del mismo dominio que el de la página que intenta realizar el registro o el registro fallará. Por ejemplo, http://example.com/homepage.html puede registrar un controlador de protocolo para http://example.com/handle_mailto/%s, pero no para http://example.org/handle_mailto/%s.
- -

Al registrar el mismo controlador de protocolo más de una vez aparecerá una notifiación diferente, indicando que el controlador del protocolo ya ha está registrado. Por lo tanto, es una buena idea cuidar el registro del controlador de protocolo con una verificación para saber si ya está registrado, como con el siguiente ejemplo.

- -

Ejemplo

- -
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
-<html lang="en">
-<head>
-  <title>Ejemplo de Controlador de Protocolo Web - Registro</title>
-  <script type="text/javascript">
-    navigator.registerProtocolHandler("burger",
-                                  "http://www.google.co.uk/?uri=%s",
-                                  "Burger handler");
-  </script>
-</head>
-<body>
-  <h1>Ejemplo de Controlador de Protocolo Web</h1>
-  <p>Esta página web instalará un controlador de protocolo web para el protocolo <code>burger:</code>.</p>
-</body>
-</html>
-
- -

Activando

- -

Ahora, cada vez que el usuario active un enlace que usa el protocolo registrado, el navegador enrutará la acción a la URL suministrada cuando la aplicación web se haya registrado. Firefox, de manera predeterminada, alertará al usaurio antes de controlar la acción.

- -

Ejemplo

- -
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
-<html lang="en">
-<head>
-  <title>Ejemplo de Controlador de Protocolo Web - Prueba</title>
-</head>
-<body>
-  <p>Oye ¿Has visto <a href="burger:cheeseburger">esto</a> antes?</p>
-</body>
-</html>
-
- -

Controlando

- -

La siguiente fase es controlar la acción. El navgador extrae el href desde el enlace activado, lo combina con la plantilla de la URL suministrada durante el registro del controlador y realzia una petición HTTP GET sobre la URL. Luego, usando los ejemplos anteriores, el navegador realizará una petición GET sobre esta URL:

- -
http://www.google.co.uk/?uri=burger:cheeseburger
-
- -

El código del lado del servidor puede extraer los parámetros de la cadena de petición y realizar la acción deseada.

- -
Nota: Al código del lado del servidor se le pasa todo el contenido del href. Esto significa que el código del lado del servidor tendrá que analizar el protocolo desde los datos.
- -

Example

- -
<?php
-$value = "";
-if ( isset ( $_GET["value"] ) ) {
-  $value = $_GET["value"];
-}
-?>
-
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <title>Ejemplo de Controlador de Protocolo Web</title>
-</head>
-<body>
-  <h1>Ejemplo de Controlador de Protocolo Web - Controlador</h1>
-  <p>Esta página es llamada al controlar una acción del protocolo <code>burger:</code>. Datos enviados:</p>
-  <textarea>
-<?php echo(htmlspecialchars($value, ENT_QUOTES, 'UTF-8')); ?>
-  </textarea>
-</body>
-</html>
-
- -

Referencias

- - - -

Véase también

- - diff --git a/files/es/web/api/navigator/registerprotocolhandler/web-based_protocol_handlers/index.md b/files/es/web/api/navigator/registerprotocolhandler/web-based_protocol_handlers/index.md new file mode 100644 index 00000000000000..c4be243411d8a2 --- /dev/null +++ b/files/es/web/api/navigator/registerprotocolhandler/web-based_protocol_handlers/index.md @@ -0,0 +1,130 @@ +--- +title: Controladores de protocolos basados en web +slug: Web/API/Navigator/registerProtocolHandler/Web-based_protocol_handlers +tags: + - Avanzado + - Controladores de Protocolos Basados en Web + - HTML5 +translation_of: Web/API/Navigator/registerProtocolHandler/Web-based_protocol_handlers +--- +## Antecedentes + +Es bastante común encontrar enlaces de páginas web a recursos que no usan protocolos \`http\`. Un ejemplo es el protocolo \`mailto:\` + +```html +Web Master +``` + +Los autores de la Web pueden usar un enlace \`mailto:\` cuando quieren proporcionar una forma conveniente para que los usuarios envién un correo electrónico, directamente desde la página web. Cuando el enlace está activo, el navegador debería lanzar la aplicación de escritorio predeterminada para gestionar correos electrónicos. Se puede pensar en esto como un controlador de protocolos _basados en escritorio_. + +Los controladores de protocolos basados en web permiten a las aplicaciones basadas en web participar en el proceso también. Esto es cada vez más importante a medida que más tipos de aplicaciones migren a la web. De hecho, hay muchas aplicaciones basadas en web que gestionan correo electrónicos podrían procesar un enlace \`mailto\`. + +## Registro + +Configurar una aplicación web como un controlador de protocolo no es un proceso difícil. Básicamente la aplicación web usa [registerProtocolHandler()](/es/docs/Web/API/navigator.registerProtocolHandler "DOM/window.navigator.registerProtocolHandler") para registrarse a sí mismo con el navegador como un controlador potencial para un protocolo dado. Por ejemplo: + +```js +navigator.registerProtocolHandler("burger", + "http://www.google.co.uk/?uri=%s", + "Burger handler"); +``` + +En donde los parámetros son: + +- El protocolo. +- La plantilla de la URL, usada como el controlador. El "%s" es reemplazado con el \`href\` del enlace y una petición GET es ejecutada en la URL resultante. +- El nombre fácil de usar para el controlador del protocolo. + +Cuando un navegador ejecuta este código, se le mostrará un mensaje al usuario, pidiendo permiso para permitir a la aplicación web registrase como controlador para el protocolo. Firefox muestra un mensaje en el área de la barra de notificaciones: + +![](https://mdn.mozillademos.org/files/9683/protocolregister.png) + +> **Nota:** La plantila de la URL proporcionada al registrar **debe** ser del mismo dominio que el de la página que intenta realizar el registro o el registro fallará. Por ejemplo, \`http\://example.com/homepage.html\` puede registrar un controlador de protocolo para \`http\://example.com/handle_mailto/%s\`, pero no para \`http\://example._**org**_/handle_mailto/%s\`. + +Al registrar el mismo controlador de protocolo más de una vez aparecerá una notifiación diferente, indicando que el controlador del protocolo ya ha está registrado. Por lo tanto, es una buena idea cuidar el registro del controlador de protocolo con una verificación para saber si ya está registrado, como con el siguiente ejemplo. + +### Ejemplo + +```js + + + + Ejemplo de Controlador de Protocolo Web - Registro + + + +

Ejemplo de Controlador de Protocolo Web

+

Esta página web instalará un controlador de protocolo web para el protocolo burger:;.

+ + +``` + +## Activando + +Ahora, cada vez que el usuario active un enlace que usa el protocolo registrado, el navegador enrutará la acción a la URL suministrada cuando la aplicación web se haya registrado. Firefox, de manera predeterminada, alertará al usaurio antes de controlar la acción. + +### Ejemplo + +```html + + + + Ejemplo de Controlador de Protocolo Web - Prueba + + +

Oye ¿Has visto esto antes?

+ + +``` + +## Controlando + +La siguiente fase es controlar la acción. El navgador extrae el \`href\` desde el enlace activado, lo combina con la plantilla de la URL suministrada durante el registro del controlador y realzia una petición HTTP GET sobre la URL. Luego, usando los ejemplos anteriores, el navegador realizará una petición GET sobre esta URL: + +``` +http://www.google.co.uk/?uri=burger:cheeseburger +``` + +El código del lado del servidor puede extraer los parámetros de la cadena de petición y realizar la acción deseada. + +> **Nota:** Al código del lado del servidor se le pasa todo el contenido del \`href\`. Esto significa que el código del lado del servidor tendrá que analizar el protocolo desde los datos. + +### Example + +```php + + + + + + Ejemplo de Controlador de Protocolo Web + + +

Ejemplo de Controlador de Protocolo Web - Controlador

+

Esta página es llamada al controlar una acción del protocolo + + + +``` + +## Referencias + +- [http://www.w3.org/TR/2011/WD-html5-20110525/timers.html#custom-handlers](https://www.w3.org/TR/2011/WD-html5-20110525/timers.html#custom-handlers) + +## Véase también + +- `nsIProtocolHandler` (XUL only) +- [RegisterProtocolHandler Mejora de la web federada](https://blog.mozilla.org/webdev/2010/07/26/registerprotocolhandler-enhancing-the-federated-web/) at Mozilla Webdev +- [Registrar un controlador de protocolo personalizado](https://web.dev/registering-a-custom-protocol-handler/) at web.dev. + diff --git a/files/es/web/api/navigator/vibrate/index.html b/files/es/web/api/navigator/vibrate/index.html deleted file mode 100644 index 46f9a4939e7d92..00000000000000 --- a/files/es/web/api/navigator/vibrate/index.html +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: window.navigator.vibrate -slug: Web/API/Navigator/vibrate -translation_of: Web/API/Navigator/vibrate ---- -

- {{ApiRef}}{{SeeCompatTable}}
-

Resumen

-

Ejecuta la vibración por hardware en el dispositivo, si existe dicho hardware. Si el dispositivo no soporta vibración, este método no tendrá efecto. Si un patrón de vibración ya estaba en progreso cuando este método es ejecutado, el patrón anterior se detiene y en su lugar se iniciará el último patrón ejecutado.

-

Sintaxis

-
window.navigator.vibrate(pattern);
-
- -
-
- pattern
-
- Proporciona un patrón de intervalos de vibraciones y pausas. Cada valor indica el número de milisegundos que durará la vibración y la pausa, respectivamente. Se puede porporcionar un valor único (en cuyo caso la vibración se ejecutará una vez, con la duración especificada en milisegundos) o un arreglo de valores (array) para alternar vibraciones y pausas. Ver Vibration API para más detalles.
-
-

Si se especifica el valor 0, un array vacío o un array que contenga todos los valores en 0, se cancelarán todos los patrones de vibración que se estén ejecutando.

-

Excepciones

-

Podrá producirse una excepción si el patrón de vibración especificado es demasiado largo o si cualquiera de sus elementos son demasiado grandes.

-

Compatibilidad con navegadores

-
-{{Compat("api.Navigator.vibrate")}} - -

Especificación

- -

Véase también

- diff --git a/files/es/web/api/navigator/vibrate/index.md b/files/es/web/api/navigator/vibrate/index.md new file mode 100644 index 00000000000000..e13b4b242d4e6f --- /dev/null +++ b/files/es/web/api/navigator/vibrate/index.md @@ -0,0 +1,41 @@ +--- +title: window.navigator.vibrate +slug: Web/API/Navigator/vibrate +translation_of: Web/API/Navigator/vibrate +--- +{{ApiRef}}{{SeeCompatTable}} + +## Resumen + +Ejecuta la vibración por hardware en el dispositivo, si existe dicho hardware. Si el dispositivo no soporta vibración, este método no tendrá efecto. Si un patrón de vibración ya estaba en progreso cuando este método es ejecutado, el patrón anterior se detiene y en su lugar se iniciará el último patrón ejecutado. + +## Sintaxis + +``` +window.navigator.vibrate(pattern); +``` + +- `pattern` proporciona un patrón de intervalos de vibración y pausas, como se describe a continuación. + + + +- pattern + - : Proporciona un patrón de intervalos de vibraciones y pausas. Cada valor indica el número de milisegundos que durará la vibración y la pausa, respectivamente. Se puede porporcionar un valor único (en cuyo caso la vibración se ejecutará una vez, con la duración especificada en milisegundos) o un arreglo de valores (array) para alternar vibraciones y pausas. Ver [Vibration API](/es/docs/WebAPI/Vibration) para más detalles. + +Si se especifica el valor 0, un array vacío o un array que contenga todos los valores en 0, se cancelarán todos los patrones de vibración que se estén ejecutando. + +## Excepciones + +Podrá producirse una excepción si el patrón de vibración especificado es demasiado largo o si cualquiera de sus elementos son demasiado grandes. + +## Compatibilidad con navegadores + +{{Compat("api.Navigator.vibrate")}} + +## Especificación + +- {{spec("http://www.w3.org/TR/vibration/", "Vibration API Specification", "WD")}} + +## Véase también + +- [Vibration API](/es/docs/WebAPI/Vibration)