gh-got

2018-09-15 admin

gh-got是什么

什么是gh-got,Convenience wrapper for got to interact with the GitHub API

gh-got使用教程帮助文档

gh-got Build Status

Convenience wrapper for got to interact with the GitHub API

Install

$ npm install gh-got

Usage

Instead of:

const got = require('got');
const token = 'foo';

(async () => {
	const {body} = await got('https://api.github.com/users/sindresorhus', {
		json: true,
		headers: {
			'accept': 'application/vnd.github.v3+json',
			'authorization': `token ${token}`
		}
	});

	console.log(body.login);
	//=> 'sindresorhus'
})();

You can do:

const ghGot = require('gh-got');

(async () => {
	const {body} = await ghGot('users/sindresorhus', {token: 'foo'});

	console.log(body.login);
	//=> 'sindresorhus'
})();

Or:

const ghGot = require('gh-got');

(async () => {
	const {body} = await ghGot('https://api.github.com/users/sindresorhus', {token: 'foo'});

	console.log(body.login);
	//=> 'sindresorhus'
})();

API

Same as got (including the stream API and aliases), but with some additional options below.

Errors are improved by using the custom GitHub error messages. Doesn’t apply to the stream API.

token

Type: string

GitHub access token.

Can be set globally with the GITHUB_TOKEN environment variable.

baseUrl

Type: string Default: https://api.github.com/

To support GitHub Enterprise.

Can be set globally with the GITHUB_ENDPOINT environment variable.

body

Type: Object

Can be specified as a plain object and will be serialized as JSON with the appropriate headers set.

Authorization

Authorization for GitHub uses the following logic:

  1. If options.headers.authorization is passed to gh-got, then this will be used as first preference.
  2. If options.token is provided, then the authorization header will be set to token <options.token>.
  3. If options.headers.authorization and options.token are not provided, then the authorization header will be set to token <process.env.GITHUB_TOKEN>

In most cases, this means you can simply set GITHUB_TOKEN, but it also allows it to be overridden by setting options.token or options.headers.authorization explicitly. For example, if authenticating as a GitHub App, you could do the following:

const ghGot = require(`gh-got`);

(async () => {
	const options = {
		headers: {
			authorization: `Bearer ${jwt}`
		}
	};
	const {body} = await ghGot('app', options);

	console.log(body.name);
	//=> 'MyApp'
})();

License

MIT © Sindre Sorhus

本站文章除注明转载外,均为本站原创或编译。欢迎任何形式的转载,但请务必注明出处。

转载请注明:文章转载自 JavaScript中文网 [https://www.javascriptcn.com]

本文地址:https://www.javascriptcn.com/read-40339.html

文章标题:gh-got

回到顶部