{"_id":"@blueking/bk-trace-core","_rev":"7-09d791bcf2b90dfd35e3aa46a4cd9325","name":"@blueking/bk-trace-core","dist-tags":{"latest":"0.0.6"},"versions":{"0.0.1":{"name":"@blueking/bk-trace-core","version":"0.0.1","author":{"name":"Tencent BlueKing"},"license":"ISC","_id":"@blueking/bk-trace-core@0.0.1","maintainers":[{"name":"blueking","email":"contactus_bk@tencent.com"}],"dist":{"shasum":"f0e3ec802d3a9c6051c31519c4046af2542088fe","tarball":"https://registry.npmjs.org/@blueking/bk-trace-core/-/bk-trace-core-0.0.1.tgz","fileCount":9,"integrity":"sha512-is88n7nJlebmxWnifYYpY1uNoUAp3DdZcpWqgyHlOLzkVtb3RwzZ2N+NzVOqR5UUuh9vMAb1k+bdLoeHsBVD3w==","signatures":[{"sig":"MEUCIQCH8k8180AU6X5vCKnfKxYakQICt8fe7rhu2m/omiKGsgIgb56PZrH9VT6V6OEqU1y0jcsohj183iDx5FXuosnRxws=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1608203},"main":"dist/index.js","type":"module","_from":"file:blueking-bk-trace-core-0.0.1.tgz","module":"dist/index.esm.js","_npmUser":{"name":"blueking","email":"contactus_bk@tencent.com"},"_resolved":"/private/var/folders/m_/ynyzlr8x2qn_dx_kyc_d_yv80000gn/T/59957990b425295f62abb7a3719a5970/blueking-bk-trace-core-0.0.1.tgz","_integrity":"sha512-is88n7nJlebmxWnifYYpY1uNoUAp3DdZcpWqgyHlOLzkVtb3RwzZ2N+NzVOqR5UUuh9vMAb1k+bdLoeHsBVD3w==","_npmVersion":"10.8.2","directories":{},"_nodeVersion":"20.18.1","dependencies":{"dayjs":"^1.11.12","@blueking/bk-trace-types":"0.0.1","@blueking/bk-trace-utils":"0.0.1","@blueking/bk-trace-common":"0.0.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/bk-trace-core_0.0.1_1739266184167_0.17449032470214254","host":"s3://npm-registry-packages-npm-production"}},"0.0.2":{"name":"@blueking/bk-trace-core","version":"0.0.2","author":{"name":"Tencent BlueKing"},"license":"ISC","_id":"@blueking/bk-trace-core@0.0.2","maintainers":[{"name":"blueking","email":"contactus_bk@tencent.com"}],"dist":{"shasum":"5eaf997ee565a9d66c537c86b9257405f42fc556","tarball":"https://registry.npmjs.org/@blueking/bk-trace-core/-/bk-trace-core-0.0.2.tgz","fileCount":10,"integrity":"sha512-UoTEVKl6skTtNPXEBZ+AY4pa9aEW1N1KZAKHj7Mo45QRQ/Ub5GUYSUy7IiM52lPygplLZAHfgI0u8csLN8ePXQ==","signatures":[{"sig":"MEYCIQCvdf+7CEN+V1IxOGRoaYYxCsofhZ6fQMbz1VvfzywkLwIhAIiTvGWTqG1KvGP4eaz/fyzjIVizitgeTW5/h2oH/AMr","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1615866},"main":"dist/index.js","type":"module","_from":"file:blueking-bk-trace-core-0.0.2.tgz","module":"dist/index.esm.js","_npmUser":{"name":"blueking","email":"contactus_bk@tencent.com"},"_resolved":"/private/var/folders/m_/ynyzlr8x2qn_dx_kyc_d_yv80000gn/T/000bad3f148eab39cda4b8f13f7ee136/blueking-bk-trace-core-0.0.2.tgz","_integrity":"sha512-UoTEVKl6skTtNPXEBZ+AY4pa9aEW1N1KZAKHj7Mo45QRQ/Ub5GUYSUy7IiM52lPygplLZAHfgI0u8csLN8ePXQ==","_npmVersion":"10.8.2","description":"用于上报前端事件上报，统计界面PV和UV这些","directories":{},"_nodeVersion":"20.18.1","dependencies":{"dayjs":"^1.11.12","@blueking/bk-trace-types":"0.0.2","@blueking/bk-trace-utils":"0.0.2","@blueking/bk-trace-common":"0.0.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/bk-trace-core_0.0.2_1742299146175_0.7365947599195051","host":"s3://npm-registry-packages-npm-production"}},"0.0.3":{"name":"@blueking/bk-trace-core","version":"0.0.3","author":{"name":"Tencent BlueKing"},"license":"ISC","_id":"@blueking/bk-trace-core@0.0.3","maintainers":[{"name":"blueking","email":"contactus_bk@tencent.com"}],"dist":{"shasum":"73c21f5bed30f85a94738045888574cec2d11a8d","tarball":"https://registry.npmjs.org/@blueking/bk-trace-core/-/bk-trace-core-0.0.3.tgz","fileCount":11,"integrity":"sha512-nAbM4wux1CCTdeY5wETKvPalEc/xo153Zz5b4YG782nXbOzV8Z8rwLyRH+pWgjowZHvqEUwMBfdpLS13uj2kmg==","signatures":[{"sig":"MEQCIF+CNhcjFQ31Kh3X7vjxvUNTnxu/2szujL+DAs3TyMiNAiBDm47psO63OaGbkhbLCYx4etMZpEfP7BKXnXIQlswC6g==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1618317},"main":"dist/index.js","type":"module","_from":"file:blueking-bk-trace-core-0.0.3.tgz","module":"dist/index.esm.js","_npmUser":{"name":"blueking","email":"contactus_bk@tencent.com"},"_resolved":"/private/var/folders/75/cc9h8dln1hb6gx2x51p79q780000gn/T/46598d9f64ff664503b73d4be1b640c8/blueking-bk-trace-core-0.0.3.tgz","_integrity":"sha512-nAbM4wux1CCTdeY5wETKvPalEc/xo153Zz5b4YG782nXbOzV8Z8rwLyRH+pWgjowZHvqEUwMBfdpLS13uj2kmg==","_npmVersion":"10.8.2","description":"用于上报前端事件上报，统计界面PV和UV这些","directories":{},"_nodeVersion":"20.19.0","dependencies":{"dayjs":"^1.11.12","@blueking/bk-trace-types":"0.0.3","@blueking/bk-trace-utils":"0.0.3","@blueking/bk-trace-common":"0.0.3"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/bk-trace-core_0.0.3_1748229964775_0.048140766418888425","host":"s3://npm-registry-packages-npm-production"}},"0.0.4":{"name":"@blueking/bk-trace-core","version":"0.0.4","author":{"name":"Tencent BlueKing"},"license":"ISC","_id":"@blueking/bk-trace-core@0.0.4","maintainers":[{"name":"blueking","email":"contactus_bk@tencent.com"}],"dist":{"shasum":"d08d8c57d0048e19519215f2d4312d3fdabb00d2","tarball":"https://registry.npmjs.org/@blueking/bk-trace-core/-/bk-trace-core-0.0.4.tgz","fileCount":11,"integrity":"sha512-Mjc0qx2x4eYuHQYGlLqHTdt4ITuv7RDw8mi/JxhZ1JH0uNkkyitgB8BaZmOnRkuzqIimXt8/Yne8DIvhcSxKnw==","signatures":[{"sig":"MEYCIQD3qS7fhT+yo4WPHS6IKSvvQkQPu8JxXr0AEuPLIcGg1AIhAIVRLdRLzGNdPMPNobZNtLyJ68sCUURGDZmiAZdCLZ6H","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1619193},"main":"dist/index.js","type":"module","_from":"file:blueking-bk-trace-core-0.0.4.tgz","module":"dist/index.esm.js","_npmUser":{"name":"blueking","email":"contactus_bk@tencent.com"},"_resolved":"/private/var/folders/75/cc9h8dln1hb6gx2x51p79q780000gn/T/17a0d5f54d29dcb00b03b8e581733048/blueking-bk-trace-core-0.0.4.tgz","_integrity":"sha512-Mjc0qx2x4eYuHQYGlLqHTdt4ITuv7RDw8mi/JxhZ1JH0uNkkyitgB8BaZmOnRkuzqIimXt8/Yne8DIvhcSxKnw==","_npmVersion":"10.8.2","description":"用于上报前端事件上报，统计界面PV和UV这些","directories":{},"_nodeVersion":"20.19.0","dependencies":{"dayjs":"^1.11.12","@blueking/bk-trace-types":"0.0.4","@blueking/bk-trace-utils":"0.0.4","@blueking/bk-trace-common":"0.0.4"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/bk-trace-core_0.0.4_1748400098144_0.22373412998400455","host":"s3://npm-registry-packages-npm-production"}},"0.0.5":{"name":"@blueking/bk-trace-core","version":"0.0.5","author":{"name":"Tencent BlueKing"},"license":"ISC","_id":"@blueking/bk-trace-core@0.0.5","maintainers":[{"name":"blueking","email":"contactus_bk@tencent.com"}],"dist":{"shasum":"259f52abd11e8f343adf4007336e037819064e9c","tarball":"https://registry.npmjs.org/@blueking/bk-trace-core/-/bk-trace-core-0.0.5.tgz","fileCount":11,"integrity":"sha512-vegpwWTfYp8mKliM0CICci5JCtKvqNpSCgYh54aRs1Y0op4W4PWAeOUYhLE90582eg2hFfs4GyH6JteUkO6wHw==","signatures":[{"sig":"MEUCIBEC8Wr1UQAEuPMVXgCU0Ih4R8YdWqqBPJV9RQ6l/Ok1AiEAmyivPAG5Vv5kmlUrmZhhGMTIS4sEbcgk94VJUdPI8RA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1622463},"main":"dist/index.js","type":"module","_from":"file:blueking-bk-trace-core-0.0.5.tgz","module":"dist/index.esm.js","_npmUser":{"name":"blueking","email":"contactus_bk@tencent.com"},"_resolved":"/private/var/folders/75/cc9h8dln1hb6gx2x51p79q780000gn/T/63a6b89a96b5ec1c51de4eda60f15d80/blueking-bk-trace-core-0.0.5.tgz","_integrity":"sha512-vegpwWTfYp8mKliM0CICci5JCtKvqNpSCgYh54aRs1Y0op4W4PWAeOUYhLE90582eg2hFfs4GyH6JteUkO6wHw==","_npmVersion":"10.8.2","description":"用于上报前端事件上报，统计界面PV和UV这些","directories":{},"_nodeVersion":"20.19.0","dependencies":{"dayjs":"^1.11.12","@blueking/bk-trace-types":"0.0.5","@blueking/bk-trace-utils":"0.0.5","@blueking/bk-trace-common":"0.0.5"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/bk-trace-core_0.0.5_1754570421316_0.1897866587607191","host":"s3://npm-registry-packages-npm-production"}},"0.0.6":{"name":"@blueking/bk-trace-core","version":"0.0.6","author":{"name":"Tencent BlueKing"},"license":"ISC","_id":"@blueking/bk-trace-core@0.0.6","maintainers":[{"name":"blueking","email":"contactus_bk@tencent.com"}],"dist":{"shasum":"19cd5c1a196b0c47bbb86238ac2f9f6727fe59e3","tarball":"https://registry.npmjs.org/@blueking/bk-trace-core/-/bk-trace-core-0.0.6.tgz","fileCount":11,"integrity":"sha512-HL9FHSe6S4GLb/hND03BuoJ7fKCpZJLihWh7/KRGprkjnDcekzjmPwrziGJefW/bsC3tUvtz/brBCei3FCa/DA==","signatures":[{"sig":"MEUCIHg2gUxgHMJrAJFz4b8imVEmQDH6Xq9TF1x9f6Qa9M6tAiEA5L8CLFUxlvqG1/IDF9hhMdliU91jahUPlPieXzDvedA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1622694},"main":"dist/index.js","type":"module","_from":"file:blueking-bk-trace-core-0.0.6.tgz","module":"dist/index.esm.js","_npmUser":{"name":"blueking","email":"contactus_bk@tencent.com"},"_resolved":"/private/var/folders/75/cc9h8dln1hb6gx2x51p79q780000gn/T/20bb847af9135b6e4d0755ead9ef9f56/blueking-bk-trace-core-0.0.6.tgz","_integrity":"sha512-HL9FHSe6S4GLb/hND03BuoJ7fKCpZJLihWh7/KRGprkjnDcekzjmPwrziGJefW/bsC3tUvtz/brBCei3FCa/DA==","_npmVersion":"10.8.2","description":"用于上报前端事件上报，统计界面PV和UV这些","directories":{},"_nodeVersion":"20.19.0","dependencies":{"dayjs":"^1.11.12","@blueking/bk-trace-types":"0.0.6","@blueking/bk-trace-utils":"0.0.6","@blueking/bk-trace-common":"0.0.5"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/bk-trace-core_0.0.6_1758870567177_0.2951211405580154","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2025-02-11T09:29:44.071Z","modified":"2026-01-15T04:03:39.731Z","0.0.1":"2025-02-11T09:29:44.427Z","0.0.2":"2025-03-18T11:59:06.422Z","0.0.3":"2025-05-26T03:26:05.008Z","0.0.4":"2025-05-28T02:41:38.413Z","0.0.5":"2025-08-07T12:40:21.553Z","0.0.6":"2025-09-26T07:09:27.360Z"},"author":{"name":"Tencent BlueKing"},"license":"ISC","description":"用于上报前端事件上报，统计界面PV和UV这些","maintainers":[{"email":"contactus_bk@tencent.com","name":"blueking-magicbox"}],"readme":"# 数据上报插件\n\n用于上报前端事件上报，统计界面PV和UV这些\n\n## 如何安装\n\n### Vue3项目\n\n1. 安装最新SDK\n\n```shell\nnpm i @blueking/bk-trace-core@latest\n```\n\n2. 在项目入口引入SDK\n\n```typescript\nimport { createApp } from 'vue';\nimport App from './App';\n\n// 引入SDK\nimport BkTrace from '@blueking/bk-trace-core';\n\n// 性能和屏幕录制包（安装需求安装）\n// import BkTracePerformance from '@blueking/bk-trace-performance';\n// import BkTraceRecord from '@blueking/bk-trace-recordscreen';\n\n// BkTrace.use(BkTracePerformance);\n// BkTrace.use(BkTraceRecord);\n\ncreateApp(App)\n  .use(BkTrace, {\n    url: '/api/report', // 上报地址\n    appCode: 'bk-test',// 你的APP名称\n    appVersion: 'bcs-v1.0.0',// 你的APP版本\n    spaceID: 'testproject', // 当前空间(支持使用函数 ()=>'testproject')\n    spaceType: 'project', // 当前空间类型(支持使用函数 ()=>'project')\n  })\n  .mount('#app');\n```\n\n### Vue2项目\n\n1. 安装最新SDK\n\n```shell\nnpm i @blueking/bk-trace-core@latest\n```\n\n2. 在项目入口引入SDK\n\n```typescript\nimport Vue from 'vue';\n\n// 引入SDK\nimport BkTrace from '@blueking/bk-trace-core';\n\n// 性能和屏幕录制包（安装需求安装）\n// import BkTracePerformance from '@blueking/bk-trace-performance';\n// import BkTraceRecord from '@blueking/bk-trace-recordscreen';\n\n// BkTrace.use(BkTracePerformance);\n// BkTrace.use(BkTraceRecord);\n\nVue.use(BkTrace);\n```\n\n## 手动上报\n\n默认会自动上报UV和PV数据，也可以手动上报自定义数据\n\n1.指令用法手动上报\n\n```html\n<span v-bk-trace.click=\"{ ct: '用户点击span' }\">点击span</span>\n```\n\n2.引入自定义方法上报\n\n```html\n<template>\n  <div>\n    <!-- 绑定点击事件 handleClick -->\n    <span @click=\"handleClick\">点击span</span>\n  </div>\n</template>\n\n<script>\nimport { defineComponent } from 'vue';\nimport { transportData } from '@blueking/bk-trace-core';\nexport default defineComponent({\n  setup() {\n    const handleClick = () => {\n      const message = '调用自定义方法上报';\n      // 调用 transportData.send 方法进行数据上报\n      transportData.send(message);\n    };\n\n    return {\n      handleClick,\n    };\n  },\n});\n</script>\n\n```\n\n## 配置说明\n\n| 名称                       | 描述                           | 类型                                  | 默认值    |\n|--------------------------|------------------------------|---------------------------------------|---------|\n| url                      | 上报的地址                       | string                               |         |\n| appCode                  | 应用code                     | string                               |         |\n| appVersion               | APP版本                     | string                               |         |\n| spaceType                | 空间类型                       | SpaceType | function                            |         |\n| spaceID                  | 空间ID                        | string | function                               |         |\n| user                     | 用户id                        | string                               |         |\n| disabled                 | 是否禁用SDK                   | boolean                              |         |\n| silentXhr                | 监控 xhr 请求                  | boolean                              | false   |\n| silentFetch              | 监控 fetch 请求                | boolean                              | false   |\n| silentClick              | 监控 click 事件               | boolean                              | false   |\n| silentError              | 监听 error 事件               | boolean                              | false   |\n| silentUnhandledrejection | 监控 unhandledrejection      | boolean                              | false   |\n| silentHashchange         | 监听路由 hash 变化            | boolean                              |         |\n| silentHistory            | 监听路由 history 变化         | boolean                              |         |\n| silentBreadcrumbs        | 记录用户行为堆栈               | boolean                              | false   |\n| recordScreenTime         | 单次录屏时长                   | number                               |         |\n| recordScreenTypeList     | 上报录屏的错误列表             | string[]                             |         |\n| silentWhiteScreen        | 开启白屏检测                   | boolean                              |         |\n| skeletonProject          | 骨架屏检测                     | boolean                              |         |\n| whiteBoxElements         | 白屏检测容器列表               | string[]                             |         |\n| filterXhrUrlRegExp       | 过滤接口请求正则               | RegExp                               |         |\n| useImgUpload             | 使用图片打点上报               | boolean                              |         |\n| throttleDelayTime        | 点击事件节流时长               | number                               |         |\n| overTime                 | 接口超时时长                   | number                               |         |\n| maxBreadcrumbs           | 用户行为最大长度               | number                               |         |\n| repeatCodeError          | 去除重复代码错误               | boolean                              |         |\n| beforePushBreadcrumb     | 行为列表前的 hook             | (data: Partial<ReportData>) => Partial<ReportData> |         |\n| beforeDataReport         | 数据上报前的 hook             | (data: ReportData) => Promise<ReportData | boolean> |         |\n| getUser                  | 用户定义                       | () => string | number               |         |\n| handleHttpStatus         | 处理接口返回 response         | (data: any) => boolean               |         |\n\n## 上报数据格式说明\n\n| 字段名   | 类型                      | 描述                           |\n|----------|---------------------------|--------------------------------|\n| **id**   | `string`                  | 唯一标识符，用于标识每一条上报数据。 |\n| **et**   | `number`                  | 事件发生的时间戳。                 |\n| **ver**  | `string`                  | 应用的版本号。                    |\n| **plv**  | `string`                  | 上报插件的版本号。                 |\n| **cc**   | `number`                  | 缓存命中次数。                    |\n| **sid**  | `string`                  | 会话ID，用于标识用户会话。          |\n| **sct**  | `number`                  | 会话计数，记录会话的次数。          |\n| **sts**  | `string`                  | 会话状态。                       |\n| **u**    | `string`                  | 当前界面的URL。                  |\n| **tit**  | `string`                  | 界面的标题。                     |\n| **uA**   | `string`                  | 浏览器的User-Agent信息。         |\n| **ul**   | `string`                  | 用户的语言设置。                  |\n| **aC**   | `string`                  | 应用的唯一标识。                  |\n| **lo**   | `string`                  | 地理位置信息。                    |\n| **sr**   | `string`                  | 显示设备的分辨率。                 |\n| **os**   | `string`                  | 操作系统信息。                    |\n| **gcd**  | `string`                  | 设备ID。                        |\n| **li**   | `number`                  | 异常发生的行号。                  |\n| **co**   | `number`                  | 异常发生的列号。                  |\n| **rat**  | `string`                  | 性能指标的评级（如FCP、LCP、TTFB、FID）。 |\n| **v**    | `string \\| number`       | 性能指标的值。                    |\n| **pE**   | `PerformanceEntry`       | 原始性能数据。                    |\n| **pRs**  | `PerformanceResourceTiming[]` | 原始性能资源数据。                |\n| **hs**   | `number`                  | JavaScript堆栈大小。             |\n| **ths**  | `number`                  | JavaScript总堆栈大小。            |\n| **uhs**  | `number`                  | JavaScript使用的堆栈大小。         |\n| **fU**   | `string`                  | 接口的URL。                     |\n| **fE**   | `number`                  | 接口请求的耗时。                  |\n| **fS**   | `number`                  | 接口状态码。                     |\n| **usr**  | `string \\| number`       | 用户名或用户ID。                 |\n| **act**  | `EVENTTYPES`             | 用户执行的操作类型。               |\n| **ct**   | `string`                  | 具体的操作类别。                  |\n| **d**    | `string`                  | 操作数据或信息。                  |\n| **to**   | `string`                  | 操作目标。                       |\n| **fr**   | `string`                  | 操作来源。                       |\n| **spt**  | `string`                  | 空间类型。                       |\n| **spid** | `string`                  | 空间ID。                        |\n| **sk**   | `Partial<ReportData>[]`  | 用户行为堆栈，记录用户的操作历史。     |","readmeFilename":"README.md"}