Navigator
=========

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 `Window.navigator`.

Propiedades de instancia
------------------------

*No hereda ninguna propiedad.*

### Propiedadedes estandard

`Navigator.connection` (en-US) Read only  
Experimental

Proporciona un objeto `NetworkInformation` (en-US) que contiene información sobre la conexión de red de un dispositivo.

`Navigator.cookieEnabled` (en-US) Read only 

Devuelve *false* si se ignorará la configuración de una *cookie* y *true* en caso contrario.

`Navigator.credentials` (en-US) Read only 

Devuelve la interfaz `CredentialsContainer` (en-US) que expone métodos para solicitar credenciales y notificar al agente de usuario cuando ocurren eventos interesantes, como iniciar o cerrar sesión correctamente.

`Navigator.deviceMemory` (en-US) Read only  
Experimental

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.

`Navigator.geolocation` Read only 

Devuelve un objeto `Geolocalización` que permite acceder a la ubicación del dispositivo.

`Navigator.hid` (en-US) Read only  
Experimental

Devuelve un objeto `HID` (en-US) que proporciona métodos para conectarse a dispositivos HID, listar dispositivos HID conectados y controladores de eventos para dispositivos HID conectados.

`Navigator.hardwareConcurrency` Read only 

Devuelve el número de núcleos de procesador lógico disponibles.

`Navigator.keyboard` (en-US) Read only  
Experimental

Devuelve un objeto `Keyboard` (en-US) 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.

`Navigator.language` Read only 

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.

`Navigator.languages` (en-US) Read only 

Devuelve una matriz de cadenas que representan los idiomas que conoce el usuario, por orden de preferencia.

`Navigator.locks` (en-US) Read only 

Devuelve un objeto `LockManager` (en-US) que proporciona métodos para solicitar un nuevo objeto `Lock` (en-US) y consultar un objeto `Lock` (en-US) existente.

`Navigator.maxTouchPoints` (en-US) Read only 

Devuelve el número máximo de puntos de contacto táctiles simultáneos admitidos por el dispositivo actual.

`Navigator.mediaCapabilities` (en-US) Read only 

Devuelve un objeto `MediaCapabilities` (en-US) que puede exponer información sobre las capacidades de decodificación y codificación para un formato y capacidades de salida determinados.

`Navigator.mediaDevices` (en-US) Read only 

Devuelve una referencia a un objeto `MediaDevices` que luego se puede usar para obtener información sobre los dispositivos de medios disponibles (`MediaDevices.enumerateDevices()` (en-US)), averiguar qué propiedades restringibles son compatibles con los medios en la computadora del usuario y el agente de usuario (`MediaDevices.getSupportedConstraints()` (en-US)) y para solicitar acceso a los medios usando `MediaDevices.getUserMedia()`.

`Navigator.mediaSession` (en-US) Read only 

Devuelve el objeto `MediaSession` (en-US) 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.

`Navigator.onLine` Read only 

Devuelve un valor booleano que indica si el navegador está funcionando en línea.

`Navigator.pdfViewerEnabled` (en-US) Read only 

Devuelve "verdadero" si el navegador puede mostrar archivos PDF en línea cuando se navega hacia ellos, y "falso" en caso contrario.

`Navigator.permissions` (en-US) Read only 

Devuelve un objeto `Permisos` que se puede usar para consultar y actualizar el estado de los permisos de las API cubiertas por la API de permisos (en-US).

`Navigator.presentation` (en-US) Read only 

Devuelve una referencia a la API `Presentation` (en-US).

`Navigator.serial` (en-US) Read only  
Experimental

Devuelve un objeto `Serial` (en-US), que representa el punto de entrada a `Web Serial API` (en-US) para habilitar el control de los puertos serie.

`Navigator.serviceWorker` (en-US) Read only 

Devuelve un objeto `ServiceWorkerContainer`, que proporciona acceso al registro, eliminación, actualización y comunicación con los objetos `ServiceWorker` (en-US) para el documento asociado.

`Navigator.storage` (en-US) Read only 

Devuelve el objeto singleton `StorageManager` que se usa para administrar los permisos de persistencia y estimar el almacenamiento disponible sitio por sitio y aplicación por aplicación.

`Navigator.userActivation` (en-US) Read only  
Experimental

Devuelve un objeto `UserActivation` (en-US) que contiene información sobre el estado de activación del usuario de la ventana actual.

`Navigator.userAgent` (en-US) Read only 

Devuelve la cadena de agente de usuario para el navegador actual.

`Navigator.userAgentData` (en-US) Read only  
Experimental

Devuelve un objeto `NavigatorUAData` (en-US), que da acceso a información sobre el navegador y el sistema operativo del usuario.

`Navigator.webdriver` (en-US) Read only 

Indica si el agente de usuario está controlado por automatización.

`Navigator.windowControlsOverlay` (en-US) Read only 

Devuelve la interfaz `WindowControlsOverlay` (en-US) 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.

`Navigator.xr` (en-US) Read only  
Experimental

Devuelve el objeto `XRSystem` (en-US), que representa el punto de entrada a WebXR API (en-US).

### Propiedades no estandares

`Navigator.buildID` (en-US) 
Non-standard

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.

