# @computer-use/mac-screen-capture-permissions 中文文档

规范地址：https://npmcn.com/package/%40computer-use/mac-screen-capture-permissions/

版本：1\.0\.2
npm 元数据更新时间：2025-01-24T04:44:45.022Z
中文译文更新时间：2026-11-10T14:20:07.697Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40computer-use/mac-screen-capture-permissions
原文对照：https://npmcn.com/package/%40computer-use/mac-screen-capture-permissions/?lang=original
项目主页：https://github.com/karaggeorge/mac-screen-capture-permissions#readme
源码仓库：https://github.com/karaggeorge/mac-screen-capture-permissions

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

- 包体积（解压后）：10.8 kB，10 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=8
- 运行依赖：3 个
- 首次发布：2025-01-24T04:25:46.529Z
- 最新版本发布：2025-01-24T04:44:44.754Z
- 近 30 天下载量：2568（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：3（近 12 个月 0 个）

## 中文简介

检查和请求权限以捕获屏幕, 叉子来自 karaggeorge/mac-screen-capture-permissions

## 安装

```sh
npm install @computer-use/mac-screen-capture-permissions
```

也可以使用：`pnpm add @computer-use/mac-screen-capture-permissions`、`yarn add @computer-use/mac-screen-capture-permissions`、`bun add @computer-use/mac-screen-capture-permissions`

## README

# mac-screen-capture-permissions (英语). 请检查url=值 (帮助)

> 检查和请求权限以捕获macOS上的屏幕(引入了10.15 Catalina)

## 安装

从源头构建模块需要macOS 11+ SDK,但由此产生的模块仍将运行在 <10.15,10.15和11+上.

```
$ npm install mac-screen-capture-permissions
```

## 使用量

见 [实例.js](https://github.com/karaggeorge/mac-screen-capture-permissions/blob/master/example.js) 用于使用.

```js
const {
  hasScreenCapturePermission,
  hasPromptedForPermission
} = require('mac-screen-capture-permissions');

hasPromptedForPermission();

// false

hasScreenCapturePermission();

// false

hasPromptedForPermission();

// true


// After accepting the permissions

hasScreenCapturePermission();

// true
```

## API 密码

#### `.hasScreenCapturePermission(): boolean`

当前应用程序是否拥有记录屏幕所需的权限 。 如果这是第一次尝试, 将向用户显示权限对话框 。 其后向 `hasScreenCapturePermission` 仅检查权限, 但不会显示对话框 。 如果用户拒绝了原请求, 您需要提醒他们启用系统首选项中的权限 .

这可以通过调用重置 `resetPermissions`对话框之后将再次显示 .

回返 `true` 在 macOS 版本上, 旧于 10:15 , 因为此权限没有存在

#### `.hasPromptedForPermission(): boolean`

**说明:** 只为 Electron app 工作

是否向用户显示权限对话框 。 将会是 `false` 如果你没有打电话 `hasScreenCapturePermission` 这个应用还没有,和 `true` 否则.

这可以通过调用重置 `resetPermissions`, (中文(简体) ),

回返 `false` 在 macOS 版本上, 旧于 10:15 , 因为此权限没有存在

#### `.resetPermissions({bundleId?: string}): boolean`

重设 `ScreenCapture` 权限。 它会重设权限 **全部** 应用,所以小心使用。 提供a `bundleId` (即com.apple.Terminal)只重置该应用程序的权限.

电话 `tccutil reset ScreenCapture [bundleId]`。 。 。 .

这将取消访问, 如果它之前是被允许的, 并且下次会触发权限对话框 `hasScreenCapturePermission` 名为.

回返 `true` 如果命令成功执行 `false` 否则.

回返 `false` 在 macOS 版本上, 旧于 10:15 , 因为此权限没有存在

#### `.openSystemPreferences(): Promise<void>`

在屏幕记录权限中打开安全面板下的系统首选项 .

仅在Electron Apps中提供.

返回打开窗口时解开的保证

## 许可证

麻省理工学院

## 常见问题

### @computer-use/mac-screen-capture-permissions 是什么？

检查和请求权限以捕获屏幕, 叉子来自 karaggeorge/mac-screen-capture-permissions

### 如何安装 @computer-use/mac-screen-capture-permissions？

在项目目录运行 npm install @computer-use/mac-screen-capture-permissions，或使用 pnpm add / yarn add / bun add。

### @computer-use/mac-screen-capture-permissions 支持 TypeScript 吗？

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

### @computer-use/mac-screen-capture-permissions 支持 ESM 还是 CommonJS？

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

### @computer-use/mac-screen-capture-permissions 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=8。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @computer-use/mac-screen-capture-permissions 可以商用吗？

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

### @computer-use/mac-screen-capture-permissions 的下载量有多少？

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

### @computer-use/mac-screen-capture-permissions 还在维护吗？

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