# uni.report(options) GitCodeGitHub

uni统计自定义上报方法。

本 API 是 uni ext api,需下载插件:uni-stat

# 注意事项

uni.report 需要依赖 uni统计,集成方式请查看文档

# report 兼容性

Web 微信小程序 Android iOS HarmonyOS
4.33 - 4.33 4.33 -

# 参数

名称 类型 必填 默认值 兼容性 描述
options ReportOptions - - 自定义事件参数
名称 类型 必备 默认值 兼容性 描述
name string - - 自定义事件名称,内置名称不允许覆盖,可选值:
uni-app-launch:应用启动,options 参数必填,值为 onLaunch 返回值
uni-app-show:应用进入前台
uni-app-hide:应用进入后台
uni-app-error:应用发生错误,options 参数必填,值为错误信息,类型为String
title:标题采集
自定义name:用户自定义
options any - - 额外参数
success (res: ReportSuccess) => void - - 接口调用成功回调
fail (err: ReportFail) => void - - 接口调用失败回调
complete (res: any) => void - - 接口调用结束回调(调用成功、失败都会执行)

# ReportSuccess 的属性值

名称 类型 必备 默认值 兼容性 描述
errMsg string - - 成功的详细信息

# ReportFail 的属性值

名称 类型 必备 默认值 兼容性 描述
errCode number - - 错误码
合法值 兼容性 描述
61000 - 应用已集成uni统计,但未关联服务空间,请在uniCloud目录右键关联服务空间
61001 - 统计服务尚未初始化,需在main.uts中引入统计插件
61002 - name参数是uni-app-launch时, options 参数未填写
61003 - name参数未填写
61004 - name参数类型错误,应为String类型
61005 - name参数长度超限,最大不超过255
61006 - options参数错误,应为String或Object类型
61007 - options参数为String类型时,长度超限,最大不超过255
61008 - name参数为title时,options参数类型错误,应为String
errSubject string - - 统一错误主题(模块)名称
data any - - 错误信息中包含的数据
cause Error - - 源错误信息,可以包含多个错误,详见SourceError
errMsg string - - -

# 如何使用自定义上报

// 参数支持字符串
uni.report({
 name:'购买',
 options:'购买成功'
})

// 参数支持对象
uni.report({
 name:'购买',
 options:{
  id:'1000',
  name:'上衣',
  price:'998',
  msg:'购买成功'
  // ...
 }
})

# 示例

示例为hello uni-app x alpha分支,与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例另见

扫码体验(手机浏览器跳转到App直达页)

示例

<template>
  <!-- #ifdef APP -->
  <scroll-view style="flex:1">
  <!-- #endif -->
    <page-head title="report"></page-head>

    <view class="tips">
      <view class="tips-title">调用信息:</view>
      <view class="tips-content">{{msg}}</view>
    </view>
    <view class="page">

      <button class="normal-button" type="default" @click="handleAppLaunch">
        模拟应用启动
      </button>
      <button class="normal-button" type="default" @click="handleAppHide">
        模拟应用切入后台
      </button>
      <button class="normal-button" type="default" @click="handleAppShow">
        模拟应用切入前台
      </button>
      <button class="normal-button" type="default" @click="handleAppError">
        模拟应用错误
      </button>
      <button class="normal-button" type="default" @click="handleTitle">
        模拟自定义title
      </button>
      <button class="normal-button" type="default" @click="handleEvent">
        模拟自定义事件
      </button>
      <text class="instructions">
        当前页面调用API均为模拟,请查看文档,在特定场景下使用以上 API。请在main.uts中设置统计debug配置为true,并点击按钮查控制台输出。
      </text>
    </view>

  <!-- #ifdef APP -->
  </scroll-view>
  <!-- #endif -->
</template>

<script>
  export default {
    data() {
      return {
        msg: '点击按钮,测试上报'
      }
    },
    onLoad() {
      uni.report({
        name: '自定义上报-report页面打开',
        options: '1'
      })
    },
    onUnload() {
      uni.report({
        name: '自定义上报-report页面关闭',
        options: '1'
      })
    },

    methods: {
      handleAppLaunch() {
        const options = uni.getLaunchOptionsSync()
        uni.report({
          name: 'uni-app-launch',
          options: options,
          success: (res) => {
            this.msg = 'onLaunch --> ' + res.errMsg
            console.log(res);
          }, fail: (err) => {
            this.msg = 'onLaunch --> ' + err.errMsg
            console.log(err);
          }
        })
      },
      handleAppHide() {
        uni.report({
          name: 'uni-app-hide',
          success: (res) => {
            this.msg = 'onAppHide --> ' + res.errMsg
            console.log(res);
          }, fail: (err) => {
            this.msg = 'onAppHide --> ' + err.errMsg
            console.log(err);
          }
        })
      },
      handleAppShow() {
        // const options = uni.getLaunchOptionsSync()
        uni.report({
          name: 'uni-app-show',
          success: (res) => {
            this.msg = 'onAppShow --> ' + res.errMsg
            console.log(res);
          }, fail: (err) => {
            this.msg = 'onAppShow --> ' + err.errMsg
            console.log(err);
          }
        })
      },
      handleAppError() {
        const errmsg = '测试错误'
        uni.report({
          name: 'uni-app-error',
          options: errmsg,
          success: (res) => {
            this.msg = 'onAppError --> ' + res.errMsg
            console.log(res);
          }, fail: (err) => {
            this.msg = 'onAppError --> ' + err.errMsg
            console.log(err);
          }
        })
      },
      handleEvent() {
        // 此处name为用户自定义
        uni.report({
          name: 'custom-event',
          options: {
            title: '自定义事件',
            total: 1
          },
          success: (res) => {
            this.msg = '自定义事件 --> ' + res.errMsg
            console.log(res);
          }, fail: (err) => {
            this.msg = '自定义事件 --> ' + err.errMsg
            console.log(err);
          }
        })
      },
      handleTitle() {
        // 此处name为用户自定义
        uni.report({
          name: 'title',
          options: '自定义title测试上报',
          success: (res) => {
            this.msg = '自定义title --> ' + res.errMsg
            console.log(res);
          }, fail: (err) => {
            this.msg = '自定义title --> ' + err.errMsg
            console.log(err);
          }
        })
      },
    }
  }
</script>

<style>
  .page {
    padding: 15px;
  }

  .tips {
    margin: 15px;
    padding: 15px;
    background-color: #f5f5f5;
    font-size: 14px;
    text-align: center;
  }

  .tips-title {
    font-size: 16px;
    color: #333;
    margin-bottom: 10px;
  }

  .tips-content {
    font-size: 14px;
    color: #999;
  }

  .normal-button {
    width: 100%;
    margin-bottom: 10px;
  }

  .instructions {
    margin-top: 10px;
    margin-left: 10px;
    margin-right: 10px;
    background-color: #eee;
    font-size: 12px;
    color: #999;
  }
</style>

# 参见

# 通用类型

# GeneralCallbackResult

名称 类型 必备 默认值 兼容性 描述
errMsg string -
错误信息