From 0be7204ab4d6a1cfa67953f706f4a3e7b1db09ca Mon Sep 17 00:00:00 2001
From: ruanyf <yifeng.ruan@gmail.com>
Date: Tue, 22 May 2018 14:25:39 +0800
Subject: [PATCH] docs(bom): add navigator

---
 chapters.yml          |   1 +
 docs/bom/navigator.md | 130 ++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 131 insertions(+)
 create mode 100644 docs/bom/navigator.md

diff --git a/chapters.yml b/chapters.yml
index ec2d093..a3887d1 100644
--- a/chapters.yml
+++ b/chapters.yml
@@ -68,6 +68,7 @@
 - events/globaleventhandlers.md: GlobalEventHandlers 接口
 - bom/: 浏览器模型
 - bom/engine.md: 浏览器模型概述
+- bom/navigator.md: Navigator 对象
 - bom/cookie.md: Cookie
 - bom/same-origin.md: 同源限制
 - bom/location.md: Location 对象，URL 对象，URLSearchParams 对象
diff --git a/docs/bom/navigator.md b/docs/bom/navigator.md
new file mode 100644
index 0000000..6deea8c
--- /dev/null
+++ b/docs/bom/navigator.md
@@ -0,0 +1,130 @@
+# Navigator 对象
+
+`window.navigator`属性指向一个包含浏览器和系统信息的 Navigator 对象。脚本通过这个属性了解用户的环境信息。
+
+## 属性
+
+### Navigator.userAgent
+
+`navigator.userAgent`属性返回浏览器的 User Agent 字符串，表示浏览器的厂商和版本信息。
+
+下面是 Chrome 浏览器的`userAgent`。
+
+```javascript
+navigator.userAgent
+// "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/29.0.1547.57 Safari/537.36"
+```
+
+通过`userAgent`属性识别浏览器，不是一个好办法。因为必须考虑所有的情况（不同的浏览器，不同的版本），非常麻烦，而且用户可以改变这个字符串。这个字符串的格式并无统一规定，也无法保证未来的适用性，各种上网设备层出不穷，难以穷尽。所以，现在一般不再通过它识别浏览器了，而是使用“功能识别”方法，即逐一测试当前浏览器是否支持要用到的 JavaScript 功能。
+
+不过，通过`userAgent`可以大致准确地识别手机浏览器，方法就是测试是否包含`mobi`字符串。
+
+```javascript
+var ua = navigator.userAgent.toLowerCase();
+
+if (/mobi/i.test(ua)) {
+  // 手机浏览器
+} else {
+  // 非手机浏览器
+}
+```
+
+如果想要识别所有移动设备的浏览器，可以测试更多的特征字符串。
+
+```javascript
+/mobi|android|touch|mini/i.test(ua)
+```
+
+### Navigator.plugins
+
+`Navigator.plugins`属性返回一个类似数组的对象，成员是 Plugin 实例对象，表示浏览器安装的插件，比如 Flash、ActiveX 等。
+
+```javascript
+var pluginsLength = navigator.plugins.length;
+
+for (var i = 0; i < pluginsLength; i++) {
+  console.log(navigator.plugins[i].name);
+  console.log(navigator.plugins[i].filename);
+  console.log(navigator.plugins[i].description);
+  console.log(navigator.plugins[i].version);
+}
+```
+
+### Navigator.platform
+
+`Navigator.platform`属性返回用户的操作系统信息，比如`MacIntel`、`Win32`、`Linux x86_64`等 。
+
+```javascript
+navigator.platform
+// "Linux x86_64"
+```
+
+### Navigator.onLine
+
+`navigator.onLine`属性返回一个布尔值，表示用户当前在线还是离线（浏览器断线）。
+
+```javascript
+navigator.onLine // true
+```
+
+有时，浏览器可以连接局域网，但是局域网不能连通外网。这时，有的浏览器的`onLine`属性会返回`true`，所以不能假定只要是`true`，用户就一定能访问互联网。不过，如果是`false`，可以断定用户一定离线。
+
+用户变成在线会触发`online`事件，变成离线会触发`offline`事件，可以通过`window.ononline`和`window.onoffline`指定这两个事件的回调函数。
+
+```javascript
+window.addEventListener('offline', function(e) { console.log('offline'); });
+window.addEventListener('online', function(e) { console.log('online'); });
+```
+
+### Navigator.language，Navigator.languages
+
+`Navigator.language`属性返回一个字符串，表示浏览器的首选语言。该属性只读。
+
+```javascript
+navigator.language // "en"
+```
+
+`Navigator.languages`属性返回一个数组，表示用户可以接受的语言。`Navigator.language`总是这个数组的第一个成员。HTTP 请求头信息的`Accept-Language`字段，就来自这个数组。
+
+```javascript
+navigator.languages  // ["en-US", "en", "zh-CN", "zh", "zh-TW"]
+```
+
+如果这个属性发生变化，就会在`window`对象上触发`languagechange`事件。
+
+### Navigator.geolocation
+
+`Navigator.geolocation`属性返回一个 Geolocation 对象，包含用户地理位置的信息。注意，该 API 只有在 HTTPS 协议下可用，否则调用下面方法时会报错。
+
+Geolocation 对象提供下面三个方法。
+
+- Geolocation.getCurrentPosition()：得到用户的当前位置
+- Geolocation.watchPosition()：监听用户位置变化
+- Geolocation.clearWatch()：取消`watchPosition()`方法指定的监听函数
+
+注意，调用这三个方法时，浏览器会跳出一个对话框，要求用户给予授权。
+
+### Navigator.cookieEnabled
+
+`Navigator.cookieEnabled`属性返回一个布尔值，表示浏览器的 Cookie 功能是否打开。
+
+```javascript
+navigator.cookieEnabled // true
+```
+
+注意，这个属性反映的是浏览器总的特性，与是否储存某个具体的网站的 Cookie 无关。用户可以设置某个网站不得储存 Cookie，这时`cookieEnabled`返回的还是`true`。
+
+## 方法
+
+### Navigator.javaEnabled()
+
+`Navigator.javaEnabled()`方法返回一个布尔值，表示浏览器是否能运行 Java Applet 小程序。
+
+```javascript
+navigator.javaEnabled() // false
+```
+
+### Navigator.sendBeacon()
+
+`Navigator.sendBeacon()`方法用于向服务器异步发送数据，详见《XMLHttpRequest 对象》一章。
+