當(dāng)前位置：首頁 > 科技 > 軟件

為了全面監(jiān)控用戶行為，我寫了個超級前端工具庫！

來源：責(zé)編：時間：2024-06-06 17:41:47 183觀看

導(dǎo)讀簡介sunshine-track 應(yīng)用于前端監(jiān)控，基于行為上報，實現(xiàn)了用戶行為、錯誤監(jiān)控、頁面跳轉(zhuǎn)、頁面白屏檢測、頁面性能檢測等上報功能。適用于 Vue、React、Angular 等框架本項目源碼：https://github.com/sanxin-lin/sunsh

簡介

sunshine-track 應(yīng)用于前端監(jiān)控，基于行為上報，實現(xiàn)了用戶行為、錯誤監(jiān)控、頁面跳轉(zhuǎn)、頁面白屏檢測、頁面性能檢測等上報功能。適用于 Vue、React、Angular 等框架

本項目源碼：https://github.com/sanxin-lin/sunshine-track。各位兄弟姐妹如果覺得喜歡的話，可以點個 star 哦~

功能

sunshine-track具備以下功能：

? 用戶行為上報：包括點擊、跳轉(zhuǎn)頁面、跳轉(zhuǎn)頁面記錄數(shù)組、請求等
? 用戶手動上報：提供 Vue 自定義指令以及add、report函數(shù)，實現(xiàn)用戶手動上報
? 自定義上報：提供格式化上報數(shù)據(jù)、自定義上報函數(shù)、自定義決定上不上報等配置項，更靈活地上報數(shù)據(jù)
? 請求數(shù)據(jù)上報：提供檢測請求返回、過濾請求等配置項，讓用戶決定上報哪些請求數(shù)據(jù)
? 上報方式：提供上報方式配置項，用戶可選擇 img、http、beacon 三種方式，http方式又支持 xhr、fetch 兩種，且支持自定義headers
? 上報數(shù)據(jù)緩存：可配置本地緩存、瀏覽器本地緩存、IndexedDB 三種方式
? 上報數(shù)據(jù)閾值：可配置上報數(shù)據(jù) 閾值，達到閾值后進行上報操作
? 全局點擊上報：可通過配置選擇器、元素文本，對全局DOM節(jié)點進行點擊上報
? 頁面的性能檢測，包括白屏、FP、FCP、LCP、CLS、TTFB、FID 等

上報數(shù)據(jù)格式

選項	描述	類型
`uuid`	上報數(shù)據(jù)的id	`string`
`type`	上報數(shù)據(jù)的類型	`string`
`data`	上報數(shù)據(jù)	`any`
`time`	上報時間	`number`
`status`	上報狀態(tài)	`string`
`domain`	當(dāng)前域名	`string`
`href`	當(dāng)前網(wǎng)頁路徑	`string`
`userAgent`	當(dāng)前user-agent	`string`
`deviceInfo`	設(shè)備的相關(guān)信息	`object`

安裝

圖片

使用

圖片

全局點擊監(jiān)聽

可以通過配置globalClickListeners來對于某些DOM節(jié)點進行點擊監(jiān)聽上報

圖片

配置上報閾值

上報分為幾種：

用戶行為上報：點擊、跳轉(zhuǎn)頁面、請求，這些上報數(shù)據(jù)會緩存著，當(dāng)達到閾值時再進行上報
錯誤上報：請求報錯、代碼報錯、異步錯誤，這些是立即上報
頁面性能上報：白屏、FP、FCP、LCP、CLS、TTFB、FID，這些是立即上報

用戶行為上報的閾值默認是 10，支持自定義 maxEvents

圖片

配置緩存方式

如果你想要避免用戶重新打開網(wǎng)頁之后，造成上報數(shù)據(jù)的丟失，那么你可以配置緩存方式，通過配置cacheType：

normal：默認，本地緩存
storage：瀏覽器 localStorage 本地緩存
db：瀏覽器 IndexedDB 本地緩存

