# @cocreate/observer 中文文档

规范地址：https://npmcn.com/package/%40cocreate/observer/

版本：2\.0\.2
npm 元数据更新时间：2026-11-07T02:46:07.828Z
中文译文更新时间：2026-11-10T05:25:03.360Z
软件包许可：AGPL-3\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40cocreate/observer
原文对照：https://npmcn.com/package/%40cocreate/observer/?lang=original
项目主页：https://cocreatejs.com/docs/observer
源码仓库：https://github.com/CoCreateJS/observer

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

- 包体积（解压后）：166 kB，15 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：2 个
- 首次发布：2021-03-26T01:44:48.534Z
- 最新版本发布：2026-11-07T02:46:07.611Z
- 近 30 天下载量：3386（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：235（近 12 个月 13 个）

## 中文简介

注册一个组件 init 函数并观察选择器( O) 。 在检测到选取器后, Init 函数会被不透视地发射 .

## 安装

```sh
npm install @cocreate/observer
```

也可以使用：`pnpm add @cocreate/observer`、`yarn add @cocreate/observer`、`bun add @cocreate/observer`

## README

# 创造观测器

注册一个组件 init 函数并观察选择器( O) 。 在检测到选取器后, Init 函数会被不透视地发射 。 把它当作我们的旋转 [游乐场!](https://cocreatejs.com/docs/observer)

![minified](https://img.badgesize.io/https://cdn.CoCreateJS.com/observer/latest/CoCreate-observer.min.js?style=flat-square&label=minified&color=orange) ![gzip](https://img.badgesize.io/https://cdn.CoCreateJS.com/observer/latest/CoCreate-observer.min.js?compression=gzip&style=flat-square&label=gzip&color=yellow) ![brotli](https://img.badgesize.io/https://cdn.CoCreateJS.com/observer/latest/CoCreate-observer.min.js?compression=brotli&style=flat-square&label=brotli) ![GitHub latest release](https://img.shields.io/github/v/release/CoCreateJS/observer?style=flat-square) ![License](https://img.shields.io/github/license/CoCreateJS/observer?style=flat-square) ![Hiring](https://img.shields.io/static/v1?style=flat-square&label=&message=Hiring&color=blueviolet)

![CoCreate-observer](https://cdn.cocreatejs.com/docs/CoCreate-observer.gif)

## [文档和演示](https://cocreatejs.com/docs/observer)

完整的指南和工作演示请参见 [贴花](https://cocreatejs.com/docs/observer)

# 目录

-   [目录](https://npmcn.com/package/%40cocreate/observer/#readme-table-of-contents)
-   [安装](https://npmcn.com/package/%40cocreate/observer/#readme-installation)
-   [代码示例](https://npmcn.com/package/%40cocreate/observer/#readme-examples)
-   [参数描述](https://npmcn.com/package/%40cocreate/observer/#readme-announcements)
-   [通知](https://npmcn.com/package/%40cocreate/observer/#readme-announcements)
-   [路线图](https://npmcn.com/package/%40cocreate/observer/#readme-roadmap)
-   [捐款](https://npmcn.com/package/%40cocreate/observer/#readme-contributing)
-   [关于](https://npmcn.com/package/%40cocreate/observer/#readme-about)
-   [许可证](https://npmcn.com/package/%40cocreate/observer/#readme-license)

□ 代码示例

# 安装

您可以使用下列方法安装 CoCreate- Observer :

**光盘N**

```html
<script src="[https://cdn.CoCreateJS.com/observer/latest/CoCreate-observer.min.js](https://cdn.CoCreateJS.com/observer/latest/CoCreate-observer.min.js)"></script>
```

**无**

```shell
$ npm i @cocreate/observer
```

**线条**

```shell
$ yarn install @cocreate/observer
```

# 代码示例

```javascript
// Initialize an observer
CoCreate.observer.init({
    name: "my-observer",
    types: ["attributes"],
    selector: ".my-element",
    callback: function (mutation) {
        console.log("Mutation occurred:", mutation);
    }
});
```

# 参数描述

这个 `init` 函数需要一个配置对象,其关键参数如下:

-   `name`:观察者独有之名.
-   `types`:需要观测的突变类型(如"childList","属性"等).
-   `selector`: 瞄准元素的CSS选择器.
-   `callback`: 检测出突变时要执行的函数.

# 通知

图书馆的所有更新都记录在我们 [变化](https://github.com/CoCreateJS/observer/blob/master/CHANGELOG.md) 财务报告和审定财务报表 [释放](https://github.com/CoCreateJS/observer/releases)。您也可以订阅电子邮件以发布和中断更改.

# 路线图

如果你对这个项目的未来方向有兴趣, 请看看我们的开放 [问题](https://github.com/CoCreateJS/observer/issues) 财务报告和审定财务报表 [拖动请求](https://github.com/CoCreateJS/observer/pulls)目前,我们的重点是改进大规模应用的性能,并增加对自定义突变类型的支持。 我们很想听听你的反馈.

# 捐款

我们欢迎各种贡献,包括错误修正、新特征、文件改进和业绩优化。 我们鼓励社区对我们的图书馆作出贡献(你甚至可能得分) [捐款](https://github.com/CoCreateJS/observer/blob/master/CONTRIBUTING.md) 详细指南.

我们希望这个图书馆由社区驱动, Coreate 领导。 我们需要你的帮助来实现这一目标。 为了帮助确保我们按正确的顺序建造正确的东西,我们请你们创造 [问题](https://github.com/CoCreateJS/observer/issues) 财务报告和审定财务报表 [拖动请求](https://github.com/CoCreateJS/observer/pulls) 或只是对现有问题进行投票或发表意见或提出请求.

我们感谢你的继续支持,谢谢!

# 关于

CoCreate-observer是一个JavaScript库,它简化了DOM(Document Object Model)中监测变化的过程. 它为检测和应对变异提供了有力而有效的方法,例如改变属性,增加或去除节点,并修改文本内容等. CoCreate-observer允许开发人员在匹配选择器的特定元素接受所指定的突变时方便地注册回调.

关键特征包括:

-   高效选择器匹配
-   开发优化性能
-   灵活配置选项
-   交叉浏览器兼容性

CoCreate-Observer是CoCreate系列开源工具的一部分,旨在加速网络开发并增强开发者的能力来更高效地构建动态互动应用程序. CoCreate旨在为现代网络发展提供一个全面和模块化的生态系统.

请发电子邮件给开发者体验团队 [这里](mailto:develop@CoCreateJS.com) 如果有任何疑问.

CoCreate-Observer由CoCreate维护和资助. CoCreate的名称和标志是CoCreate,LLC的商标.

# 许可证

该软件在GNU Affero通用公共许可证版本3(AGPLv3)和商业许可证下获得双许可证.

-   **开源使用**:用于开源项目和非商业用途,此软件可在AGPLv3下提供. AGPLv3允许您自由使用,修改并分发此软件,前提是所有修改和衍生作品也根据AGPLv3获得许可. 营业执照全文见 [自由文件](https://github.com/CoCreateJS/observer/blob/master/LICENSE)。 。 。 .
    
-   **商业用途**: 意图将这一软件用于商业目的的营利性公司和个人必须获得商业许可证。 商业执照,当你签到 API 密钥我们 [网站](https://cocreatejs.com/)。该许可证允许对软件进行专有使用和修改,而不需要AGPLv3的左取要求。 将这一软件融入专有商业产品和应用是理想的.
    

请确保您了解并遵守您的使用许可条款.

## 常见问题

### @cocreate/observer 是什么？

注册一个组件 init 函数并观察选择器\( O\) 。 在检测到选取器后, Init 函数会被不透视地发射 \.

### 如何安装 @cocreate/observer？

在项目目录运行 npm install @cocreate/observer，或使用 pnpm add / yarn add / bun add。

### @cocreate/observer 支持 TypeScript 吗？

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

### @cocreate/observer 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @cocreate/observer 可以商用吗？

@cocreate/observer 使用 AGPL-3\.0 许可。最严格的 Copyleft：除分发外，通过网络向用户提供基于它的服务也需要开源对应源码。闭源 SaaS 使用前务必评估。以上为概括，不构成法律意见，请以许可原文为准。

### @cocreate/observer 的下载量有多少？

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

### @cocreate/observer 还在维护吗？

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