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
No hereda ninguna propiedad, pero implementa las definidas en NavigatorID
(en-US), NavigatorLanguage
, NavigatorOnLine
, NavigatorContentUtils
, NavigatorStorageUtils
, NavigatorCookies
, NavigatorConcurrentHardware
, NavigatorPlugins
(en-US), y NavigatorUserMedia
.
Estándar
Navigator.activeVRDisplays
(en-US) Read only- Devuelve un arreglo que contiene cada objeto
VRDisplay
(en-US) que está siendo presentado en el momento (VRDisplay.ispresenting
(en-US) estrue
). NavigatorID.appCodeName
(en-US) Read only- Devuelve el nombre código interno del navegador actual. No confie en que esta propiedad devuelva siempre el valor correcto.
NavigatorID.appName
(en-US) Read only- Devuelve un
DOMString
con el nombre oficial del navegador. No confie en que esta propiedad devuelva siempre el valor correcto. NavigatorID.appVersion
(en-US) Read only- Devuelve la versión del navegador como un
DOMString
. No confie en que esta propiedad devuelva siempre el valor correcto. Navigator.battery
(en-US) Read only- Devuelve un objeto de tipo
BatteryManager
que puede utilizar para obtener la información del estado de carga de la batería. NetworkInformation.connection
(en-US) Read only- Provee un objeto
NetworkInformation
(en-US) con la información sobre la conexión a la red de un dispositivo. NavigatorGeolocation.geolocation
Read only- Devuelve un objeto
Geolocation
que permite el acceso a la ubicación del dispositivo. NavigatorConcurrentHardware.hardwareConcurrency
Read only- Devuelve el número de núcleos de procesador lógicos disponibles.
NavigatorPlugins.javaEnabled
(en-US) Read only- Devuelve un valor
Boolean
(en-US) que indica si el navegador tiene o no habilitado Java. NavigatorLanguage.language
Read only- Devuelve un valor
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 valornull
. NavigatorLanguage.languages
(en-US) Read only- Devuelve un arreglo de
DOMString
que representan los idiomas conocidos por el usuario, en orden de preferencia. NavigatorPlugins.mimeTypes
(en-US) Read only- Devieñve im
MimeTypeArray
(en-US) que enlista los tipos MIME soportados por el navegador. NavigatorOnLine.onLine
Read only- Devuelve un valor
Boolean
(en-US) que indica si el navegador está trabajando en línea. Navigator.oscpu
(en-US)- Devuelve una cadena de texto que representa al sistema operativo actual.
Navigator.permissions
(en-US) Read only- ;
- Devuelve un objeto
Permissions
(en-US) que puede ser usado para consultar y actualizar estatus de permisos de las APIs, acorde a la API Permissions. NavigatorID.platform
(en-US) Read only- Devuelve una cadena de texto que representa la plataforma del navegador. No confíe en que esta función devuelva un valor significativo.
NavigatorPlugins.plugins
(en-US) Read only- Devuelve un
PluginArray
(en-US) que enlista los plugins instalados en el navegador. NavigatorID.product
(en-US) Read only- Siempre devuelve
'Gecko'
, en cualquier navegador. Esta propiedad es mantenido únicamente por razones de compatibilidad. NavigatorID.userAgent
(en-US) Read only- Devuelve la cadena de agente usuario del navegador actual.
Navigator.serviceWorker
(en-US) Read only- Devuelve un objeto
ServiceWorkerContainer
, el cual provee acceso a registro, eliminación, actualización y comunicación con los objetosServiceWorker
(en-US) 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.
Navigator.buildID
(en-US)- Devuelve el identificador de la compilación del navegador(p.ej., "2006090803").
Navigator.cookieEnabled
(en-US)- Devuelve un booleano que indica si el navegador tiene activadas las cookies.
Navigator.credentials
(en-US)- Devuelve la interfaz
CredentialsContainer
(en-US), 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. Navigator.doNotTrack
- 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.
Navigator.id
- Devuelve el objeto
id
, el cual se puede usar para añadir soporte a BrowserID en el sitio web. Navigator.mediaDevices
- Devuelve una referencia a la interfaz
MediaDevices
. Navigator.mozNotification
Desaprobado Gecko 22
Navigator.webkitNotification
- Devuelve un objeto
notification
que puede ser usado para enviar notificaciones al usuario desde la aplicación web. Navigator.mozSocial
- 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. Navigator.presentation
(en-US)- Devuelve una referencia a la API
Presentation
(en-US). Navigator.productSub
(en-US)- Devuelve el número de compilación del navegador actual (p.ej., "20060909").
Navigator.securitypolicy
- Devuelve una cadena de texto vacía. En Netscape 4.7x, devuelve "US & CA domestic policy" o "Export policy".
Navigator.standalone
- Devuelve un booleano que indica si el navegador está ejecutándose en modo standalone. Disponible sólo para Safari de iOS de Apple.
Navigator.vendor
(en-US)- Devuelve el nombre del fabricante del navegador actual (p.ej., "Netscape6").
Navigator.vendorSub
(en-US)- Devuelve la versión de fabricante (p.ej. "6.1").
Navigator.webkitPointer
- Devuelve un objeto PointerLock para la API Mouse Lock.
Métodos
No hereda ninguna propiedad, pero implementa las definidas en NavigatorID
(en-US), NavigatorContentUtils
, NavigatorUserMedia
, y NavigatorStorageUtils
.
Estándar
Navigator.getVRDisplays()
(en-US)- Devuelve una promesa que se resuelve en un arreglo de objetos
VRDisplay
(en-US) que representan cualquier dispositivo VR conectado a la computadora que esté disponible. 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.
Navigator.registerContentHandler()
(en-US)- Permite a los web sites registrarse como posibles controladores de un tipo MIME determinado.
Navigator.registerProtocolHandler()
- Permite a los sitios webs registrarse como posibles controladores de un protocolo determinado.
Navigator.requestMediaKeySystemAccess()
(en-US)- Devuelve un objeto
Promise
para un objeto MediaKeySystemAccess. Navigator.sendBeacon()
(en-US)- Usado para transferir, de forma asíncrona, conjuntos pequeños de datos HTTP del agente usuario al servidor.
NavigatorID.taintEnabled()
(en-US) Desaprobado Gecko 1.7.8 Obsoleto Gecko 9.0- Devuelve
false
. Las funcionestaint
/untaint
de JavaScript fueron desaprobadas en JavaScript 1.2. Navigator.vibrate()
- 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.
Navigator.mozIsLocallyAvailable()
(en-US)- Permite al código verificar si el documento en una URI determinada está disponible sin usar la red.
Navigator.mozPay()
- Permite pagos dentro de la aplicación.