镜像下载、域名解析、时间同步请点击 阿里巴巴开源镜像站
一、安装
在 npm 仓库中安装 alife-logger。
npm install alife-logger --save二、使用
1. 初始化
SDK 以 BrowerLogger.singleton 方式初始化。
const BrowerLogger = require('alife-logger');
// BrowserLogger.singleton(conf) conf传入config配置
const __bl = BrowerLogger.singleton({
pid: 'your-project-id',
imgUrl: 'https://arms-retcode.aliyuncs.com/r.png?', // 设定日志上传地址，新加坡部署可选`https://arms-retcode-sg.aliyuncs.com/r.png?`
// 其他config配置
});使用 npm 方式接入 ARMS 前端监控时，Web 端 SDK 会自动生成 UID 来统计 UV 等信息。自动生成的 UID 可以用来区分用户的标识，但不具有业务属性，若您想自定义 UID，请在上述代码中加入以下内容：
uid: 'xxx', // 该值用于区分用户的标识，根据业务设置例如：
const BrowserLogger = require('alife-logger');
// BrowserLogger.singleton(conf) conf传入config配置
const __bl = BrowserLogger.singleton({
pid: 'your-project-id',
uid: 'xxx', // 该值用于区分用户的标识，根据业务设置
imgUrl: 'https://arms-retcode.aliyuncs.com/r.png?', // 设定日志上传地址，新加坡部署可选`https://arms-retcode-sg.aliyuncs.com/r.png?`
// 其他config配置
});2. API 说明
@static singleton() 获取单例对象
说明 该方法只适用于 npm 引入。
调用参数说明：BrowerLogger.singleton(config,prePipe)
静态方法，返回一个单例对象，传入的 config、prePipe 只在第一次调用时生效，此后调用只返回已经生成的实例。
| 参数 | 类型 | 描述 | 是否必须 | 默认值 |
|---|---|---|---|---|
| config | Object | 站点配置，其他配置查看 #config 配置项 | 是 | - |
| prePipe | Array | 预上报内容 | 否 | - |
此方法可以用于在应用入口初始化 SDK，也可以在每次调用时获取实例。
3. 其他上报 API
通过 BrowerLogger.singleton 获取实例。
const __bl = BrowerLogger.singleton();关于 __bl 的其他 API 使用方式，请参考 API 使用指南。
4. Config 配置
Config 配置与 CDN 引入配置相同。请参考 前端监控 SDK 配置项。
5. 预上报
场景：在调用 BrowserLogger.singleton() 之前执行的部分逻辑需要上报一些数据。
const BrowerLogger = require('alife-logger');
// 与 CDN 的 Pipe 结构一致
const pipe = [
// 将当前页面的 HTML 也作为一个 API 上报
['api', '/index.html', true, performance.now, 'SUCCESS'],
// SDK 初始化完成后即开启 SPA 自动解析
['setConfig', {enableSPA: true}]
];
const __bl = BrowserLogger.singleton({pid:'站点唯一ID'},pipe);“ 阿里巴巴开源镜像站 提供全面，高效和稳定的系统镜像、应用软件下载、域名解析和时间同步服务。”
