# network-spanner

> 提供各种前端网络需要用到的工具 Provide various tools for front-end network

Latest version **1.2.26** (published 2026-02-26) · MPL license · 0 weekly downloads

## Install

```sh
npm install network-spanner
pnpm add network-spanner
yarn add network-spanner
bun add network-spanner
```

## Health

**Score 55/100 (C)** — status: stable.

Positive: has types; esm support; no vulnerabilities.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 1.2.26 |
| Published | 2026-02-26 |
| First published | 2024-02-27 |
| Weekly downloads | 0 |
| License | MPL |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 2 |
| Unpacked size | 93.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | chendeli419287484@qq.com |
| Maintainers | alan1034 |
| Keywords | http, utils, tools |

## Links

- npm: https://www.npmjs.com/package/network-spanner
- Repository: https://github.com/Alan1034/network-spanner
- Homepage: https://github.com/Alan1034/network-spanner#readme
- Issues: https://github.com/Alan1034/network-spanner/issues
- npm.io page: https://npm.io/package/network-spanner

## Dependencies (2)

- [vconsole](https://npm.io/package/vconsole.md) ^3.15.1
- [general-basic-indexdb](https://npm.io/package/general-basic-indexdb.md) ^1.0.5

## Recent versions

- 1.2.26 (latest) — 2026-02-26
- 1.2.25 — 2026-01-19
- 1.2.24 — 2025-12-24
- 1.2.23 — 2025-10-28
- 1.2.22 — 2025-10-27
- 1.2.21 — 2025-10-27
- 1.2.20 — 2025-10-24
- 1.2.19 — 2025-10-23
- 1.2.18 — 2025-10-23
- 1.2.17 — 2025-10-15
- 1.2.16 — 2025-09-03
- 1.2.15 — 2025-09-03
- 1.2.14 — 2025-03-10
- 1.2.13 — 2025-02-18
- 1.2.12 — 2025-02-18
- … 18 more at https://npm.io/package/network-spanner/versions

## README

# 提供各种前端网络需要用到的工具 Provide various tools for front-end network

提供各种前端网络需要用到的工具 Provide various tools for front-end network

## 传入HTTP状态码，传出对应的中英文描述

使用usage:

import { HTTPStatusTrans } from "network-spanner"

/**
 * @description: HTTPStatusTrans:传入HTTP状态码，传出对应的中英文描述

 * afferent http status, return corresponding EN CN description

 * @return { EN, CN }
 */

 

 ```
 const { EN = '', CN = "" } = HTTPStatusTrans(status)
 
 console.error(`${EN ? EN + "," : ""}${CN ? CN + "," : ""}${err.error?.message || err.statusText}`)
 ```

 ​    

参考资料references：

https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Status

https://blog.csdn.net/lghuntfor/article/details/88606444

## 处理微信小程序errno错误码 Handling Miniprogram  errno code


使用usage:

import { MiniprogramErrno } from "network-spanner"

/**

 \* @description: 微信小程序errno错误码

 \* https://developers.weixin.qq.com/miniprogram/dev/framework/usability/PublicErrno.html#%E8%83%8C%E6%99%AF%E4%BB%8B%E7%BB%8D

 \* errno 错误码一般为 7 位数，第 1 - 2 位标识 API 接口的一级类目，第 3 - 4 位标识 API 接口的二级类目，第 5 - 7 位表示具体的错误类型。

 *例如： errno 错误码为 1504003 时，15 表示 API 接口的一级类目为 设备，04 表示 API 接口的二级类目为 NFC，003 表示具体的错误类型。

 *目前已接入 errno 的 API 接口涉及的类目包括：

 *

 *一级类目：00 - 通用错误码

 *一级类目：01 - 基础

 * 二级类目：00 - 通用基础错误

 * 二级类目：03 - 更新

 * 二级类目：09 - 加密

 *一级类目：06 - 网络

 * 二级类目：00 - 通用网络错误

 * 二级类目：02 - 发起请求

 * 二级类目：03 - 下载

 * 二级类目：04 - 上传

 * 二级类目：06 - mDNS

 *一级类目：07 - 支付

 * 二级类目：00 - 通用支付错误

 * 二级类目：01 - 支付默认二级类目

 *一级类目：11 - 媒体

 * 二级类目：07 - 实时音视频

 *一级类目：13 - 文件

 * 二级类目：00 - 通用文件错误

 * 二级类目：01 - 文件默认二级类目

 * 二级类目：02 - fd接口

 *一级类目：14 - 开放接口

 * 二级类目：16 - 视频号

 *一级类目：15 - 设备

 * 二级类目：00 - 通用设备错误

 * 二级类目：04 - NFC

 * 二级类目：05 - Wi-Fi

 * 二级类目：09 - 低功耗蓝牙

 * 二级类目：10 - 蓝牙

 *一级类目：20 - AI

 * 二级类目：02 - 人脸识别

 * 二级类目：03 - vision kit

 * 二级类目：04 - 机器学习

 *一级类目与二级类目名称 和 API 接口文档的类目名称基本保持一致。

 \* @return { EN, CN }

 */

```
  fail (err) {
    const { EN, CN } = MiniprogramErrno(err.errno)
    wx.showModal({
      content: `${CN || EN || err.errMsg}`,
      showCancel: false,
    })
  }
```

## 消息队列，用于传入多个数据（如用户多次拖拽）会触发最后一个（直接展示最新数据）

使用usage:

```
import { MessageQueue } from "network-spanner"
```

value?: any // 队列传入somePromise函数的参数

somePromise: Function // 队列排队结束时的回调函数，请传入同步函数或者有回调的异步函数

delay?: number //当不支持window.requestAnimationFrame时可以自定义setTimeout的延迟时间，默认是1000

```
MessageQueue({ value, somePromise: this.refreshList })
```

安装：npm i network-spanner

install: npm i network-spanner

## *在URL中储存对象*

使用usage:

```
import { ObjectStoreInUrl } from "network-spanner"
```

*/***

 *** *@description**: 对象值或数组里的对象转化成字符串

 *** *@param* *{\*}* *params*

 *** *@return* *{\*}*

 **/*

```
const searchParams = ObjectStoreInUrl.paramsToQuery(params)
this.$router.push({
  query: { ...searchParams },
});

手工拼接
const urlParams = ObjectStoreInUrl.getURLParameter({ decode: true });
const paramsObj = ObjectStoreInUrl.paramsToQuery({
  ...urlParams,
  ...params,
});
window.location.href = `${window.location.origin}${
  window.location.pathname
}?${new URLSearchParams(paramsObj as any)}`;

```

*/***

 *** *@description**: URL query的值转化成对象

 *** *@param* *{\*}* *query*

 *** *@return* *{\*}*

 **/*

```
ObjectStoreInUrl.queryToData(this.$route?.query)
```

*/**
 * @description: 得到URL中的参数(query string)
 * @param {Object} options
 * @param {boolean} options.decode 是否decodeURIComponent解码，默认false
 * @return {*} urlParams
 */

```
ObjectStoreInUrl.getURLParameter()

组合使用
ObjectStoreInUrl.queryToData(ObjectStoreInUrl.getURLParameter({ decode: true }))

```

## 当前时区的时间和UTC时间的转换

```
import {  DateTools } from 'network-spanner';

// localDate为当前时区的时间，需要转为UTC时间
//toZero 参数，返回值转为传入值的UTC时间的零点时分秒
DateTools.toUTCDate(new Date(), 'toZero')

// UTCDate为UTC时间，需要转为当前时区的时间
//toZero 参数，返回值转为传入值的当前时区的时间的零点时分秒
DateTools.toLocalDate(UTCDate, 'toZero')

```

## Vue2的自定义组件生成函数

```
import { TableColumn } from "network-spanner"

<TableColumn v-if="item.render" :renderFunction="item.render" :item="formData" />
```

```
renderFunction：(item: any) => VNode | String;
item：传入renderFunction函数的参数
```

## 在分享网页中调起或者下载APP

![image-20211116115258955](https://raw.githubusercontent.com/Alan1034/PicturesServer/main/PicGo_imgs/wechat_2025-09-03_151636_748.png)

```
import { OpenDownload } from 'network-spanner'
import { loadMaskIns } from 'variable-loading-mask'
import OpenInSysBrowser from '@/assets/img/openInSysBrowser.png'

const { goExperience } = OpenDownload
export const goExperienceFunc = (params: any) => {
  const { queryString = '' } = params || {}
  goExperience({
    scheme: 'XXX://XXX.XXX.com' + queryString,
    downloadHref: 'https://XXX.XXX.com/download/XXX.apk',
    appBrowserCallback: () => {
      const mask = loadMaskIns({
        maskType: 'any',
        imgSlot: {
          src: OpenInSysBrowser,
          alt: '打开系统浏览器',
          style: { width: '215px', height: '95px', marginLeft: '100px' }
        },
        tools: false
      })
      mask.show()
    }
  })
}

      <button class="download-btn" @click="goExperienceFunc(
        { queryString: `?inviteCode=${this.inviteCode}` }
      )">
        <img :src="Download" alt="download" class="icon-cloud" />
        <span>下载APP</span>
      </button>
```

---
_Source: https://npm.io/package/network-spanner · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
