app
控制应用程序的事件生命周期。
Process: Main
下面的这个例子将会展示如何在最后一个窗口被关闭时退出应用:
const { app } = require('electron')
app.on('window-all-closed', () => {
app.quit()
})
事件
app
对象会发出以下事件:
事件: 'will-finish-launching'
当应用程序完成基础的启动的时候被触发。 在 Windows 和 Linux 中, will-finish-launching
事件与 ready
事件是相同的; 在 macOS 中,这个事件相当于 NSApplication
中的 applicationWillFinishLaunching
提示。
绝大部分情况下,你必须在ready
事件句柄中处理所有事务。
事件: 'ready'
返回:
event
EventlaunchInfo
Record<string, any> | NotificationResponse macOS
当 Electron 完成初始化时,发出一次。 在 macOS 上,如果通过通知中心启动应用程序,launchInfo
保存 NSUserNotification
的 userInfo
或 UNNotificationResponse
的信息。 你也可以通过调用 app.isReady()
来检查该事件是否已被触发,以及通过 app.whenReady()
得到一个当Electron已初始化后fulfill 的 Promise。
Note: The ready
event is only fired after the main process has finished running the first tick of the event loop. If an Electron API needs to be called before the ready
event, ensure that it is called synchronously in the top-level context of the main process.
事件: 'window-all-closed'
当所有的窗口都被关闭时触发。
如果你没有监听此事件并且所有窗口都关闭了,默认的行为是控制退出程序;但如果你监听了此事件,你可以控制是否退出程序。 如果用户按下了 Cmd + Q
,或者开发者调用了 app.quit()
,Electron 会首先关闭所有的窗口然后触发 will-quit
事件,在这种情况下 window-all-closed
事件不会被触发。
事件:'before-quit'
返回:
event
Event
在程序关闭窗口前发信号。 调用 event.preventDefault()
将阻止终止应用程序的默认行为。
注意: 如果由 autoUpdater.quitAndInstal()
退出应用程序 ,那么在所有窗口触发 close
之后 才会触发 before-quit
并关闭所有窗口。
**注:**在 Windows 系统中,如果应用程序因系统关机/重启或用户注销而关闭,那么这个事件不会被触发。
事件: 'will-quit'
返回:
event
Event
当所有窗口被关闭后触发,同时应用程序将退出。 调用 event.preventDefault()
将阻止终止应用程序的默认行为。
关于 window-all-closed
和 will-quit
事件之间的差异, 请参见 window-all-closed
事件的说明。
**注:**在 Windows 系统中,如果应用程序因系统关机/重启或用户注销而关闭,那么这个事件不会被触发。
事件: 'quit'
返回:
event
EventexitCode
Integer
在应用程序退出时发出。
**注:**在 Windows 系统中,如果应用程序因系统关机/重启或用户注销而关闭,那么这个事件不会被触发。
事件: 'open-file' macOS
返回:
event
Eventpath
string
当用户想要在应用中打开一个文件时发出。 open-file
事件通常在应用已经打开,并且系统要再次使用该应用打开文件时发出。 open-file
也会在一个文件被拖到 dock 并且还没有运行的时候发出。 请确认在应用启动的时候(甚至在 ready
事件发出前) 就对 open-file
事件进行监听。
如果你想处理这个事件,你应该调用 event.preventDefault()
。
在 Windows 系统中,你需要解析 process.argv
(在主进程中) 来获取文件路径
事件: 'open-url' macOS
返回:
event
Eventurl
string
当用户想要在应用中打开一个 URL 时发出。 你的应用程序的 Info. plist
文件必须在 CFBundleURLTypes
这个key中定义 url scheme, 并将 NSPrincipalClass
设置为 AtomApplication
。
As with the open-file
event, be sure to register a listener for the open-url
event early in your application startup to detect if the application is being opened to handle a URL. If you register the listener in response to a ready
event, you'll miss URLs that trigger the launch of your application.
事件: 'activate' macOS
返回:
event
EventhasVisibleWindows
boolean
当应用被激活时发出。 各种操作都可以触发此事件, 例如首次启动应用程序、尝试在应用程序已运行时或单击应用程序的坞站或任务栏图标时重新激活它。
事件: 'did-become-active' macOS
返回:
event
Event
Emitted when the application becomes active. This differs from the activate
event in that did-become-active
is emitted every time the app becomes active, not only when Dock icon is clicked or application is re-launched. It is also emitted when a user switches to the app via the macOS App Switcher.
事件: 'did-rele-active' macOS
返回:
event
Event
Emitted when the app is no longer active and doesn’t have focus. This can be triggered, for example, by clicking on another application or by using the macOS App Switcher to switch to another application.
Event: 'continue-activity' macOS
返回:
event
Eventtype
string-标识活动的字符串。 Maps toNSUserActivity.activityType
.userInfo
unknown - 包含另一个设备上activity存储的应用特定状态。details
ObjectwebpageURL
string (可选) - 如果可用,可识别另一设备上活动访问的网页的 URL 的字符串。
Emitted during Handoff when an activity from a different device wants to be resumed. 如果你想处理这个事件,你应该调用 event.preventDefault()
。
只有具有支持相应的活动类型并且相同的开发团队 ID 作为启动程序时,用户行为才会进行。 所支持活动类型已在应用的 Info.plist
中的 NSUserActivityTypes
里明确定义。
Event: 'will-continue-activity' macOS
返回:
event
Eventtype
string-标识活动的字符串。 Maps toNSUserActivity.activityType
.
Emitted during Handoff before an activity from a different device wants to be resumed. 如果你想处理这个事件,你应该调用 event.preventDefault()
。
Event: 'continue-activity-error' macOS
返回:
event
Eventtype
string-标识活动的字符串。 Maps toNSUserActivity.activityType
.error
string - 详细的错误信息
Emitted during Handoff when an activity from a different device fails to be resumed.
Event: 'activity-was-continued' macOS
返回:
event
Eventtype
string-标识活动的字符串。 Maps toNSUserActivity.activityType
.userInfo
unknown - 包含activity存储的应用特定状态。
Emitted during Handoff after an activity from this device was successfully resumed on another one.
Event: 'update-activity-state' macOS
返回:
event
Eventtype
string-标识活动的字符串。 Maps toNSUserActivity.activityType
.userInfo
unknown - 包含activity存储的应用特定状态。
Emitted when Handoff is about to be resumed on another device. 如果需要更新要传输的状态,你应该立即调用 event.preventDefault()
, 构造新的 userInfo
字典,并及时调用 app.updateCurrentActiviy()
。 否则,操作会失败,并且触发 continue-activity-error
事件: 'new-window-for-tab' macOS
返回:
event
Event
当用户点击原生的macOS新标签按钮时触发。 只有在当前 BrowserWindow
有 tabbingIdentifier
时,新建tab按钮才可见。
事件: 'browser-window-blur'
返回:
event
Eventwindow
BrowserWindow
Emitted when a browserWindow gets blurred.
事件: 'browser-window-focus'
返回:
event
Eventwindow
BrowserWindow
Emitted when a browserWindow gets focused.
事件: 'browser-window-created'
返回:
event
Eventwindow
BrowserWindow
Emitted when a new browserWindow is created.
事件: 'web-contents-created'
返回:
event
EventwebContents
WebContents
Emitted when a new webContents is created.
事件: 'certificate-error'
返回:
event
EventwebContents
WebContentsurl
stringerror
string - 错误码certificate
Certificatecallback
FunctionisTrusted
boolean - 是否将证书视为受信任。
isMainFrame
boolean
当对 url
的 certificate
证书验证失败的时候发出。如果需要信任这个证书,你需要阻止默认行为 event.preventDefault()
并且调用 callback(true)
。
const { app } = require('electron')
app.on('certificate-error', (event, webContents, url, error, certificate, callback) => {
if (url === 'https://github.com') {
// Verification logic.
event.preventDefault()
callback(true)
} else {
callback(false)
}
})
事件: 'select-client-certificate'
返回:
event
EventwebContents
WebContentsurl
URLcertificateList
Certificate[]callback
Functioncertificate
Certificate (optional)
当一个客户证书被请求的时候发出。
url
指的是请求客户端认证的网页地址,调用 callback
时需要传入一个证书列表中的证书。 需要通过调用 event.preventDefault()
来防止应用自动使用第一个证书进行验证。
const { app } = require('electron')
app.on('select-client-certificate', (event, webContents, url, list, callback) => {
event.preventDefault()
callback(list[0])
})
事件: "login"
返回:
event
EventwebContents
WebContents (optional)authenticationResponseDetails
Objecturl
URLpid
number
authInfo
ObjectisProxy
booleanscheme
stringhost
stringport
Integerrealm
string
callback
Functionusername
string (可选)password
string (可选)
Emitted when webContents
or Utility process wants to do basic auth.
默认行为是取消所有身份验证。 默认行为是取消所有的验证行为,如果需要重写这个行为,你需要用 event.preventDefault()
来阻止默认行为,并且使用 callback(username, password)
来验证。
const { app } = require('electron')
app.on('login', (event, webContents, details, authInfo, callback) => {
event.preventDefault()
callback('username', 'secret')
})
当 callback
在缺少用户名和密码的时候被调用,身份验证请求将被取消,同时将返回身份验证错误到页面。
事件: 'gpu-info-update'
每当有 GPU 信息更新时触发。
事件: 'render-process-gone'
返回:
event
EventwebContents
WebContentsdetails
RenderProcessGoneDetails
渲染器进程意外消失时触发。 这种情况通常因为进程崩溃或被杀死。
事件: 'child-process-gone'
返回:
event
Eventdetails
Objecttype
string - 进程类型。 以下值之一:Utility
Zygote
Sandbox helper
GPU
Pepper Plugin
Pepper Plugin Broker
Unknown
reason
string - 子进程结束的原因。 可选值:clean-exit
- 以零为退出代码退出的进程abnormal-exit
- 以非零退出代码退出的进程killed
- 进程发送一个SIGTERM,否则是被外部杀死的。crashed
- 进程崩溃oom
- 进程内存不足launch-failed
- 进程从未成功启动integrity-failure
- 窗口代码完整性检查失败
exitCode
number - The exit code for the process (e.g. status from waitpid if on POSIX, from GetExitCodeProcess on Windows).serviceName
string (可选) - 进程的非本地化名称。name
string (可选) - 进程的名称。 功能性示例:Audio Service
,Content Decryption Module Service
,Network Service
,Video Capture
, 等等。
子进程意外消失时触发。 这种情况通常因为进程崩溃或被杀死。 子进程不包括渲染器进程。
事件: "accessibility-support-changed" _ macOS _ _ Windows _
返回:
event
EventaccessibilitySupportEnabled
boolean - 当开启了 Chrome 辅助功能支持为true
,否则为false
。
当 Chrome 的辅助功能状态改变时触发。 当启用或禁用辅助技术时将触发此事件,例如屏幕阅读器 。 查看更多详情 https://www.chromium.org/developers/design-documents/accessibility
事件:'session-created'
返回:
session
Session
当 Electron创建了一个新的 session
后被触发.
const { app } = require('electron')
app.on('session-created', (session) => {
console.log(session)
})
事件: 'second-instance'
返回:
event
Eventargv
string[] - 第二实例命令行参数的数组。workingDirectory
string - 第二实例的工作目录。additionalData
unknown - 第二个实例发送过来的额外的 JSON 对象
当第二个实例被执行并且调用 app.requestSingleInstanceLock()
时,这个事件将在你的应用程序的首个实例中触发
argv
是第二个实例的命令行参数的数组, workingDirectory
是这个实例当前工作目录。 通常, 应用程序会激活窗口并且取消最小化来响应。
Note: argv
will not be exactly the same list of arguments as those passed to the second instance. The order might change and additional arguments might be appended. If you need to maintain the exact same arguments, it's advised to use additionalData
instead.
注意: 如果第二个实例是由不同于第一个实例的用户启动的。 argv
数组不包含参数。
保证在 app
的 ready
事件发出后发出此事件。
注意: 额外的命令行参数可能是被 Chromium 添加的,例如 --original-process-start-time
。
方法
app
对象具有以下方法:
** 注意: **某些方法仅在特定的操作系统上可用, 这些方法会被标记出来。
app.quit()
尝试关闭所有窗口 将首先发出 before-quit
事件。 如果所有窗口都已成功关闭, 则将发出 will-quit
事件, 并且默认情况下应用程序将终止。
此方法会确保执行所有beforeunload
和 unload
事件处理程序。 可以在退出窗口之前的beforeunload
事件处理程序中返回false
取消退出。
app.exit([exitCode])
exitCode
Integer (可选)
使用 exitCode
立即退出。 exitCode
默认为0。
所有窗口都将立即被关闭,而不询问用户,而且 before-quit
和 will-quit
事件也不会被触发。
app.relaunch([options])
从当前实例退出,重启应用。
默认情况下,新的实例将会使用和当前实例相同的工作目录以及命令行参数。 当设置了 args
参数时, args
将作为命令行参数传递。 当设置了 execPath
,execPath
将被执行以重新启动,而不是当前的应用程序。
请注意, 此方法在执行时不会退出当前的应用程序, 你需要在调用 app.relaunch
方法后再执行 app. quit
或者 app.exit
来让应用重启。
当 app.relaunch
被多次调用时,多个实例将在当前实例退出后启动。
立即重启当前实例并向新的实例添加新的命令行参数的示例:
const { app } = require('electron')
app.relaunch({ args: process.argv.slice(1).concat(['--relaunch']) })
app.exit(0)
app.isReady()
如果 Electron 已完成初始化返回 boolean
- true
,否则 false
。 另见 app.whenReady()
。
app.whenReady()
返回 Promise<void>
- 当Electron 初始化完成。 可用作检查 app.isReady()
的方便选择,假如应用程序尚未就绪,则订阅ready
事件。
app.focus([options])
在 Linux 上,使第一个可见窗口获得焦点。 在 macOS上,将应用程序变成激活的app。 在 Windows上,使应用程序的第一个窗口获得焦点。
你应该尽可能少地使用 steal
选项。
app.hide()
macOS
隐藏所有的应用窗口,不是最小化.
app.isHidden()
macOS
返回 boolean
- 如果应用的所有窗口都被隐藏(比如在 MacOS 系统下使用了 Command-H
快捷键)则为 true
,否则返回 false
。
app.show()
macOS
显示隐藏后的应用程序窗口。 不会使它们自动获得焦点。
app.setAppLogsPath([path])
path
string (可选) - 自定义日志路径。 必须是绝对路径。
设置或创建一个您的应用程序日志目录,然后可以通过 app.getPath()
或 app.setPath(pathName, newPath)
进行操作。
调用 app.setAppLogsPath()
却没有指定 path
参数将导致此目录在 macOS 下被设置为 ~/Library/Logs/YourAppName
;在 Linux 和_Windows_ 下将被设置到 userData
目录中。
app.getAppPath()
返回 string
- 当前应用程序目录。
app.getPath(name)
name
string - 您可以通过名称请求以下路径:home
用户的 home 文件夹(主目录)appData
每个用户的应用程序数据目录,默认情况下指向:%APPDATA%
Windows 中$XDG_CONFIG_HOME
or~/.config
Linux 中~/Library/Application Support
macOS 中
userData
储存你应用程序配置文件的文件夹,默认是appData
文件夹附加应用的名称 按照习惯用户存储的数据文件应该写在此目录,同时不建议在这写大文件,因为某些环境会备份此目录到云端存储。sessionData
此目录存储由Session
生成的数据,例如 localStorage,cookies,磁盘缓存,下载的字典,网络 状态,开发者工具文件等。 默认为userData
目录。 Chromium 可能在此处写入非常大的磁盘缓存,因此,如果您的应用不依赖于浏览器存储(如 localStorage 或 cookie)来保存用户数据,建议将此目录设置为其他位置,以避免污染userData
目录。temp
临时文件夹exe
当前的可执行文件module
Thelibchromiumcontent
库desktop
当前用户的桌面文件夹documents
用户文档目录的路径downloads
用户下载目录的路径music
用户音乐目录的路径pictures
用户图片目录的路径videos
用户视频目录的路径recent
用户最近文件的目录 (仅限 Windows)。logs
应用程序的日志文件夹crashDumps
崩溃转储文件存储的目录。
返回 string
- 与 name
关联的目录或文件的路径。 失败会抛出一个Error
。
If app.getPath('logs')
is called without called app.setAppLogsPath()
being called first, a default log directory will be created equivalent to calling app.setAppLogsPath()
without a path
parameter.
app.getFileIcon(path[, options])
path
string
Returns Promise<NativeImage>
- fulfilled with the app's icon, which is a NativeImage.
读取文件的关联图标。
在 Windows 上,有 2 种图标:
- 与某些文件扩展名相关联的图标, 比如
. mp3
,. png
等。 - 文件本身就带图标,像是
.exe
,.dll
,.ico
在 Linux 和 macOS 上,图标依赖于与应用程序关联的文件 mime 类型。
app.setPath(name, path)
name
stringpath
string
重写 name
的路径为 path
,一个特定的文件夹或者文件。 如果路径指向一个不存在的目录,则抛出一个 Error
。 在这种情况下,目录应该以 fs.mkdirSync
或类似的方式创建。
name
参数只能使用 app.getPath
定义过的 name
默认, 网页的 cookies 和 缓存 将存储在 sessionData
目录下。 如果要更改此位置,你必须在 app
模块的 ready
事件之前重写 sessionData
路径。
app.getVersion()
返回 string
- 加载应用程序的版本号。 如果应用程序的 package. json
文件中找不到版本号, 则返回当前包或者可执行文件的版本。
app.getName()
返回 string
- 当前应用程序的名称,即为该应用程序 package.json
文件的 name 字段。
根据 npm 的命名规则, 通常 package.json
中的 name
字段是一个短的小写字符串。 通常还应该指定一个 productName
字段, 是首字母大写的完整名称,用于表示应用程序的名称。Electron 会优先使用这个字段作为应用名。
app.setName(name)
name
string
设置当前应用程序的名字
注意: 此函数会覆盖Electron内部使用的名称;它不会影响操作系统使用的名称。
app.getLocale()
返回 string
- 当前应用程序区域,使用 Chromium's l10n_util
库获取。 可能返回区域的值 文档 here。
To set the locale, you'll want to use a command line switch at app startup, which may be found here.
注意: 当分发打包的应用时,也必须打包 locales
文件夹。
注意: 该 API 必须在 ready
事件触发后调用。
**注意:**要查看此 API 与其他语言环境和语言 API 相比的示例返回值,请参阅 app.getPreferredSystemLanguages()
。
app.getLocaleCountryCode()
返回 string
- 用户操作系统区域设置的双字母 ISO 3166 国家代码。 该值取自本地操作系统 API。
注意: 当无法检测本地国家代码时,它返回空字符串。
app.getSystemLocale()
返回 string
- 当前系统区域。 在 Windows 和 Linux,使用 Chromium's i18n
库来获取。 在 macOS 上,改为使用 [NSLocale currentLocale]
。 为了获得用户当前的系统语言(这种语言并不总是与本地语言相同),最好使用 app.getPreferredSystemLanguages()
。
不同的操作系统也以不同的方式使用区域数据:
- Windows 11 使用数字、日期和时间的区域格式。
- macOS Monterey 使用该区域来格式化数字、日期、时间以及选择要使用的货币符号。
因此,此 API 可用于选择用于在日历应用中呈现日期和时间的格式等目的,尤其是当开发人员希望格式与操作系统一致时。
注意: 该 API 必须在 ready
事件触发后调用。
**注意:**要查看此 API 与其他语言环境和语言 API 相比的示例返回值,请参阅 app.getPreferredSystemLanguages()
。
app.getPreferredSystemLanguages()
返回 string[]
- 从最喜欢到最不喜欢的用户首选系统语言,包括国家代码(如果适用)。 用户可以在 Windows 或 macOS 上通过语言和区域设置、修改、添加此列表。
API 在 Windows 上使用 GlobalizationPreferences
(回退到 GetSystemPreferredUILanguages
),在 macOS 上使用 \[NSLocale preferredLanguages\]
,在 Linux 上使用 g_get_language_names
。
此 API 可用于决定以何种语言呈现应用程序。
以下是具有不同配置的各种语言和语言环境 API 的返回值的一些示例:
对于 Windows,应用程序区域设置为德语,区域格式为芬兰语(芬兰),首选系统语言从高到低依次为法语(加拿大)、英语(美国)、简体中文(中国)、芬兰语和西班牙语 (拉丁美洲):
app.getLocale() // 'de'
app.getSystemLocale() // 'fi-FI'
app.getPreferredSystemLanguages() // ['fr-CA', 'en-US', 'zh-Hans-CN', 'fi', 'es-419']
在 macOS 上,应用程序区域设置为德语,区域为芬兰,首选系统语言从高到低依次为法语(加拿大)、英语(美国)、简体中文和西班牙语(拉丁美洲):
app.getLocale() // 'de'
app.getSystemLocale() // 'fr-FI'
app.getPreferredSystemLanguages() // ['fr-CA', 'en-US', 'zh-Hans-FI', 'es-419']
两种操作系统的可用语言和地区以及可能的返回值都不同。
从上面的示例可以看出,在 Windows 上,首选系统语言可能没有国家代码,并且首选系统语言之一与用于区域格式的语言相对应。 在 macOS 上,区域更多地用作默认国家代码:用户无需将芬兰语作为首选语言即可将芬兰用作区域,国家代码 FI
用作国家 语言名称中没有关联国家/地区的首选系统语言的代码。
app.addRecentDocument(path)
macOS Windows
path
string
将此 path
添加到最近打开的文件列表中
此列表由操作系统管理。 在Windows上,您可以从任务栏访问此列表,在macOS上,您可以从dock菜单访问。
app.clearRecentDocuments()
macOS Windows
清空最近打开的文档列表
app.setAsDefaultProtocolClient(protocol[, path, args])
protocol
string - 协议的名称,不带://
。 例如,如果你希望应用处理electron://
链接,请以electron
为参数调用此方法。path
string (可选) Windows - Electron可执行文件路径。 默认为process.execPath
args
string[] (可选) Windows - 传递给可执行文件的参数。 默认为空数组。
返回 boolean
- 是否调用成功。
将当前可执行文件的设置为协议(也就是 URI scheme) 的默认处理程序。 该方法允许你将应用更深入地集成到操作系统中。 一旦注册了,所有 your-protocol://
开头的链接将使用当前可执行文件打开。 整个链接,包括协议部分,将作为参数传递给你的应用程序。
** 注意: **在 macOS 上,您只能注册已添加到应用程序的 info.plist
中的协议,这个列表在运行时不能修改。 然而,你可以在构建时通过 Electron Forge, Electron Packager, 或通过文本编辑器编辑info.plist
文件的方式修改。 有关详细信息,请参阅 Apple's documentation
注意: 在 Windows Store 环境下(当打包为 appx
),此 API 对所有调用都返回 true
,但它设置的注册表项将无法通过其他应用程序访问。 为了注册你的 Windows Store 应用程序作为默认的协议处理程序,你必须 在你的清单中声明协议。
API 在内部使用 Windows 注册表和 LSSetDefaultHandlerForURLScheme
。
app.removeAsDefaultProtocolClient(protocol[, path, args])
macOS Windows
protocol
string - 协议的名称,不带://
。path
string (可选) _ Windows _-默认为process.execPath
args
string[] (可选) Windows - 默认为空数组
返回 boolean
- 是否调用成功。
此方法检查当前可执行程序是否是协议(也就是URI scheme) 的默认处理程序。 如果是,则会将应用移除默认处理器。
app.isDefaultProtocolClient(protocol[, path, args])
protocol
string - 协议的名称,不带://
。path
string (可选) _ Windows _-默认为process.execPath
args
string[] (可选) Windows - 默认为空数组
返回 boolean
- 当前可执行程序是否是协议(也就是URI scheme) 的默认处理程序。
** 注意: **在macOS上, 您可以使用此方法检查应用程序是否已注册为协议的默认协议处理程序。 同时可以通过查看 ~/Library/Preferences/com.apple.LaunchServices.plist
来确认。 有关详细信息,请参阅 Apple's documentation
API 在内部使用 Windows 注册表和 LSCopyDefaultHandlerForURLScheme
。
app.getApplicationNameForProtocol(url)
url
string - 要检查的协议名称的 URL。 不同于家族中的其他方法,该方法接收至少包含://
(例如:https://
)的完整URL。
返回 string
- 处理协议的应用程序名称,或如果没有处理程序的空 字符串。 例如,如果Electron 是这个URL的默认 处理程序,那么在 Windows 和 Mac 上,这个返回值可以是 Electron
。 然而,不要依赖于无法保证保持不变的精确格式。 Linux 上期望不同格式,可能带有 .desktop
后缀。
此方法返回URL协议(也就是URI scheme) 的默认处理器的应用程序名称。
app.getApplicationInfoForProtocol(url)
macOS Windows
url
string - 要检查的协议名称的 URL。 不同于家族中的其他方法,该方法接收至少包含://
(例如:https://
)的完整URL。
返回 Promise<Object>
- resolve包含以下内容的object:
icon
NativeImage - 处理协议的应用程序的显示图标。path
string - 处理协议的应用程序的安装路径。name
string - 处理协议的应用程序的显示名称。
此方法返回包含应用程序名称,图标和默认协议处理器路径(也就是URI scheme) 的Promise。
app.setUserTasks(tasks)
Windows
tasks
Task[] - Array ofTask
objects
Windows上添加 tasks
到 Jump List的 Tasks 类别。
tasks
is an array of Task objects.
返回 boolean
- 是否调用成功。
** 注意: **如果您想自定义跳转列表, 请使用 aapp.setJumpList(categories)
来代替。
app.getJumpListSettings()
Windows
返回 Object
:
minItems
Integer - 将在跳转列表中显示项目的最小数量(有关此值的更详细描述,请参阅 MSDN docs).removedItems
JumpListItem[] - Array ofJumpListItem
objects that correspond to items that the user has explicitly removed from custom categories in the Jump List. 这些项目不能在 next 调用app.setJumpList()
时重新添加到跳转列表中, Windows不会显示任何包含已删除项目的自定义类别.
app.setJumpList(categories)
Windows
categories
JumpListCategory[] |null
- Array ofJumpListCategory
objects.
返回 string
设置或删除应用程序的自定义跳转列表,并返回以下字符串之一:
ok
- 没有出现错误error
- 发生一个或多个错误,启用运行日志记录找出可能的原因。invalidSeparatorError
- 已尝试在跳转列表中向自定义类别添加分隔符。 分隔符只允许在标准Tasks
类别下出现。fileTypeRegistrationError
-尝试向自定义跳转列表添加一个文件链接,但是该应用未注册处理该应用类型customCategoryAccessDeniedError
- 由于用户隐私或策略组设置,自定义类别无法添加到跳转列表。
如果 categories
的值为 null
, 之前设定的自定义跳转列表(如果存在) 将被替换为标准的应用跳转列表(由windows生成)
注意: 如果一个 JumpListCategory
对象既没有设置 type
属性,也没有设置 name
属性,则假设其 type
是 tasks
。 如果设置了 name
属性, 但省略了 type
属性, 则假定 type
为 custom
。
注意: 用户可以从自定义类别中移除项目, after 调用 app.setJumpList(categories)
方法之前, Windows不允许删除的项目添加回自定义类别。 尝试提前将删除的项目重新添加 到自定义类别中,将导致整个自定义类别被隐藏。 删除的项目可以使用 app.getJumpListSettings()
获取。
注意: 跳列表项目 description
属性的最大长度为 260 个字符。 超过这个限制,当前项将不会被添加到跳转列表,也不会被展示。
下面是创建自定义跳转列表的一个非常简单的示例:
const { app } = require('electron')
app.setJumpList([
{
type: 'custom',
name: 'Recent Projects',
items: [
{ type: 'file', path: 'C:\\Projects\\project1.proj' },
{ type: 'file', path: 'C:\\Projects\\project2.proj' }
]
},
{ // has a name so `type` is assumed to be "custom"
name: 'Tools',
items: [
{
type: 'task',
title: 'Tool A',
program: process.execPath,
args: '--run-tool-a',
iconPath: process.execPath,
iconIndex: 0,
description: 'Runs Tool A'
},
{
type: 'task',
title: 'Tool B',
program: process.execPath,
args: '--run-tool-b',
iconPath: process.execPath,
iconIndex: 0,
description: 'Runs Tool B'
}
]
},
{ type: 'frequent' },
{ // has no name and no type so `type` is assumed to be "tasks"
items: [
{
type: 'task',
title: 'New Project',
program: process.execPath,
args: '--new-project',
description: 'Create a new project.'
},
{ type: 'separator' },
{
type: 'task',
title: 'Recover Project',
program: process.execPath,
args: '--recover-project',
description: 'Recover Project'
}
]
}
])
app.requestSingleInstanceLock([additionalData])
additionalData
Record<any, any> (optional) - A JSON object containing additional data to send to the first instance.
返回 boolean
此方法的返回值表示你的应用程序实例是否成功取得了锁。 如果它取得锁失败,你可以假设另一个应用实例已经取得了锁并且仍旧在运行,并立即退出。
即: 如果当前进程是应用程序的主要实例,则此方法返回true
,同时你的应用会继续运行。 如果当它返回 false
如果你的程序没有取得锁,它应该立刻退出,并且将参数发送给那个已经取到锁的进程。
在 macOS 上, 当用户尝试在 Finder 中打开您的应用程序的第二个实例时, 系统会通过发出 open-file
和 open-url
事件来自动强制执行单个实例,。 但是当用户在命令行中启动应用程序时, 系统的单实例机制将被绕过, 您必须手动调用此方法来确保单实例。
在第二个实例启动时激活主实例窗口的示例:
const { app, BrowserWindow } = require('electron')
let myWindow = null
const additionalData = { myKey: 'myValue' }
const gotTheLock = app.requestSingleInstanceLock(additionalData)
if (!gotTheLock) {
app.quit()
} else {
app.on('second-instance', (event, commandLine, workingDirectory, additionalData) => {
// 输出从第二个实例中接收到的数据
console.log(additionalData)
// 有人试图运行第二个实例,我们应该关注我们的窗口
if (myWindow) {
if (myWindow.isMinimized()) myWindow.restore()
myWindow.focus()
}
})
app.whenReady().then(() => {
myWindow = new BrowserWindow({})
myWindow.loadURL('https://electronjs.org')
})
}
app.hasSingleInstanceLock()
返回 boolean
此方法返回你的应用实例当前是否持有单例锁。 你可以通过 app.requestSingleInstanceLock()
请求锁,并且通过 app.releaseSingleInstanceLock()
释放锁。
app.releaseSingleInstanceLock()
释放所有由 requestSingleInstanceLock
创建的锁。 该方法将允许应用程序的多个实例再次并行运行。
app.setUserActivity(type, userInfo[, webpageURL])
macOS
type
string - 活动的唯一标识。 Maps toNSUserActivity.activityType
.userInfo
any - 存储供其他设备使用的特定应用状态。webpageURL
string (可选) - 如果在恢复的设备上没有安装合适的应用,则会在浏览器中加载的网页。 协议必须是http
或https
。
创建一个 NSUserActivity
并将其设置为当前活动。 该活动之后可以Handoff到另一个设备。
app.getCurrentActivityType()
macOS
返回 string
- 正在运行的 activity 的类型
app.invalidateCurrentActivity()
macOS
使当前的 Handoff 用户活动无效。
app.resignCurrentActivity()
macOS
将当前 Handoff 用户活动标记为非活动,但不使其失效。
app.updateCurrentActivity(type, userInfo)
macOS
type
string - 活动的唯一标识。 Maps toNSUserActivity.activityType
.userInfo
any - 存储供其他设备使用的特定应用状态。
当其类型与 type
匹配时更新当前活动, 将项目从 用户信息
合并到其当前 用户信息
字典中。
app.setAppUserModelId(id)
Windows
id
字符串
改变当前应用的 Application User Model ID 为 id
.
app.setActivationPolicy(policy)
macOS
policy
string - 可以是'regular', 'accessory', 或 'prohibited'。
为给定应用设置激活策略。
激活策略类型:
- 'regulatory ' - 应用程序以普通应用出现在 Dock 中,可能有一个用户界面。
- 'accessory' - 应用程序不会出现在 Dock 中,没有菜单栏, 但它可能会被程序或在点击其某个窗口时激活。
- 'prohibited' - 应用程序不会出现在 Dock 中,可能无法创建窗口或被激活。
app.importCertificate(options, callback)
Linux
选项
对象certificate
string - pkcs12 文件的路径password
string - 证书的密码
callback
Functionresult
Integer - 导入结果
将 pkcs12 格式的证书导入到平台证书库。 使用导入操作的 callback
调用返回 result
,值 0
表示成功,而任何其他值表示失败,参照 Chromium net_error_list 。
app.configureHostResolver(options)
选项
对象enableBuiltInResolver
boolean (可选) - 当前内置主机解析器是否首选使用 getaddrinfo 。 当启用时,内置解析器将尝试使用系统的DNS设置来进行DNS查询本身。 MacOS 默认开启,Windows 系统和 Linux 系统默认关闭secureDnsMode
string (optional) - Can be 'off', 'automatic' or 'secure'. 配置 DNS-over-HTTP 模式。 When 'off', no DoH lookups will be performed. When 'automatic', DoH lookups will be performed first if DoH is available, and insecure DNS lookups will be performed as a fallback. When 'secure', only DoH lookups will be performed. Defaults to 'automatic'.secureDnsServers
string[] (可选) - 一个 DNS-over-HTTP 服务器模板列表。 更多模板格式详见 RFC8484 § 3 。 大多数服务器支持 POST 方法; 此类服务器的模板只需 URI 即可。 需要注意的是 某些 DNS 提供商, 解析器将自动升级到 DoH 除非 DoH 明确禁用。DoH 服务提供列表为空也适用。enableAdditionalDnsQueryTypes
boolean (可选) - 控制着是否添加额外的 DNS 查询类型,比如当通过不安全的 DNS 发出请求时,除传统的 A and AAAA 查询是否允许使用 HTTPS (DNS 类型 65) 。 对安全的DNS没有任何效果,因为它总是允许附加类型。 默认值为 true。
配置主机解析器 (DNS 和 DNS-over-HTTPS). 默认情况下,将使用下列解析器,按顺序排列:
- DNS-over-HTTPS, 如果 DNS 提供商可用
- 内置解析器 (默认 macOS 系统自动开启)
- 系统解析器 (比如
getaddrinfo
).
这里可以配置为直接使用未加密 DNS (secureDnsMode: "secure"
), 或者禁用 DNS-over-HTTPS (secureDnsMode: "off"
). 也可以启用或禁用内置解析器
禁用安全 DNS 需要你指定 secureDnsMode
为 "secure"
. 如果你配置了, 你需要保证提供一个 DNS-over-HTTPS 服务器列表,防止用户的DNS配置没有提供DoH解析器支持.
const { app } = require('electron')
app.whenReady().then(() => {
app.configureHostResolver({
secureDnsMode: 'secure',
secureDnsServers: [
'https://cloudflare-dns.com/dns-query'
]
})
})
此 API 必须在 ready
事件触发后调用
app.disableHardwareAcceleration()
禁用当前应用程序的硬件加速。
这个方法只能在应用程序准备就绪(ready)之前调用。
app.disableDomainBlockingFor3DAPIs()
默认情况下, 如果 GPU 进程频繁崩溃, Chromium 会禁用 3D API (例如 WebGL) 直到在每个域的基础上重新启动。 这个函数会禁用该行为。
这个方法只能在应用程序准备就绪(ready)之前调用。
app.getAppMetrics()
Returns ProcessMetric[]: Array of ProcessMetric
objects that correspond to memory and CPU usage statistics of all the processes associated with the app.
app.getGPUFeatureStatus()
Returns GPUFeatureStatus - The Graphics Feature Status from chrome://gpu/
.
注意: 此信息仅在 gpu-info-update
事件触发后才可用。
app.getGPUInfo(infoType)
infoType
string - 缩放方向,可能是basic
或complete
。
返回 Promise<unknown>
对于infoType
等于complete
: Promise 将包含所有GPU信息的Object
正如 chromium's GPUInfo object。 这包括 chrome://gpu
页面上显示的版本和驱动程序信息。
对于infoType
等于basic
: Promise 至少包含当请求complete
时的属性Object
。 下面是一个基础响应示例:
{
auxAttributes:
{
amdSwitchable: true,
canSupportThreadedTextureMailbox: false,
directComposition: false,
directRendering: true,
glResetNotificationStrategy: 0,
inProcessGpu: true,
initializationTime: 0,
jpegDecodeAcceleratorSupported: false,
optimus: false,
passthroughCmdDecoder: false,
sandboxed: false,
softwareRendering: false,
supportsOverlays: false,
videoDecodeAcceleratorFlags: 0
},
gpuDevice:
[{ active: true, deviceId: 26657, vendorId: 4098 },
{ active: false, deviceId: 3366, vendorId: 32902 }],
machineModelName: 'MacBookPro',
machineModelVersion: '11.5'
}
如果只需要 vendorId
或 deviceId
等基本信息,则应优先使用 basic
。
app.setBadgeCount([count])
Linux macOS
count
Integer (可选) - 如果传入值,则将角标设置为所传入值,否则,在 macOS 上显示一个普通的白点(例如:通知数量未知)。 在 Linux 上,如果没有传入值,角标将不会显示。
返回 boolean
- 是否调用成功。
为当前应用设置计数器角标。 将计数设置为 0
将隐藏角标。
在 macOS 上,它会在dock 图标上显示。 在 Linux 上,它只适用于 Unity 启动器。
注意: Unity 启动器需要一个 .desktop
文件才能工作。 欲了解更多信息, 请阅读 Unity integration 文档。
Note: On macOS, you need to ensure that your application has the permission to display notifications for this method to work.
app.getBadgeCount()
Linux macOS
Returns Integer
- 获取计数器提醒(badge) 中显示的当前值
app.isUnityRunning()
Linux
返回 boolean
- 当前桌面环境是否是 Unity 启动器。
app.getLoginItemSettings([options])
macOS Windows
如果你为 app. setLoginItemSettings
提供path
和 args
选项,那么你需要在这里为 openAtLogin
设置相同的参数已确保正确的设置。
返回 Object
:
openAtLogin
boolean - 如果应用程序设置为在登录时打开, 则为true
openAsHidden
boolean macOS Deprecated -true
if the app is set to open as hidden at login. This does not work on macOS 13 and up.wasOpenedAtLogin
boolean macOS -true
if the app was opened at login automatically.wasOpenedAsHidden
boolean macOS Deprecated -true
if the app was opened as a hidden login item. 这表示应用程序在启动时不应打开任何窗口。 This setting is not available on MAS builds or on macOS 13 and up.restoreState
boolean macOS Deprecated -true
if the app was opened as a login item that should restore the state from the previous session. This indicates that the app should restore the windows that were open the last time the app was closed. This setting is not available on MAS builds or on macOS 13 and up.status
string macOS - can be one ofnot-registered
,enabled
,requires-approval
, ornot-found
.executableWillLaunchAtLogin
boolean Windows -true
应用程序被设置为在登录时打开,并且其启动项未停用。 该属性与openAtLogin
不同,因为它忽略了args
选项,如果给定的可执行程序在登录时启动并带有 任意 参数,此属性将为true。launchItems
Object[] Windowsname
string Windows - 注册表项的名称值。path
string Windows - 与注册表条目相对应的应用可执行程序。args
string[] Windows - 传递到可执行文件的命令行参数。scope
string Windows -user
或machine
之一。 指示注册表条目是否处于HKEY_CURRENT USER
或HKEY_LOCAL_MACHINE
下。enabled
boolean Windows -true
如果应用注册表项已获得启动批准,此时在任务管理器和 Windows 设置中显示为enabled
。
app.setLoginItemSettings(settings)
macOS Windows
settings
ObjectopenAtLogin
boolean (可选) -true
登录时打开应用程序,false
将应用从登录启动项中删除。 默认值为false
.openAsHidden
boolean (optional) macOS Deprecated -true
to open the app as hidden. 默认值为false
. The user can edit this setting from the System Preferences soapp.getLoginItemSettings().wasOpenedAsHidden
should be checked when the app is opened to know the current value. This setting is not available on MAS builds or on macOS 13 and up.type
string (optional) macOS - The type of service to add as a login item. 默认值为:mainAppService
。 Only available on macOS 13 and up.mainAppService
- The primary application.agentService
- The property list name for a launch agent. The property list name must correspond to a property list in the app’sContents/Library/LaunchAgents
directory.daemonService
string (optional) macOS - The property list name for a launch agent. The property list name must correspond to a property list in the app’sContents/Library/LaunchDaemons
directory.loginItemService
string (optional) macOS - The property list name for a login item service. The property list name must correspond to a property list in the app’sContents/Library/LoginItems
directory.
serviceName
string (optional) macOS - The name of the service. Required iftype
is non-default. Only available on macOS 13 and up.path
string (可选) Windows - 登录时运行的可执行文件。 默认为process.execPath
。args
string[] (可选) Windows - 传递给可执行文件的控制台参数。 默认为空数组。 注意用引号包裹路径。enabled
boolean (可选) Windows -true
将更改已启用的启动注册表项,并在任务管理器和 Windows 设置中启用 / 禁用
应用程序。 默认值为true
。name
string (可选) Windows - 要写入注册表的值名称。 默认为应用的 AppUserModelId()。
设置应用程序的登录项设置。
如果需要在 Windows 上使用Squirrel的 autoUpdater
,你需要将启动路径设置为 Update.exe,并传递指定应用程序名称的参数。 例如:
const { app } = require('electron')
const path = require('node:path')
const appFolder = path.dirname(process.execPath)
const updateExe = path.resolve(appFolder, '..', 'Update.exe')
const exeName = path.basename(process.execPath)
app.setLoginItemSettings({
openAtLogin: true,
path: updateExe,
args: [
'--processStart', `"${exeName}"`,
'--process-start-args', '"--hidden"'
]
})
For more information about setting different services as login items on macOS 13 and up, see SMAppService
.
app.isAccessibilitySupportEnabled()
macOS Windows
Returns boolean
- 如果开启了Chrome的辅助功能, 则返回 true
,其他情况返false
。 如果使用了辅助技术(例如屏幕阅读),该 API 将返回 true
。 查看更多细节,请查阅 https://www.chromium.org/developers/design-documents/accessibility
app.setAccessibilitySupportEnabled(enabled)
macOS Windows
enable
逻辑值 - 启用或禁用访问权限树视图。
手动启用 Chrome 的辅助功能的支持, 允许在应用程序中设置是否开启辅助功能。 在Chromium's accessibility docs查看更多的细节 默认为禁用
此 API 必须在 ready
事件触发后调用
注意: 渲染访问权限树可能会严重影响您应用的性能。 默认情况下不应启用该功能。
app.showAboutPanel()
显示应用程序的"关于"面板选项。 这些选项可以被 app.setAboutPanelOptions(可选)
所覆盖。 This function runs asynchronously.
app.setAboutPanelOptions(options)
选项
对象applicationName
string (可选) - 应用程序的名字applicationVersion
string (可选) - 应用程序版本copyright
string (可选) - 版权信息version
string (可选) macOS - 应用程序版本号credits
string (可选) macOS Windows - 信用信息。authors
string[] (可选) Linux - 应用程序作者列表。website
string (可选) Linux - 应用程序的网站。iconPath
string (可选) Linux Windows - 以JPEG 或 PNG 文件格式为应用程序图标路径。 在 Linux 上,将显示为 64x64 像素,同时保留纵横比。 On Windows, a 48x48 PNG will result in the best visual quality.
设置 "关于" 面板选项。 这将覆盖应用程序在 macOS 上的 .plist
文件中定义的值。 详细信息请查阅 Apple 文档 。 在 Linux 上,没有默认值,所以必须设置值才能显示。
如果您没有设置 credits
但仍希望在应用中显示它们,AppKit 将在 NSBundle 类的main方法返回的捆绑包中按顺序查找名为"Credits.html", "Credits.rtf"和"Credits.rtfd"的文件。 先找到的文件将被使用,如果未找到,则信息区域将留空。 有关更多信息,请参阅 Apple 文档 。
app.isEmojiPanelSupported()
返回 boolean
- 当前操作系统是否支持本地 emoji 选择器。
app.showEmojiPanel()
macOS Windows
打开系统自身的emjio选取器。
app.startAccessingSecurityScopedResource(bookmarkData)
macOS
bookmarkData
string - base64 编码的安全作用域的书签数据(bookmark data) ,通过dialog.showOpenDialog
或者dialog.showSaveDialog
方法获取。
返回 Function
- 该函数 必须 在你完成访问安全作用域文件后调用一次。 如果你忘记停止访问书签,内核资源将会泄漏,并且你的应用将失去完全到达沙盒之外的能力,直到应用重启。
const { app, dialog } = require('electron')
const fs = require('node:fs')
let filepath
let bookmark
dialog.showOpenDialog(null, { securityScopedBookmarks: true }).then(({ filePaths, bookmarks }) => {
filepath = filePaths[0]
bookmark = bookmarks[0]
fs.readFileSync(filepath)
})
// ... restart app ...
const stopAccessingSecurityScopedResource = app.startAccessingSecurityScopedResource(bookmark)
fs.readFileSync(filepath)
stopAccessingSecurityScopedResource()
开始访问安全范围内的资源。 通过这个方法,Electron 应用被打包为可到达Mac App Store沙箱之外访问用户选择的文件。 关于系统工作原理,请查阅Apple's documentation
app.enableSandbox()
在应用程序上启用完全沙盒模式。 This means that all renderers will be launched sandboxed, regardless of the value of the sandbox
flag in WebPreferences
.
这个方法只能在应用程序准备就绪(ready)之前调用。
app.isInApplicationsFolder()
macOS
返回 boolean
- 应用程序当前是否从系统应用程序文件夹运行。 与 app.moveToApplicationsFolder()
一起使用
app.moveToApplicationsFolder([options])
macOS
返回 boolean
- 移动是否成功。 请注意,如果移动成功,您的应用程序将退出并重新启动。
默认情况下不会显示确认对话框。 如果您希望允许用户确认操作,您可以使用dialog
API 进行确认。
**注意:**如果并非是用户造成操作失败,这个方法会抛出错误。 例如,如果用户取消了授权会话,这个方法将返回false。 如果无法执行复制操作, 则此方法将抛出错误。 错误中的信息应该是翔实的,并告诉你到底是哪里出了问题。
默认情况下,如果应用程序目录中存在与被移动的应用同名的应用,并且 未 运行,则已有应用将被丢弃,被移动的应用将顶替其位置。 如果应该程序 正在 运行,先运行的应用程序得到焦点,同时之前的程序将退出它自己。 此行为可以通过提供可选的冲突处理器来更改,处理器返回的 boolean 将决定移动冲突是否通过默认行为得到解决。 即:返回 false
将确保不采取进一步行动,返回 true
将导致默认行为同时方法继续执行。
例如:
const { app, dialog } = require('electron')
app.moveToApplicationsFolder({
conflictHandler: (conflictType) => {
if (conflictType === 'exists') {
return dialog.showMessageBoxSync({
type: 'question',
buttons: ['Halt Move', 'Continue Move'],
defaultId: 0,
message: 'An app of this name already exists'
}) === 1
}
}
})
这意味着,如果应用已经存在于用户目录中,如果用户选择 '继续移动',则该功能将继续其默认行为,现有应用将被丢弃,当前应用将移动到其位置。
app.isSecureKeyboardEntryEnabled()
macOS
返回 boolean
- 是否启用 Secure Keyboard Entry
。
默认情况下,此 API 将返回 false
。
app.setSecureKeyboardEntryEnabled(enabled)
macOS
enabled
boolean - 启用或禁用Secure Keyboard Entry
在应用中启用 Secure Keyboard Entry
。
通过使用此 API,可以防止密码和其他敏感信息等重要信息被其他进程截获。
有关更多详细信息,请参阅 apple 文档 。
注意: 仅在需要时启用 Secure Keyboard Entry
,并在不再需要时禁用。
app.setProxy(config)
config
ProxyConfig
返回 Promise<void>
- 代理设置进程完成。
Sets the proxy settings for networks requests made without an associated Session. Currently this will affect requests made with Net in the utility process and internal requests made by the runtime (ex: geolocation queries).
This method can only be called after app is ready.
app.resolveProxy(url)
url
URL
Returns Promise<string>
- Resolves with the proxy information for url
that will be used when attempting to make requests using Net in the utility process.
app.setClientCertRequestPasswordHandler(handler)
Linux
-
handler
Function<Promise<string>>clientCertRequestParams
Objecthostname
string - the hostname of the site requiring a client certificatetokenName
string - the token (or slot) name of the cryptographic deviceisRetry
boolean - whether there have been previous failed attempts at prompting the password
Returns
Promise<string>
- Resolves with the password
The handler is called when a password is needed to unlock a client certificate for hostname
.
const { app } = require('electron')
async function passwordPromptUI (text) {
return new Promise((resolve, reject) => {
// display UI to prompt user for password
// ...
// ...
resolve('the password')
})
}
app.setClientCertRequestPasswordHandler(async ({ hostname, tokenName, isRetry }) => {
const text = `Please sign in to ${tokenName} to authenticate to ${hostname} with your certificate`
const password = await passwordPromptUI(text)
return password
})
属性
app.accessibilitySupportEnabled
macOS Windows
boolean
属性 - 如果开启了Chrome的辅助功能,则返回 true
,否则返回false
。 如果使用了辅助功能(例如屏幕阅读),该 API 将返回 true
。 手动将此属性设置为 true
可启用 Chrome 的辅助功能支持,允许开发人员在应用程序设置中向用户开放无障碍切换。
有关详细信息,请参阅 chromium 的无障碍文档 。 默认为禁用
此 API 必须在 ready
事件触发后调用
注意: 渲染访问权限树可能会严重影响您应用的性能。 默认情况下不应启用该功能。
app.applicationMenu
A Menu | null
property that returns Menu
if one has been set and null
otherwise. Users can pass a Menu to set this property.
app.badgeCount
Linux macOS
返回当前应用角标计数的 Integer
属性。 将计数设置为 0
将隐藏角标。
在 macOS 上,为该属性设置任何非零整数,会显示在dock 图标上。 在 Linux 上,这个属性只适用于 Unity 启动器。
注意: Unity 启动器需要一个 .desktop
文件才能工作。 欲了解更多信息, 请阅读 Unity integration 文档。
注意: 在 macOS 上,为了使该属性生效,您需要确保您的应用程序具有显示通知的权限。
app.commandLine
只读
A CommandLine
object that allows you to read and manipulate the command line arguments that Chromium uses.
app.dock
macOS 只读
Dock
| undefined
对象,允许您在 macOS 上的用户dock中对应用图标进行操作。
app.isPackaged
只读
返回一个boolean
值,如果应用已经打包,返回true
,否则返回false
。 对于大多数应用程序,此属性可用于区分开发和生产环境。
app.name
string
属性,指明当前应用程序的名称,即应用程序 package.json
文件中的名称。
根据 npm 的命名规则, 通常 package.json
中的 name
字段是一个短的小写字符串。 通常还应该指定一个 productName
字段, 是首字母大写的完整名称,用于表示应用程序的名称。Electron 会优先使用这个字段作为应用名。
app.userAgentFallback
string
Electron 用于全局回退的用户代理字符串。
当用户代理在webContents
或 session
级别没有被设置时,将使用此用户代理。 有助于确保您的整个应用程序具有相同的用户代理。 在应用初始化中尽早设置为自定义值,以确保使用的是您覆盖的值。
app.runningUnderARM64Translation
只读 macOS Windows
A boolean
为 true
时表明当前应用正在使用 ARM64 运行环境 (比如 macOS Rosetta Translator Environment 或者 Windows WOW).
You can use this property to prompt users to download the arm64 version of your application when they are mistakenly running the x64 version under Rosetta or WOW.