GitHub API client for GitHub Actions
| Browsers |
|
|---|---|
| Node |
Install with const { Octokit } = require("@octokit/action");
// or: import { Octokit } from "@octokit/action"; |
You can pass secret.GITHUB_TOKEN or any of your own secrets to a Node.js script. For example
name: My Node Action
on:
- pull_request
jobs:
my-action:
runs-on: ubuntu-latest
steps:
# Check out code using git
- uses: actions/checkout@v2
# Install Node 12
- uses: actions/setup-node@v1
with:
version: 12
# Node.js script can be anywhere. A good convention is to put local GitHub Actions
# into the `.github/actions` folder
- run: node .github/actions/my-script.js
with:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}Setting GITHUB_TOKEN on either with: or env: will work.
// .github/actions/my-script.js
const octokit = new Octokit();
// `octokit` is now authenticated using GITHUB_TOKENconst octokit = new Octokit();
const [owner, repo] = process.env.GITHUB_REPOSITORY.split("/");
// See https://developer.github.com/v3/issues/#create-an-issue
const { data } = await octokit.request("POST /repos/:owner/:repo/issues", {
owner,
repo,
title: "My test issue",
});
console.log("Issue created: %d", data.html_url);You can also use octokit.issues.create({ owner, repo, title }). See the REST endpoint methods plugin for a list of all available methods.
const octokit = new Octokit();
const eventPayload = require(process.env.GITHUB_EVENT_PATH);
const repositoryId = eventPayload.repository.node_id;
const response = await octokit.graphql(
`
mutation($repositoryId:ID!, $title:String!) {
createIssue(input:{repositoryId: $repositoryId, title: $title}) {
issue {
number
}
}
}
`,
{
repositoryId,
title: "My test issue",
}
);@octokit/action is build upon @octokit/core. Refer to its README for the full API documentation.
Types for endpoint method parameters and responses are exported as RestEndpointMethodTypes. They keys are the same as the endpoint methods. Here is an example to retrieve the parameter and response types for octokit.checks.create()
import { RestEndpointMethodTypes } from `@octokit/action`;
type ChecksCreateParams = RestEndpointMethodTypes["checks"]["create"]["parameters"];
type ChecksCreateResponse = RestEndpointMethodTypes["checks"]["create"]["response"];@octokit/action is simply a @octokit/core constructor, pre-authenticate using `@octokit/auth-action.
The source code is … simple: src/index.ts.
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
![greenkeeper[bot] avatar](https://avatars.githubusercontent.com/in/505?v=4 "greenkeeper[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent