@girs/gjs

中文文档
5.6.0发布于 2026/10/28MITTypeScriptES Module构建来源已验证近 30 天下载 72.1万

GJS 类型Script Gjs 类型定义

中文使用文档
文档目录8 节
  1. 安装
  2. 使用量
  3. 全球类型
  4. 全球DOM类型
  5. 环境模块
  6. GIR 模块
  7. 套装
  8. 其他软件包

一般事务人员

version downloads/week

GJS 类型脚本定义 转写 页:1.

GJS (英语) 是GNOME的 JavaScript 运行时间 。 使用这些类型定义, 您的编辑器会知道 GTK API : 它会输入检查调用, 完成方法名称, 并显示上游 C 文档 .

安装

用 npm 安装类型定义 :

npm install @girs/gjs

使用量

和其他模块一样导入它 :

import Gjs from '@girs/gjs';

对于普通JS:

const Gjs = require('@girs/gjs');

全球类型

输入后,也可提供全球类型的GJS:

import '@girs/gjs';

print('Hello World from print');

const ByteArray = imports.byteArray;

// And so on...

全球DOM类型

一些与DOM相冲突的类型被外包,允许像Gjsify这样的框架重建DOM API而不会引起类型冲突. 明确导入:

import '@girs/gjs/dom';

console.log('Hello World from console');

const encoder = new TextEncoder();
const encoded = encoder.encode('𝓽𝓮𝔁𝓽');

setTimeout(() => {
  // ...
}, 1000);

// And so on...

这些与DOM类型相撞. 将 DOM 属性排除于您 tsconfig.json 或者说 jsconfig.json,或设置 noLib。 。 。 .

环境模块

GJS的内置 环境模块 也可以导入. 为此,你需要包括 @girs/gjs 或者说 @girs/gjs/ambient 在你身边 tsconfig 或输入点 Typescript 文件 :

index.ts数字 :

import '@girs/gjs'

tsconfig.json数字 :

{
  "compilerOptions": {
    ...
  },
  "include": ["@girs/gjs"],
  ...
}

gettext, (中文(简体) ), system 财务报告和审定财务报表 cairo 现在作为无害环境管理的进口来解决,其类型如下:

import gettext from 'gettext';
import system from 'system';
import cairo from 'cairo';

GIR 模块

如果你想有类型 G 对象回顾 模块,您必须将它们添加到您的依赖性中,并导入它们,参见这些模块的描述,例如. gtk-4.0 (单位:千美元), (中文(简体) ), gio - 2.0 (英语), (中文(简体) ), 广告 1个 财务报告和审定财务报表 还要多得多。 。 。 .

这些类型将提供给您 :

import '@girs/gjs'
import '@girs/gjs/dom'
import '@girs/gio-2.0'
import '@girs/gtk-4.0'
import '@girs/adw-1'

import Gio from 'gi://Gio?version=2.0';
import Gtk from 'gi://Gtk?version=4.0';
import Adwaita from 'gi://adw?version=1';

const button = new Gtk.Button();

// ...

套装

大多数项目都想要一个捆绑器. 兴建 是最小的东西 工作 示例目录 已经安排了其他几个.

其他软件包

所有已有的预生成软件包均可在 gjsify/类型。 。 。 .

版本与发布记录

@girs/gjs 共发布 94 个版本,首次发布于 2023/03/24;过去 12 个月发布了 43 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
5.6.0latest2026/10/2819 天前
5.5.02026/10/021 个月前
5.4.02026/09/211 个月前
5.3.02026/09/191 个月前
5.2.02026/09/152 个月前
5.1.02026/09/152 个月前

其他发布通道:next → 4.0.0-beta.5。

关于 @girs/gjs 的常见问题

@girs/gjs 是什么?

GJS 类型Script Gjs 类型定义

如何安装 @girs/gjs?

在项目目录运行 npm install @girs/gjs,或使用 pnpm add / yarn add / bun add。

@girs/gjs 支持 TypeScript 吗?

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

@girs/gjs 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@girs/gjs 可以商用吗?

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

@girs/gjs 的下载量有多少?

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

@girs/gjs 还在维护吗?

最新版本 5.6.0 发布于 2026/10/28(19 天前);至今共发布 94 个版本,其中过去 12 个月发布了 43 个;首次发布于 2023/03/24。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。