uni-app-x

# uni.report(options) GitCode GitHub

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: ReportError) => void	否	-	-	接口调用失败回调
complete	(res: any) => void	否	-	-	接口调用结束回调（调用成功、失败都会执行）

# ReportSuccess 的属性值

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

# ReportError 的属性值

名称类型必备默认值兼容性描述

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:'购买成功'
  // ...
 }
})

# 示例

示例为 alpha 分支：hello uni-app x（alpha）

master 分支：hello uni-app x（master）

Template

Script

<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>



<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>