# @chronicstone/array-query 中文文档

规范地址：https://npmcn.com/package/%40chronicstone/array-query/

版本：1\.0\.5
npm 元数据更新时间：2024-10-09T13:51:25.650Z
中文译文更新时间：2026-11-09T15:21:16.752Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：40.8 kB，8 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2024-07-15T12:19:17.522Z
- 最新版本发布：2024-10-09T13:51:25.475Z
- 近 30 天下载量：2883（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：15（近 12 个月 0 个）

## 中文简介

一个简单和轻量级的数组查询库

## 安装

```sh
npm install @chronicstone/array-query
```

也可以使用：`pnpm add @chronicstone/array-query`、`yarn add @chronicstone/array-query`、`bun add @chronicstone/array-query`

## README

# 矩阵查询

[![npm version](https://img.shields.io/npm/v/@chronicstone/array-query?style=flat&colorA=080f12&colorB=1fa669)](https://npmjs.com/package/@chronicstone/array-query) [![npm downloads](https://img.shields.io/npm/dm/@chronicstone/array-query?style=flat&colorA=080f12&colorB=1fa669)](https://npmjs.com/package/@chronicstone/array-query) [![bundle](https://img.shields.io/bundlephobia/minzip/@chronicstone/array-query?style=flat&colorA=080f12&colorB=1fa669&label=minzip)](https://bundlephobia.com/result?p=@chronicstone/array-query) [![JSDocs](https://img.shields.io/badge/jsdocs-reference-080f12?style=flat&colorA=080f12&colorB=1fa669)](https://www.jsdocs.io/package/@chronicstone/array-query) [![License](https://img.shields.io/github/license/ChronicStone/array-ql.svg?style=flat&colorA=080f12&colorB=1fa669)](https://github.com/ChronicStone/array-ql/blob/main/LICENSE)

> ### **使用类似ORM的语法查询JavaScript数组,得益于优秀的类型安全和发展者经验.**

## 关键特性 :

-   🛠 **类型安全查询 :** 用强打字设计您的查询( 类型排序 / 搜索 / 过滤键和输出)
-   📄 **铺设 :** 在内置支持下,通过大型数据集轻松地相接.
-   🔎 **全文搜索 :** 在您数据中的多个字段进行全面搜索.
-   🧭 **高级过滤 :** 应用各种匹配模式的复杂过滤器进行精确的数据检索。 支持逻辑组、嵌入条件和阵列匹配.
-   🔢 **弹性排序 :** 基于任意字段的排序结果,支持多类标准.
-   🚀 **轻取快取:** 查询会保持超快,即使有大型数据集.
-   🧩 **无依赖**: 完全自成一体,没有外部依赖性,确保小额捆绑成本

## 通知

```bash
// npm
npm install @chronicstone/array-query

// yarn
yarn add @chronicstone/array-query

// pnpm
pnpm add @chronicstone/array-query

// bun
bun add @chronicstone/array-query
```

## 用户示例

```ts
import { query } from '@chronicstone/array-query'

const users = [
  { id: 1, fullName: 'John Doe', email: 'john@example.com', age: 30, status: 'active', roles: ['admin'], createdAt: '2023-01-01' },
  { id: 2, fullName: 'Jane Smith', email: 'jane@example.com', age: 28, status: 'inactive', roles: ['user'], createdAt: '2023-02-15' },
  { id: 3, fullName: 'Bob Johnson', email: 'bob@example.com', age: 35, status: 'active', roles: ['user', 'manager'], createdAt: '2023-03-20' },
  // ... more users
]

const { totalRows, totalPages, rows } = query(users, {
  // Pagination
  page: 1,
  limit: 10,

  // Sorting
  sort: [
    { key: 'age', dir: 'desc' },
    { key: 'fullName', dir: 'asc' }
  ],

  // Searching
  search: {
    value: 'john',
    keys: ['fullName', 'email']
  },

  // Filtering
  filter: [
    { key: 'status', matchMode: 'equals', value: 'active' },
    { key: 'age', matchMode: 'greaterThan', value: 25 },
  ]
})
```

这个例子显示了pagination,多字段排序,全文搜索,以及带有嵌入条件和阵列字段匹配的复杂过滤.

## 许可证

[麻省理工学院](https://npmcn.com/package/%40chronicstone/array-query/LICENSE) 许可证 2023-Present [赛普里安·特豪](https://github.com/ChronicStone)

## 常见问题

### @chronicstone/array-query 是什么？

一个简单和轻量级的数组查询库

### 如何安装 @chronicstone/array-query？

在项目目录运行 npm install @chronicstone/array-query，或使用 pnpm add / yarn add / bun add。

### @chronicstone/array-query 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @chronicstone/array-query 支持 ESM 还是 CommonJS？

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

### @chronicstone/array-query 可以商用吗？

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

### @chronicstone/array-query 的下载量有多少？

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

### @chronicstone/array-query 还在维护吗？

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