# api

elastic-apm-js 文档 api:https://www.elastic.co/guide/en/apm/agent/js-base/current/api.html#apm-set-user-context

```javascript
/*
    @params： 同elastic-apm-js文档：apm.setUserContext
    @explain：设置用户信息
*/
setUserInfo(UserContext:{
    id: string;
    username: string;
    email: string;
})
/*
    @params： eventName: = apm.startTransaction 中的name
    @return： 一个独立的transaction实例,实例等同于apm.startTransaction的返回值
    @explain：生成一个独立的transaction实例适用于custom Event，type被标记为customEvent_task
*/
createCustomLog(eventName:strin)
/*
    @params： error message string || new Error('xxxxx')
    @explain：交给外部发起一个错误的tansaction， 通常这个api在第三方框架的onError钩子中使用
*/
captureError(error: string | any)
/*******     catch control    *******/
//element catch 开关
stopElementActionCatch()
resumeElementActionCatch()
//urlChange catch 开关
stopPageChangeEventCatch()
resumePageChangeEventCatch()
//networkRequest catch 开关
stopRequestCatch()
resumeRequestCatch()
```