ua-format-js

重复造轮子，一个userAgent解析器UAFormat.js(参考UAParser.js)

Another wheel，an userAgent parser UAFormat.js (refer to the UAParser.js)

致力于更符合**特色的浏览器userAgent字符串识别与探测！欢迎添砖加瓦

作者 : jeeinn [email protected]
源代码 : https://github.com/jeeinn/ua-format-js
许可 : MIT
声明：本项目仅作为研究ua识别学习，如有侵权请Email。
演示地址 : http://faisalman.github.io/ua-parser-js(暂时厚颜无耻的使用UAParser.js的)

方法

setUA()
getUA()
getOS()
getBrowser()
getDevice()
getEngine()
getResult()
~~getCPU()~~

注解

调用getOS()、getBrowser()、getEngine() 返回 { name:'', version:'' }

调用getDevice() 返回 { type:'', model:'', vendor:'' }

'device.type'可能值，支持自定义: desktop、mobile、tablet、smarttv、wearable、embedded、console
'device.vendor'可能值，支持自定义: Meizu、Samsung、Lenovo、Acer、Alcatel、Amazon、HP、 HTC、Huawei、Jolla、LG、Microsoft、Motorola、Nexian、 Apple、Nintendo、Nokia、Nvidia、Ouya、Palm、Panasonic、 Archos、Asus、BenQ、BlackBerry、Dell、GeeksPhone、Google、 Polytron、RIM、Sharp、Siemens、Sony-Ericsson、Sprint、Xbox、 ZTE
'device.model' 动态解析，支持自定义

规则

在src/ua-format.js的uaRules对象中添加相应的解析规则

如getOS方法中的os的相应信息，在osRules中添加如下一个规则对象

{
  patterns:[/microsoft\s(windows)\s(vista|xp)/i],                  // Windows (iTunes)
  defaults:[[NAME,'Windows'],[VERSION]]
}

patterns是正则表达式数组（允许多个）
defaults是默认值数组（二维表示自定义值，自定义值优先使用）

例子

HTML引入示例

<!doctype html>
<html>
<head>
<script type="text/javascript" src="ua-format.min.js"></script>
<script type="text/javascript">

	var formater = new UAFormat();

    // 默认使用当前浏览器: window.navigator.userAgent
    console.log(formater.getResult());
    /*
    /// 输出结果:
    {
        ua: "",
        browser: {
            name: "",
            version: ""
        },
        engine: {
            name: "",
            version: ""
        },
        os: {
            name: "",
            version: ""
        },
        device: {
            model: "",
            type: "",
            vendor: ""
        }
    }
    */

    // 自定义ua
    var uaString = "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/535.2 (KHTML, like Gecko) Ubuntu/11.10 Chromium/15.0.874.106 Chrome/15.0.874.106 Safari/535.2";
    formater.setUA(uaString);

    var result = formater.getResult();

    console.log(result.browser);        // {name: "Chromium", version: "15.0.874.106"}
    console.log(result.device);         // {model: "", type: "", vendor: ""}
    console.log(result.os);             // {name: "Ubuntu", version: "11.10"}
    console.log(result.os.version);     // "11.10"
    console.log(result.engine.name);    // "WebKit"

    var uaString2 = 'Mozilla/5.0 (PlayBook; U; RIM Tablet OS 1.0.0; en-US) AppleWebKit/534.11 (KHTML, like Gecko) Version/7.1.0.7 Safari/534.11';
    //链式调用
    console.log(formater.setUA(uaString2).getDevice().model); // "PlayBook"
    console.log(formater.getOS());                            // {name: "RIM Tablet OS", version: "1.0.0"}
    console.log(formater.getBrowser().name);                  // "Safari"

</script>
</head>
<body>
</body>
</html>

node使用

npm install ua-format-js --save

js文件示例

var formater = require('ua-format-js').UAFormat();
var uaString = 'Mozilla/5.0 (Linux; U; Android 6.0.1; zh-cn; ONE A2001 Build/MMB29M) AppleWebKit/537.36 (KHTML, like Gecko)Version/4.0 Chrome/37.0.0.0 MQQBrowser/6.0 Mobile Safari/537.36';

formater.setUA(uaString);
console.log(formater.getResult());

// result
// {
//     ua: 'Mozilla/5.0(Linux;U;Android6.0.1;zh-cn;ONEA2001Build/MMB29M)AppleWebKit/537.36(KHTML,likeGecko)Version/4.0Chrome/37.0.0.0MQQBrowser/6.0MobileSafari/537.36',
//     os: {
//         name: 'Android',
//         version: '6.0.1'
//     },
//     browser: {
//         name: 'QQBrowser',
//         version: '6.0'
//     },
//     device: {
//         model: 'ONEA2001',
//         vendor: 'OnePlus',
//         type: 'mobile'
//     },
//     engine: {
//         name: 'WebKit',
//         version: '537.36'
//     }
// }

更新

v0.0.3 -2018/9/17
1. 添加一些常见浏览器qq、2345、line、MiPlus...
2. 修改几处变量命名
3. 归类正则减少初始化Object
4. 开发模式依赖插件因安全问题升级
v0.0.2 -2017/3/10
1. 修复一个bug
2. 兼容nodejs使用
3. 增加小米、红米、魅族、努比亚、vivo、oppo、1+、乐视、金立手机识别
4. 增加百度浏览器baiduboxapp识别
5. 调整部分注释
6. 该版本以后，如果只增加正则识别则只更新版本号尾数如0.0.xx，功能性增加则中间位数依次迭代
v0.0.1 - 2017/3/8
1. 实现同原理的UAParser.js
2. 复制UAParser.js的所有正则内容
3. 无结果时默认为unknown

jeeinn / ua-format-js Goto Github PK

ua-format-js's Introduction

ua-format-js

方法

注解

规则

例子

更新

To Do

鸣谢

打赏

ua-format-js's People

Contributors

Stargazers

Watchers

Forkers

Recommend Projects

React

Vue.js

Typescript

TensorFlow

Django

Laravel

D3

Recommend Topics

javascript

web

server

Machine learning

Visualization

Game

Recommend Org

Facebook

Microsoft

Google

Alibaba

D3

Tencent