Содержание
- Synopsis
- Event: will-finish-launching
- Event: finish-launching
- Event: window-all-closed
- Event: will-quit
- Event: open-file
- Event: open-url
- app.quit()
- app.terminate()
- app.getVersion()
- app.commandLine.appendSwitch(switch, [value])
- app.commandLine.appendArgument(value)
- app.dock.bounce([type])
- app.dock.cancelBounce(id)
- app.dock.setBadge(text)
- app.dock.getBadge()
Этот файл содержит неоднозначные символы Юникода, которые могут быть перепутаны с другими в текущей локали. Если это намеренно, можете спокойно проигнорировать это предупреждение. Используйте кнопку Экранировать, чтобы подсветить эти символы.
Synopsis
The app
module is responsible for controlling the application's life time.
The example of quitting the whole application when the last window is closed:
var app = require('app');
app.on('window-all-closed', function() {
app.quit();
});
Event: will-finish-launching
Setup crash reporter and auto updater here.
Event: finish-launching
Do final startup like creating browser window here.
Event: window-all-closed
Emitted when all windows have been closed.
This event is only emitted when the application is not going to quit. If a user pressed Cmd + Q
, or the developer called app.quit()
, atom-shell would first try to close all windows and then emit the will-quit
event, and in this case the window-all-closed
would not be emitted.
Event: will-quit
event
Event
Emitted when all windows have been closed and the application will quit. Calling event.preventDefault()
will prevent the default behaviour, which is terminating the application.
See description of window-all-closed
for the differences between will-quit
and it.
Event: open-file
event
Eventpath
String
Emitted when user wants to open a file with the application, it usually happens when the application is already opened and then OS wants to reuse the application to open file.
You should call event.preventDefault()
if you want to handle this event.
Event: open-url
event
Eventurl
String
Emitted when user wants to open a URL with the application, this URL scheme must be registered to be opened by your application.
You should call event.preventDefault()
if you want to handle this event.
app.quit()
Try to close all windows. If all windows are successfully closed, the will-quit
event will be emitted and by default the application would be terminated.
This method guarantees all beforeunload
and unload
handlers are correctly executed. It is possible that a window cancels the quitting by returning false
in beforeunload
handler.
app.terminate()
Quit the application directly, it will not try to close all windows so cleanup code will not run.
app.getVersion()
Returns the version of current bundle or executable.
app.commandLine.appendSwitch(switch, [value])
Append a switch [with optional value] to Chromium's command line.
Note: This will not affect process.argv
, and is mainly used by developers to control some low-level Chromium behaviors.
app.commandLine.appendArgument(value)
Append an argument to Chromium's command line. The argument will quoted properly.
Note: This will not affect process.argv
.
app.dock.bounce([type])
type
String - Can becritical
orinformational
, the default isinformational
When critical
is passed, the dock icon will bounce until either the application becomes active or the request is canceled.
When informational
is passed, the dock icon will bounce for one second. The request, though, remains active until either the application becomes active or the request is canceled.
An ID representing the request would be returned.
Note: This API is only available on Mac.
app.dock.cancelBounce(id)
id
Integer
Cancel the bounce of id
.
Note: This API is only available on Mac.
app.dock.setBadge(text)
text
String
Sets the string to be displayed in the dock’s badging area.
Note: This API is only available on Mac.
app.dock.getBadge()
Returns the badge string of the dock.
Note: This API is only available on Mac.