`Navigator.contacts` (en-US) Read only  
Experimental

Devuelve una interfaz `ContactsManager` (en-US) 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.

`Navigator.globalPrivacyControl` (en-US) 
Non-standard

Experimental

Devuelve un valor booleano que indica el consentimiento de un usuario para que su información sea compartida o vendida.

`Navigator.securitypolicy` 
Non-standard

Devuelve una cadena vacía. En Netscape 4.7x, devuelve "Política nacional de EE. UU. y CA" o "Política de exportación".

`Navigator.standalone` 
Non-standard

Devuelve un valor booleano que indica si el navegador se está ejecutando en modo independiente. Disponible solo en iOS Safari de Apple.

`Navigator.wakeLock` (en-US) Read only  
Experimental

Devuelve una interfaz `WakeLock` (en-US) 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 obsoletas

`Navigator.appCodeName` (en-US) Read only  
Obsoleto

Siempre devuelve `'Mozilla'`, en cualquier navegador.

`Navigator.appName` (en-US) Read only  
Obsoleto

Siempre devuelve `'Netscape'`, en cualquier navegador.

`Navigator.appVersion` (en-US) Read only  
Obsoleto

Devuelve la versión del navegador como una cadena. No confíe en esta propiedad para devolver el valor correcto.

`Navigator.activeVRDisplays` (en-US) Read only  
Obsoleto

Non-standard

Devuelve una matriz que contiene cada objeto `VRDisplay` (en-US) que se está presentando actualmente (`VRDisplay.ispresenting` (en-US) es `true`).

`Navigator.doNotTrack` Read only  
Obsoleto

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.

`Navigator.mimeTypes` (en-US) Read only  
Obsoleto

Devuelve un `MimeTypeArray` (en-US) que enumera los tipos MIME admitidos por el navegador.

`Navigator.oscpu` (en-US) Read only  
Obsoleto

Devuelve una cadena que representa el sistema operativo actual.

`Navigator.platform` (en-US) Read only  
Obsoleto

Devuelve una cadena que representa la plataforma del navegador. No confíe en esta función para devolver un valor significativo.

`Navigator.plugins` (en-US) Read only  
Obsoleto

Devuelve un `PluginArray` (en-US) que enumera los complementos instalados en el navegador.

`Navigator.product` (en-US) Read only  
Obsoleto

Siempre devuelve `'Gecko'`, en cualquier navegador.

`Navigator.productSub` (en-US) Read only  
Obsoleto

Devuelve la cadena `'20030107'`, o `'"20100101'`.

`Navigator.vendor` (en-US) Read only  
Obsoleto

Devuelve la cadena vacía, `'Apple Computer Inc.'` o `'Google Inc.'`.

`Navigator.vendorSub` (en-US) Read only  
Obsoleto

Siempre devuelve la cadena vacía.

Metodos de instancia
--------------------

*No hereda ningun metodo.*

`Navigator.canShare()` (en-US)

Devuelve `verdadero` si una llamada a `Navigator.share()` tiene éxito.

`Navigator.clearAppBadge()` (en-US) 
Experimental

Borra una insignia en el ícono de la aplicación actual y devuelve un `Promise` que se resuelve con `undefined`.

`Navigator.getBattery()`

Devuelve una promesa que se resuelve con un objeto `BatteryManager` que devuelve información sobre el estado de carga de la batería.

`Navigator.registerProtocolHandler()`

Permite que los sitios web se registren como un posible controlador para un protocolo determinado.

`Navigator.requestMediaKeySystemAccess()` (en-US)

Devuelve un `Promise` para un objeto `MediaKeySystemAccess`.

`Navigator.requestMIDIAccess()` (en-US)

Devuelve un `Promise` que representa una solicitud de acceso a dispositivos MIDI en el sistema del usuario.

`Navigator.sendBeacon()` (en-US)

Se utiliza para transferir de forma asíncrona una pequeña cantidad de datos mediante HTTP desde el agente de usuario a un servidor web.

`Navigator.setAppBadge()` (en-US) 
Experimental

Establece una insignia en el ícono asociado con esta aplicación y devuelve un `Promise` que se resuelve con `undefined`.

`Navigator.share()` (en-US)

Invoca el mecanismo de uso compartido nativo de la plataforma actual.

`Navigator.vibrate()`

Provoca vibración en dispositivos compatibles. No hace nada si el soporte de vibración no está disponible.

### Metodos obsoletos

`Navigator.getVRDisplays()` (en-US) 
Obsoleto

Non-standard

Devuelve una promesa que se resuelve en una matriz de `VRDisplay` (en-US) objetos que representan cualquier dispositivo VR disponible conectado a la computadora.

`Navigator.getUserMedia()` 
Obsoleto

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.

`Navigator.taintEnabled()` (en-US) 
Obsoleto

Devuelve `falso`. Las funciones de corrupción/no corrupción de JavaScript se eliminaron en JavaScript 1.2.

`Navigator.javaEnabled()` (en-US) 
Obsoleto

Siempre devuelve falso.

Especificaciones
----------------

| Specification |
| --- |
| HTML Standard # the-navigator-object |

Compatibilidad con navegadores
------------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.