app.use(Track, {  ...options,  cacheType: 'storage' // 配置緩存方式})

打印上報數(shù)據(jù)

可以通過配置 log ，開啟打印上報數(shù)據(jù)。

圖片

靈活上報請求數(shù)據(jù)

請求也是一種行為，也是需要上報的，或許我們有這個需求。

過濾：某些請求我們并不想上報。
自定義校驗請求響應(yīng)數(shù)據(jù)：每個項目的響應(yīng)規(guī)則可能都不同，我們想自己判斷哪些響應(yīng)是成功，哪些是失敗。

圖片

格式化上報數(shù)據(jù)、自定義決定上不上報、自定義上報

如果你想在數(shù)據(jù)上報之前，格式化上報數(shù)據(jù)的話，可以配置report中的format。

圖片

如果你想要自己決定某次上報的時候，進行取消，可以配置report中的isReport。

圖片

如果你不想用這個庫自帶的上報功能，想要自己上報，可以配置report中的customReport。

圖片

手動上報

手動上報分為三種：

手動添加上報數(shù)據(jù)：添加到緩存中，等到達到閾值再上報。
手動執(zhí)行數(shù)據(jù)上報：立即上報。
自定義指令上報：如果你是 Vue 項目，支持指令上報。

圖片

如果你是 Vue 項目，可以使用指令v-track進行上報。

圖片

配置參數(shù)

選項	描述	類型
`projectKey`	項目key	`string`
`userId`	用戶id	`string`
`report.url`	上報url	`string`
`report.reportType`	上報方式	`img、http、beacon`
`report.headers`	上報自定義請求頭，`http` 上報模式生效	`object`
`report.format`	上報數(shù)據(jù)格式化	`function`
`report.customReport`	自定義上報	`function`
`report.isReport`	自定義決定上不上報	`function`
`cacheType`	數(shù)據(jù)緩存方式	`normal、storage、db`
`globalClickListeners`	上報狀態(tài)	`array`
`log`	當(dāng)前域名	`boolean`
`maxEvents`	上報閾值	`number`
`historyUrlsNum`	需要記錄的url跳轉(zhuǎn)數(shù)組	`number`
`checkHttpStatus`	判斷響應(yīng)數(shù)據(jù)	`function`
`filterHttpUrl`	過濾上報請求數(shù)據(jù)	`function`
`switchs.xhr`	是否開啟xhr請求上報	`boolean`
`switchs.fetch`	是否開啟fetch請求上報	`boolean`
`switchs.error`	是否開啟錯誤上報	`boolean`
`switchs.whitescreen`	是否開啟白屏檢測上報	`boolean`
`switchs.hashchange`	是否開啟hash變化請求上報	`boolean`
`switchs.history`	是否開啟history變化上報	`boolean`
`switchs.performance`	是否開啟頁面性能上報	`boolean`

本項目源碼：https://github.com/sanxin-lin/sunshine-track。各位兄弟姐妹如果覺得喜歡的話，可以點個 star 哦~

本文鏈接：http://www.www897cc.com/showinfo-26-92466-0.html為了全面監(jiān)控用戶行為，我寫了個超級前端工具庫！

聲明：本網(wǎng)頁內(nèi)容旨在傳播知識，若有侵權(quán)等問題請及時與本網(wǎng)聯(lián)系，我們將在第一時間刪除處理。郵件：2376512515@qq.com

上一篇：關(guān)于 Python 數(shù)據(jù)分析的 15 個 NumPy 應(yīng)用

下一篇：動態(tài)鏈接庫的實現(xiàn)原理是什么？

標(biāo)簽：

熱門焦點

Mate60手機殼曝光致敬自己的經(jīng)典設(shè)計

8月3日消息，今天下午博主數(shù)碼閑聊站帶來了華為Mate60的第三方手機殼圖，可以讓我們在真機發(fā)布之前看看這款華為全新旗艦的大致輪廓。從曝光的圖片看，Mate 60背后攝像頭面積依然
中興AX5400Pro+上手體驗：再升級雙2.5G網(wǎng)口+USB 3.0這次全都有

2021年11月的時候，中興先后發(fā)布了兩款路由器產(chǎn)品，中興AX5400和中興AX5400 Pro，從產(chǎn)品命名上就不難看出這是隸屬于同一系列的，但在外觀設(shè)計上這兩款產(chǎn)品可以說是完全沒一點關(guān)系
Flowable工作流引擎的科普與實踐

一.引言當(dāng)我們在日常工作和業(yè)務(wù)中需要進行各種審批流程時，可能會面臨一系列技術(shù)和業(yè)務(wù)上的挑戰(zhàn)。手動處理這些審批流程可能會導(dǎo)致開發(fā)成本的增加以及業(yè)務(wù)復(fù)雜度的上升。在這
阿里瓴羊One推出背后，零售企業(yè)迎數(shù)字化新解

作者:劉曠近年來隨著數(shù)字經(jīng)濟的高速發(fā)展，各式各樣的SaaS應(yīng)用服務(wù)更是層出不窮，但本質(zhì)上SaaS大多局限于單一業(yè)務(wù)流層面，對用戶核心關(guān)切的增長問題等則沒有提供更好的解法。在Saa
小米汽車電池信息疑似曝光：容量101kWh，支持800V高壓快充

7月14日消息，今日一名博主在社交媒體發(fā)布了一張疑似小米汽車電池信息的照片，顯示該電池包正是寧德時代麒麟電池，容量為101kWh，電壓為726.7V，可以預(yù)測小
網(wǎng)傳小米汽車開始篩選交付中心建筑面積不低于3000平方米

7月7日消息，近日有微博網(wǎng)友@長三角行健者爆料稱，據(jù)經(jīng)銷商集團反饋，小米汽車目前已經(jīng)開始了交付中心的篩選工作，要求候選場地至少有120個車位，建筑不能低
AI芯片初創(chuàng)公司Tenstorrent獲三星和現(xiàn)代1億美元投資

Tenstorrent是一家由芯片行業(yè)資深人士Jim Keller領(lǐng)導(dǎo)的加拿大初創(chuàng)公司，專注于開發(fā)人工智能芯片，該公司周三表示，已經(jīng)從現(xiàn)代汽車集團和三星投資基金等
Android 14發(fā)布：首批適配機型公布

5月11日消息，谷歌在今天凌晨舉行了I/O大會，本次發(fā)布會谷歌帶來了自家的AI語言模型PaLM 2、谷歌Pixel Fold折疊屏、谷歌Pixel 7a手機，同時發(fā)布了Androi
iQOO Neo8系列或定檔5月23日：首發(fā)天璣9200+ 安卓跑分王者

去年10月，iQOO推出了iQOO Neo7系列機型，不僅搭載了天璣9000+，而且是同價位唯一一款天璣9000+直屏旗艦，一經(jīng)上市便受到了用戶的廣泛關(guān)注。在時隔半年后，

日韩成人免费在线_国产成人一二_精品国产免费人成电影在线观..._日本一区二区三区久久久久久久久不

為了全面監(jiān)控用戶行為，我寫了個超級前端工具庫！

簡介

功能

上報數(shù)據(jù)格式

安裝

使用

全局點擊監(jiān)聽

配置上報閾值

配置緩存方式

打印上報數(shù)據(jù)

靈活上報請求數(shù)據(jù)

格式化上報數(shù)據(jù)、自定義決定上不上報、自定義上報

手動上報

配置參數(shù)

Mate60手機殼曝光致敬自己的經(jīng)典設(shè)計

中興AX5400Pro+上手體驗：再升級雙2.5G網(wǎng)口+USB 3.0這次全都有

Flowable工作流引擎的科普與實踐

阿里瓴羊One推出背后，零售企業(yè)迎數(shù)字化新解

小米汽車電池信息疑似曝光：容量101kWh，支持800V高壓快充

網(wǎng)傳小米汽車開始篩選交付中心建筑面積不低于3000平方米

AI芯片初創(chuàng)公司Tenstorrent獲三星和現(xiàn)代1億美元投資

Android 14發(fā)布：首批適配機型公布

iQOO Neo8系列或定檔5月23日：首發(fā)天璣9200+ 安卓跑分王者

最新推薦

猜你喜歡

熱門推薦

相關(guān)資訊