Actions core lib
Last updated 4 months ago by thboop .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install @actions/core 
SYNC missed versions from official npm registry.


Core functions for setting results, logging, registering secrets and exporting variables across actions


Import the package

// javascript
const core = require('@actions/core');

// typescript
import * as core from '@actions/core';


Action inputs can be read with getInput. Outputs can be set with setOutput which makes them available to be mapped into inputs of other actions to ensure they are decoupled.

const myInput = core.getInput('inputName', { required: true });

core.setOutput('outputKey', 'outputVal');

Exporting variables

Since each step runs in a separate process, you can use exportVariable to add it to this step and future steps environment blocks.

core.exportVariable('envVar', 'Val');

Setting a secret

Setting a secret registers the secret with the runner to ensure it is masked in logs.


PATH Manipulation

To make a tool's path available in the path for the remainder of the job (without altering the machine or containers state), use addPath. The runner will prepend the path given to the jobs PATH.


Exit codes

You should use this library to set the failing exit code for your action. If status is not set and the script runs to completion, that will lead to a success.

const core = require('@actions/core');

try {
  // Do stuff
catch (err) {
  // setFailed logs the message and sets a failing exit code
  core.setFailed(`Action failed with error ${err}`);

Note that `setNeutral` is not yet implemented in actions V2 but equivalent functionality is being planned.


Finally, this library provides some utilities for logging. Note that debug logging is hidden from the logs by default. This behavior can be toggled by enabling the Step Debug Logs.

const core = require('@actions/core');

const myInput = core.getInput('input');
try {
  core.debug('Inside try block');
  if (!myInput) {
    core.warning('myInput was not set');
  if (core.isDebug()) {
    // curl -v https://github.com
  } else {
    // curl https://github.com

  // Do stuff
  core.info('Output to the actions build log')
catch (err) {
  core.error(`Error ${err}, action may still succeed though`);

This library can also wrap chunks of output in foldable groups.

const core = require('@actions/core')

// Manually wrap output
core.startGroup('Do some function')

// Wrap an asynchronous function call
const result = await core.group('Do something async', async () => {
  const response = await doSomeHTTPRequest()
  return response

Action state

You can use this library to save state and get state for sharing information between a given wrapper action:


name: 'Wrapper action sample'
    default: 'GitHub'
  using: 'node12'
  main: 'main.js'
  post: 'cleanup.js'

In action's main.js:

const core = require('@actions/core');

core.saveState("pidToKill", 12345);

In action's cleanup.js:

const core = require('@actions/core');

var pid = core.getState("pidToKill");


Current Tags

  • 1.2.6                                ...           latest (4 months ago)

12 Versions

  • 1.2.6                                ...           4 months ago
  • 1.2.5                                ...           5 months ago
  • 1.2.4                                ...           9 months ago
  • 1.2.3                                ...           10 months ago
  • 1.2.2                                ...           a year ago
  • 1.2.1                                ...           a year ago
  • 1.2.0                                ...           a year ago
  • 1.1.3                                ...           a year ago
  • 1.1.2                                ...           a year ago
  • 1.1.1                                ...           a year ago
  • 1.1.0                                ...           a year ago
  • 1.0.0                                ...           a year ago
Today 44
This Week 1,777
This Month 4,824
Last Day 251
Last Week 2,144
Last Month 10,613
Dependencies (0)
Dev Dependencies (1)
Dependents (198)

Copyright 2014 - 2016 © taobao.org |