2019-05-06 15:29:01 +00:00
|
|
|
## Class: CommandLine
|
|
|
|
|
|
|
|
> Manipulate the command line arguments for your app that Chromium reads
|
|
|
|
|
2021-06-15 20:50:31 +00:00
|
|
|
Process: [Main](../glossary.md#main-process)<br />
|
|
|
|
_This class is not exported from the `'electron'` module. It is only available as a return value of other methods in the Electron API._
|
2019-05-06 15:29:01 +00:00
|
|
|
|
|
|
|
The following example shows how to check if the `--disable-gpu` flag is set.
|
|
|
|
|
|
|
|
```javascript
|
|
|
|
const { app } = require('electron')
|
|
|
|
app.commandLine.hasSwitch('disable-gpu')
|
|
|
|
```
|
|
|
|
|
|
|
|
For more information on what kinds of flags and switches you can use, check
|
2019-10-04 17:49:09 +00:00
|
|
|
out the [Command Line Switches](./command-line-switches.md)
|
2019-05-06 15:29:01 +00:00
|
|
|
document.
|
|
|
|
|
|
|
|
### Instance Methods
|
|
|
|
|
|
|
|
#### `commandLine.appendSwitch(switch[, value])`
|
|
|
|
|
2021-11-16 04:13:18 +00:00
|
|
|
* `switch` string - A command-line switch, without the leading `--`
|
|
|
|
* `value` string (optional) - A value for the given switch
|
2019-05-06 15:29:01 +00:00
|
|
|
|
|
|
|
Append a switch (with optional `value`) to Chromium's command line.
|
|
|
|
|
|
|
|
**Note:** This will not affect `process.argv`. The intended usage of this function is to
|
|
|
|
control Chromium's behavior.
|
|
|
|
|
|
|
|
#### `commandLine.appendArgument(value)`
|
|
|
|
|
2021-11-16 04:13:18 +00:00
|
|
|
* `value` string - The argument to append to the command line
|
2019-05-06 15:29:01 +00:00
|
|
|
|
|
|
|
Append an argument to Chromium's command line. The argument will be quoted
|
|
|
|
correctly. Switches will precede arguments regardless of appending order.
|
|
|
|
|
|
|
|
If you're appending an argument like `--switch=value`, consider using `appendSwitch('switch', 'value')` instead.
|
|
|
|
|
|
|
|
**Note:** This will not affect `process.argv`. The intended usage of this function is to
|
|
|
|
control Chromium's behavior.
|
|
|
|
|
|
|
|
#### `commandLine.hasSwitch(switch)`
|
|
|
|
|
2021-11-16 04:13:18 +00:00
|
|
|
* `switch` string - A command-line switch
|
2019-05-06 15:29:01 +00:00
|
|
|
|
2021-11-16 04:13:18 +00:00
|
|
|
Returns `boolean` - Whether the command-line switch is present.
|
2019-05-06 15:29:01 +00:00
|
|
|
|
|
|
|
#### `commandLine.getSwitchValue(switch)`
|
|
|
|
|
2021-11-16 04:13:18 +00:00
|
|
|
* `switch` string - A command-line switch
|
2019-05-06 15:29:01 +00:00
|
|
|
|
2021-11-16 04:13:18 +00:00
|
|
|
Returns `string` - The command-line switch value.
|
2019-05-06 15:29:01 +00:00
|
|
|
|
|
|
|
**Note:** When the switch is not present or has no value, it returns empty string.
|
2021-10-06 20:45:58 +00:00
|
|
|
|
|
|
|
#### `commandLine.removeSwitch(switch)`
|
|
|
|
|
2021-11-16 04:13:18 +00:00
|
|
|
* `switch` string - A command-line switch
|
2021-10-06 20:45:58 +00:00
|
|
|
|
|
|
|
Removes the specified switch from Chromium's command line.
|
|
|
|
|
|
|
|
**Note:** This will not affect `process.argv`. The intended usage of this function is to
|
|
|
|
control Chromium's behavior.
|