logrocket
nuxt-logrocket

用于 Nuxt 的 LogRocket 模块,帮助您修复错误并理解用户行为。

nuxt-logrocket

nuxt-logrocket

npm (scoped with tag)npmCircleCICodecovjs-standard-style

用于 Nuxt.js 的 LogRocket 模块

📖 发布说明

功能

  • Nuxt 3 & Nuxt Bridge
  • 支持 Pinia 集成
  • 能够在开发模式下运行

设置

  • 使用 yarn 或 npm 将 nuxt-logrocket 依赖项添加到您的项目
yarn add nuxt-logrocket

或者

npm install nuxt-logrocket --save
  • nuxt-logrocket 添加到您的 nuxt.config.ts 文件中的 modules 部分
import { defineNuxtConfig } from 'nuxt'

export default defineNuxtConfig({
  modules: ['nuxt-logrocket'],

  logRocket: {
    id: '',
    dev: false,
    config: {
      //
    }
  }
})

选项

选项可以通过 运行时配置nuxt.config.ts 文件中的 logRocket 部分传递。在大多数情况下,只需设置必需的 id 选项的值即可。

以下是完整的选项列表

选项类型默认必需
ID字符串''
开发布尔值true
enablePinia布尔值true
release字符串null
consoleEnabled布尔值true
networkEnabled布尔值true
networkRequestSanitizer函数-
networkResponseSanitizer函数-
domEnabled布尔值true
inputSanitizer布尔值false
textSanitizer布尔值false
baseHref字符串null
shouldCaptureIP布尔值true
rootHostname字符串null
shouldDebugLog布尔值true
mergeIframes布尔值false

这是一个包含选项默认值的示例

{
  id: '',
  dev: true,
  enablePinia: true,
  config: {
    release: null,
    console: {
      isEnabled: true
    },
    network: {
      isEnabled: true,
      networkRequestSanitizer: () => {},
      networkResponseSanitizer: () => {}
    },
    dom: {
      isEnabled: true,
      inputSanitizer: false,
      textSanitizer: false,
      baseHref: null
    },
    shouldCaptureIP: true,
    rootHostname: null,
    shouldDebugLog: true,
    mergeIframes: false
  }
}

使用

LogRocket 在正确设置后会自动注入到您的应用程序中。默认情况下,此模块仅在 production 环境和客户端事件中工作。

要在您的应用程序中使用 LogRocket 注入的功能,您可以使用

const { $logRocket } = useNuxtApp()

访问 LogRocket 网站获取完整功能列表:文档

Pinia

此模块会自动检测 Pinia 存储突变,并将其附加到 LogRocket 会话。

此功能默认启用,可以通过将 enablePinia 选项设置为 false 来禁用。

import { defineNuxtConfig } from 'nuxt'

export default defineNuxtConfig({
  modules: ['nuxt-logrocket'],

  logRocket: {
    id: '',
    enablePinia: false
  }
})

开发

  • 克隆此仓库
  • 使用 yarn install 安装依赖
  • 使用 yarn run dev 启动开发服务器
  • 将浏览器指向 https://:3000

许可证

MIT 许可证 - Alibaba Travels Co