aboutsummaryrefslogtreecommitdiff
path: root/files/es/web/api/navigator/index.html
blob: 6c38d2ca6b3547d550b46027a04d665d1306b6f2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
---
title: Navigator
slug: Web/API/Navigator
tags:
  - API
  - HTML-DOM
translation_of: Web/API/Navigator
---
<p>{{Apiref}}</p>

<p>La interfaz <code><strong>Navigator</strong></code> representa el estado y la identidad del <em>user agent</em>. Es completamente consultable y es posible registrar scripts para que ejecuten diversas actividades.</p>

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

<h2 id="Propiedades">Propiedades</h2>

<p><em>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")}}.</em></p>

<h3 id="Estándar">Estándar</h3>

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

<h3 id="Methods" name="Methods">No Estándar</h3>

<div class="note">
<p>Dispositivos con Firefox OS añaden más propiedades no estándares. Puede consultarlas en el <a href="/en-US/docs/Mozilla/Firefox_OS/API/Navigator">artículo de extensiones de Navigator de Firefox OS</a>.</p>
</div>

<dl>
 <dt>{{domxref("Navigator.buildID")}} {{non-standard_inline}}</dt>
 <dd>Devuelve el identificador de la compilación del navegador(p.ej., "2006090803").</dd>
 <dt>{{domxref("Navigator.cookieEnabled")}} {{non-standard_inline}}</dt>
 <dd>Devuelve un booleano que indica si el navegador tiene activadas las cookies.</dd>
 <dt>{{domxref("Navigator.credentials")}} {{non-standard_inline}}</dt>
 <dd>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.</dd>
 <dt>{{domxref("Navigator.doNotTrack")}} {{non-standard_inline}}</dt>
 <dd>Reporta el valor de la preferencia <em>do-not-track</em>. Cuando su valor es positivo ("yes", "1"), el sitio o aplicación web no debe rastrear al usuario.</dd>
 <dt>{{domxref("Navigator.id")}} {{non-standard_inline}}</dt>
 <dd>Devuelve el objeto {{domxref("window.navigator.id", "id")}}, el cual se puede usar para añadir soporte a <a href="/es/docs/Mozilla/Persona" title="BrowserID">BrowserID</a> en el sitio web.</dd>
 <dt>{{domxref("Navigator.mediaDevices")}} {{non-standard_inline}}</dt>
 <dd>Devuelve una referencia a la interfaz {{domxref("MediaDevices")}}.</dd>
 <dt>{{domxref("Navigator.mozNotification")}} {{deprecated_inline("22")}} {{non-standard_inline}}<br>
 {{domxref("Navigator.webkitNotification")}}</dt>
 <dd>Devuelve un objeto {{domxref("navigator.mozNotification", "notification")}} que puede ser usado para enviar notificaciones al usuario desde la aplicación web.</dd>
 <dt>{{domxref("Navigator.mozSocial")}} {{non-standard_inline}}</dt>
 <dd>El objeto devuelto por la propiedad <code>navigator.mozSocial</code>, está disponible en el panel de proveedor de medios sociales para proporcionar funcionalidad la que se necesite.</dd>
 <dt>{{domxref("Navigator.presentation")}} {{non-standard_inline}}</dt>
 <dd>Devuelve una referencia a la API {{domxref("Presentation")}}.</dd>
 <dt>{{domxref("Navigator.productSub")}} {{non-standard_inline}}</dt>
 <dd>Devuelve el número de compilación del navegador actual (p.ej., "20060909").</dd>
 <dt>{{domxref("Navigator.securitypolicy")}} {{non-standard_inline}}</dt>
 <dd>Devuelve una cadena de texto vacía. En Netscape 4.7x, devuelve "US &amp; CA domestic policy" o "Export policy".</dd>
 <dt>{{domxref("Navigator.standalone")}} {{non-standard_inline}}</dt>
 <dd>Devuelve un booleano que indica si el navegador está ejecutándose en modo <em>standalone</em>. Disponible sólo para Safari de iOS de Apple.</dd>
 <dt>{{domxref("Navigator.vendor")}} {{non-standard_inline}}</dt>
 <dd>Devuelve el nombre del fabricante del navegador actual (p.ej., "Netscape6").</dd>
 <dt>{{domxref("Navigator.vendorSub")}} {{non-standard_inline}}</dt>
 <dd>Devuelve la versión de fabricante (p.ej. "6.1").</dd>
 <dt>{{domxref("Navigator.webkitPointer")}} {{non-standard_inline}}</dt>
 <dd>Devuelve un objeto PointerLock para la API <a href="https://developer.mozilla.org/en-US/docs/API/Pointer_Lock_API" title="Mouse Lock API">Mouse Lock</a>.</dd>
</dl>

<h2 id="Methods" name="Methods">Métodos</h2>

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

<h3 id="Estándar_2">Estándar</h3>

<dl>
 <dt>{{domxref("Navigator.getVRDisplays()")}} {{experimental_inline}}</dt>
 <dd>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.</dd>
 <dt>{{domxref("Navigator.getUserMedia", "NavigatorUserMedia.getUserMedia()")}}</dt>
 <dd>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.</dd>
 <dt>{{domxref("Navigator.registerContentHandler()")}}</dt>
 <dd>Permite a los web sites registrarse como posibles controladores de un tipo MIME determinado.</dd>
 <dt>{{domxref("Navigator.registerProtocolHandler()")}}</dt>
 <dd>Permite a los sitios webs registrarse como posibles controladores de un protocolo determinado.</dd>
 <dt>{{domxref("Navigator.requestMediaKeySystemAccess()")}} {{experimental_inline}}</dt>
 <dd>Devuelve un objeto {{jsxref("Promise")}} para un objeto MediaKeySystemAccess.</dd>
 <dt>{{domxref("Navigator.sendBeacon()")}}{{experimental_inline}}</dt>
 <dd>Usado para transferir, de forma asíncrona, conjuntos pequeños de datos HTTP del agente usuario al servidor.</dd>
 <dt>{{domxref("NavigatorID.taintEnabled()")}} {{deprecated_inline("1.7.8")}} {{obsolete_inline("9.0")}} {{experimental_inline}}</dt>
 <dd>Devuelve <code>false</code>. Las funciones <code>taint</code>/<code>untaint</code> de JavaScript fueron desaprobadas en JavaScript 1.2.</dd>
 <dt>{{domxref("Navigator.vibrate()")}} {{gecko_minversion_inline("11.0")}}</dt>
 <dd>Causa vibración en el dispositivo que la soporta. No hace nada si el soporte para vibración no está disponible.</dd>
</dl>

<h3 id="Specification" name="Specification">No Estándar</h3>

<div class="note">
<p>Dispositivos con Firefox OS añaden más métodos no estándares. Puede consultarlas en el <a href="/en-US/docs/Mozilla/Firefox_OS/API/Navigator">artículo de extensiones de Navigator de Firefox OS</a>.</p>
</div>

<dl>
 <dt>{{domxref("Navigator.mozIsLocallyAvailable()")}} {{non-standard_inline}}</dt>
 <dd>Permite al código verificar si el documento en una URI determinada está disponible sin usar la red.</dd>
 <dt>{{domxref("Navigator.mozPay()")}} {{non-standard_inline}}</dt>
 <dd>Permite pagos dentro de la aplicación.</dd>
</dl>