# @cycjimmy/awesome-js-funcs 中文文档

规范地址：https://npmcn.com/package/%40cycjimmy/awesome-js-funcs/

版本：4\.0\.11
npm 元数据更新时间：2026-10-19T10:43:08.062Z
中文译文更新时间：2026-11-11T06:52:37.410Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40cycjimmy/awesome-js-funcs
原文对照：https://npmcn.com/package/%40cycjimmy/awesome-js-funcs/?lang=original
项目主页：https://github.com/cycjimmy/awesome-js-funcs#readme
源码仓库：https://github.com/cycjimmy/awesome-js-funcs

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：80 kB，127 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2019-10-09T10:27:44.289Z
- 最新版本发布：2026-10-19T10:43:07.651Z
- 近 30 天下载量：369811（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：29（近 12 个月 2 个）

## 中文简介

经常使用的Javascript函数的个人收藏.

## 安装

```sh
npm install @cycjimmy/awesome-js-funcs
```

也可以使用：`pnpm add @cycjimmy/awesome-js-funcs`、`yarn add @cycjimmy/awesome-js-funcs`、`bun add @cycjimmy/awesome-js-funcs`

## README

# 厉害的Js Funcs

![](https://github.com/cycjimmy/awesome-js-funcs/workflows/Test%20CI/badge.svg) [![libraries dependency status](https://img.shields.io/librariesio/release/npm/@cycjimmy/awesome-js-funcs)](https://libraries.io/github/cycjimmy/awesome-js-funcs) [![libraries sourcerank](https://img.shields.io/librariesio/sourcerank/npm/@cycjimmy/awesome-js-funcs)](https://libraries.io/npm/@cycjimmy%2Fawesome-js-funcs) [![Release date](https://img.shields.io/github/release-date/cycjimmy/awesome-js-funcs)](https://github.com/cycjimmy/awesome-js-funcs/releases) [![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/semantic-release/semantic-release) [![npm license](https://img.shields.io/npm/l/@cycjimmy/awesome-js-funcs)](https://npmjs.org/package/@cycjimmy/awesome-js-funcs)

## 安装

[![NPM version](https://img.shields.io/npm/v/@cycjimmy/awesome-js-funcs)](https://npmjs.org/package/@cycjimmy/awesome-js-funcs) [![NPM bundle size](https://img.shields.io/bundlephobia/min/@cycjimmy/awesome-js-funcs)](https://npmjs.org/package/@cycjimmy/awesome-js-funcs) [![npm download](https://img.shields.io/npm/dt/@cycjimmy/awesome-js-funcs)](https://npmjs.org/package/@cycjimmy/awesome-js-funcs)

```shell
# via npm
$ npm install @cycjimmy/awesome-js-funcs --save

# or via yarn
$ yarn add @cycjimmy/awesome-js-funcs
```

## 用法为相. 例如:

```javascript
import { isString } from '@cycjimmy/awesome-js-funcs';

// or better import
import { isString } from '@cycjimmy/awesome-js-funcs/esm/judgeBasic';

// or best import (recommend)
import isString from '@cycjimmy/awesome-js-funcs/esm/judgeBasic/isString';
const isString = require('@cycjimmy/awesome-js-funcs/cjs/judgeBasic/isString.cjs').default;

console.log(isString('string'));   // show true
```

## 函数收藏

-   初级法官
    -   `isString`
    -   `isNumber`
    -   `isObject`
    -   `isFunction`
    -   `isArray`
    -   `isNull`
    -   `isUndefined`
    -   `isPromise`
    -   `isNodeList`
    -   `isUrl`
-   法官
    -   `isChineseName`
    -   `isChinesePhoneNumber`
    -   `isChineseIdentificationNum`
-   字符串
    -   `trim`
    -   `firstUpperCase`
    -   `midlineToCamel`
-   数组
    -   `shuffle`
-   对象
    -   `entries`
    -   `clean`
-   数学
    -   `randomInt`
-   类型转换
    -   `nodeListToArray`
    -   `functionToPromise`
    -   `stringTrueFalseToBoolean`
    -   `stringToJson`
-   数字
    -   `QueryAll` (编)
    -   `siblingFilter`
    -   `addStyles`
    -   `getElementStyle`
    -   `addPreloadLink`
    -   `touchActive`
    -   `touchActiveMockClick`
-   事件
    -   `dispatch`
    -   `debounce`
    -   `throttle`
    -   `preventDefault`
-   媒体
    -   `isAudioPlaying`
    -   `isVideoPlaying`
-   手持设备
    -   `judgeOrientation`
    -   `isMobile`
    -   `getBrowserInfo`
-   函数
    -   `delayForPromise`
-   reg 压缩
    -   `chineseName`
    -   `chinesePhoneNumber`
    -   `chineseIdentificationNum`
-   设计
    -   `CreateInstance` (编)
-   很少见
    -   `getUrlRelativeDir`

## 常见问题

### @cycjimmy/awesome-js-funcs 是什么？

经常使用的Javascript函数的个人收藏\.

### 如何安装 @cycjimmy/awesome-js-funcs？

在项目目录运行 npm install @cycjimmy/awesome-js-funcs，或使用 pnpm add / yarn add / bun add。

### @cycjimmy/awesome-js-funcs 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/cycjimmy\_\_awesome-js-funcs 是否存在。

### @cycjimmy/awesome-js-funcs 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @cycjimmy/awesome-js-funcs 可以商用吗？

@cycjimmy/awesome-js-funcs 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @cycjimmy/awesome-js-funcs 的下载量有多少？

根据 npm 官方下载统计，@cycjimmy/awesome-js-funcs 在 2026/10/11 – 2026/11/09 这 30 天内被下载 369,811 次，日均约 12,327 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @cycjimmy/awesome-js-funcs 还在维护吗？

最新版本 4\.0\.11 发布于 2026/10/19（22 天前）；至今共发布 29 个版本，其中过去 12 个月发布了 2 个；首次发布于 2019/10/09。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。