# error-catch

**Repository Path**: memory_s/error-catch

## Basic Information

- **Project Name**: error-catch
- **Description**: 一款基于browser或node环境下的，未能捕获的异常错误捕获
- **Primary Language**: TypeScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-26
- **Last Updated**: 2025-11-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# error-catch

#### 贡献

1.  Fork 本仓库
2.  新建 feat/xxx 分支
3.  Push代码，并提交 Merge Request, 作者欢迎各位为此开源项目贡献一份力量~

#### 介绍

一款基于browser或node环境下的，未能捕获的异常错误监听兜底。
注：在 WebWorker 中的错误，不能在浏览器的主线程中捕获到。因为其在不同的线程，其上下文是隔离的。如需要支持，请在 WebWorker 中初始化当前实例。

#### 安装

```sh
npm install @mtool/error-catch
## 或
ppm add @mtool/error-catch
## 或
yarn add @mtool/error-catch
```

#### 使用说明

- 引入项目包
```ts
    // 浏览器环境下引入
    import { BrowserErrorCatch } from "@mtool/error-catch/browser"

    // Node 环境下引入
    import { ProcessErrorCatch } from "@mtool/error-catch/node"
```


- 项目使用
```ts
    // 浏览器环境下项目引入
    import { BrowserErrorCatch } from "@mtool/error-catch/browser"
    
    /**
     * listen 监听函数介绍
     * @param { string } 第一个参数为 type, 目前支持的异常捕获有: error|unhandledrejection
     * @param { Array<any> } 其它的扩散参数为监听异常捕获的参数
     * **/
    new BrowserErrorCatch().listen((type, ...args) => {
        console.log('error cache:', args)
    })

    // Node 环境下项目引入
    import { ProcessErrorCatch } from "@mtool/error-catch/browser"

    /**
     * listen 监听函数介绍
     * @param { string } 第一个参数为 type, 目前支持的异常捕获有: uncaughtException|unhandledRejection
     * @param { Array<any> } 其它的扩散参数为监听异常捕获的参数
     * **/
    new ProcessErrorCatch().listen((type, ...args) => {
        console.log('error cache:', args)
    }) 
```