# @ema/js-base 中文文档
规范地址：https://npmcn.com/package/%40ema/js-base/
版本：0\.5\.3
npm 元数据更新时间：2022-04-05T07:25:50.181Z
中文译文更新时间：2026-11-14T05:01:47.869Z
软件包许可：MIT
本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。
原始 npm 页面：https://www.npmjs.com/package/%40ema/js-base
原文对照：https://npmcn.com/package/%40ema/js-base/?lang=original
项目主页：https://github.com/ionic-team/stencil
源码仓库：https://bitbucket.org/emagine-reality/js-base
## 关键信息（来自 npm 元数据）
- 包体积（解压后）：13.6 MB，836 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：9 个
- 首次发布：2018-06-02T21:59:58.216Z
- 最新版本发布：2019-02-17T14:38:45.386Z
- 近 30 天下载量：2320（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：86（近 12 个月 0 个）
## 中文简介
Magine Reality: 基础 Javascript和 Web 组件库
## 安装
```sh
npm install @ema/js-base
```
也可以使用：`pnpm add @ema/js-base`、`yarn add @ema/js-base`、`bun add @ema/js-base`
## README
### Javascript 项目的基础库
#### Web 组件库
`@ema/js-base/dist/webcomponents.js`
- 可重复使用的 Web 组件
- 网络组件只是标准的HTML元素,所以它们在任何主要框架中工作,或者根本没有框架.
- 在许多情况下,组件可以用作传统前端框架的倒置来构建部件,微app,app等.
[](https://stenciljs.com/)
#### 通用 Javascript 库
`@ema/js-base/dist/lib/index`
- Javascript 模块和类库
- 可在所有 Javascript 工程中共享
- 配置 - api - 翻译 - util等.
分发 : npm / https / https 时间轴
[演示和文件](https://ema-js-base.firebaseapp.com/)
### 使用网络组件库
#### 脚本标签
- 将以下脚本标记放入您索引.html的首页: ``
- 然后您可以在模板、 JSX 、 html 等中任意使用网络组件.
#### 节点模块
- 运行 `npm install @ema/js-base --save`
- 设置类似此的脚本标签 `` 在索引.html的首页
- 然后可以在模板中任意使用网络组件, JSX, html等
#### 在一个启动程序中
- 运行 `npm install @ema/js-base --save`
- 添加导入到 npm 包 `import '@ema/js-base';`
- 然后可以在模板中任意使用网络组件, JSX, html等
### 使用 Javascript 模块库
- 运行 `npm install @ema/js-base --save`
- ES5的使用: `import { ConfigService, DomUtil } from '@ema/js-base/dist/lib/index'`
- ES6 用途 : `import { ConfigService, DomUtil } from '@ema/js-base/dist/collection/index'`
### Dev: 开始
克隆回转,然后运行:
```bash
npm install
npm start
```
要在开发过程中监视文件更改, 请运行 :
```bash
npm run dev
```
为了建立生产所需的组件和类别,运行:
```bash
npm run build
```
为进行组件和类的单元测试,运行:
```bash
npm test
```
需要帮忙吗? 检查一下 Stencil 文件 [这里](https://stenciljs.com/docs/my-first-component)。 。 。 .
## 常见问题
### @ema/js-base 是什么？
Magine Reality: 基础 Javascript和 Web 组件库
### 如何安装 @ema/js-base？
在项目目录运行 npm install @ema/js-base，或使用 pnpm add / yarn add / bun add。
### @ema/js-base 支持 TypeScript 吗？
支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。
### @ema/js-base 支持 ESM 还是 CommonJS？
同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。
### @ema/js-base 可以商用吗？
@ema/js-base 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。
### @ema/js-base 的下载量有多少？
根据 npm 官方下载统计，@ema/js-base 在 2026/10/14 – 2026/11/12 这 30 天内被下载 2,320 次，日均约 77 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
### @ema/js-base 还在维护吗？
最新版本 0\.5\.3 发布于 2019/02/17（7 年前）；至今共发布 86 个版本，其中过去 12 个月发布了 0 个；首次发布于 2018/06/03。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。