diff --git a/docs/commands.md b/docs/commands.md index d1e438e2..186f4b24 100644 --- a/docs/commands.md +++ b/docs/commands.md @@ -122,7 +122,7 @@ echo "::save-state name=FOO::foovalue" ### Log Level -Finally, there are several commands to emit different levels of log output: +There are several commands to emit different levels of log output: | log level | example usage | |---|---| @@ -130,6 +130,29 @@ Finally, there are several commands to emit different levels of log output: | warning | `echo "::warning::My warning message"` | | error | `echo "::error::My error message"` | +### Command Echoing +By default, the echoing of commands to stdout only occurs if [Step Debugging is enabled](./actions-debugging.md#How-to-Access-Step-Debug-Logs) + +You can enable or disable this for the current step by using the `echo` command. + +```bash +echo "::echo::on" +``` + +You can also disable echoing. + +```bash +echo "::echo::off" +``` + +This is wrapped by the core method: + +```javascript +function setCommandEcho(enabled: boolean): void {} +``` + +The `add-mask`, `debug`, `warning` and `error` commands do not support echoing. + ### Command Prompt CMD processes the `"` character differently from other shells when echoing. In CMD, the above snippets should have the `"` characters removed in order to correctly process. For example, the set output command would be: ```cmd diff --git a/packages/core/__tests__/core.test.ts b/packages/core/__tests__/core.test.ts index d10e0590..29010652 100644 --- a/packages/core/__tests__/core.test.ts +++ b/packages/core/__tests__/core.test.ts @@ -239,6 +239,16 @@ describe('@actions/core', () => { process.env['RUNNER_DEBUG'] = current } }) + + it('setCommandEcho can enable echoing', () => { + core.setCommandEcho(true) + assertWriteCalls([`::echo::on${os.EOL}`]) + }) + + it('setCommandEcho can disable echoing', () => { + core.setCommandEcho(false) + assertWriteCalls([`::echo::off${os.EOL}`]) + }) }) // Assert that process.stdout.write calls called only with the given arguments. diff --git a/packages/core/src/core.ts b/packages/core/src/core.ts index 85fc547a..0cf9f04c 100644 --- a/packages/core/src/core.ts +++ b/packages/core/src/core.ts @@ -87,6 +87,15 @@ export function setOutput(name: string, value: any): void { issueCommand('set-output', {name}, value) } +/** + * Enables or disables the echoing of commands into stdout for the rest of the step. + * Echoing is disabled by default if ACTIONS_STEP_DEBUG is not set. + * + */ +export function setCommandEcho(enabled: boolean): void { + issue('echo', enabled ? 'on' : 'off') +} + //----------------------------------------------------------------------- // Results //-----------------------------------------------------------------------