shell¶

使用默认应用程序管理文件和 URL。

进程：主进程, 渲染进程（仅非沙盒）

shell 模块提供与桌面集成相关的函数。

在用户默认浏览器中打开 URL 的示例：

const { shell } = require('electron')

shell.openExternal('https://github.com')

[!WARNING] 虽然 shell 模块可以在渲染进程中使用，但在沙盒化的渲染进程中无法正常工作。

方法¶

shell 模块具有以下方法：

shell.showItemInFolder(fullPath)¶

• fullPath 字符串

在文件管理器中显示给定文件。如果可能，选中该文件。

shell.openPath(path)¶

• url 字符串 - 在 Windows 上最多 2081 个字符。
• options 对象（可选）
• activate 布尔值（可选） macOS - 设为 true 可将打开的应用程序置于前台。默认值为 true。
• workingDirectory 字符串（可选） Windows - 工作目录。
• logUsage 布尔值（可选） Windows - 表示由用户发起的启动，该启动会启用对常用程序和其他行为的跟踪。 默认值为 false。

返回 Promise<void>

以桌面的默认方式打开给定的外部协议 URL。（例如，在用户的默认邮件代理中打开 mailto: URL。）

shell.trashItem(path)¶

• path 字符串 - 要移动到回收站的项目的路径。

返回 Promise<void> - 操作完成时解析。 如果删除请求的项目时发生错误，则拒绝。

这将路径移动到操作系统特定的回收站位置（macOS 上的废纸篓、Windows 上的回收站，以及 Linux 上桌面环境特定的位置）。

路径必须使用平台的默认路径分隔符（Windows 上为反斜杠）。请使用 node:path 模块中的 path.resolve()，以确保在所有文件系统上正确处理。

shell.beep()¶

播放提示音。

shell.writeShortcutLink(shortcutPath[, operation], options) Windows¶

• shortcutPath 字符串
• operation 字符串（可选） - 默认值为 create，可以是以下之一：
• create - 创建新快捷方式，必要时覆盖。
• update - 仅更新现有快捷方式中指定的属性。
• replace - 覆盖现有快捷方式，如果快捷方式不存在则 失败。
• options ShortcutDetails

返回 boolean - 快捷方式是否成功创建。

在 shortcutPath 处创建或更新快捷方式链接。

shell.readShortcutLink(shortcutPath) Windows¶

• shortcutPath 字符串

返回 ShortcutDetails

解析 shortcutPath 处的快捷方式链接。

当发生任何错误时，将抛出异常。