grpc-node/packages/grpc-js
Michael Lumish ae61562be2
Merge pull request #1364 from murgatroid99/grpc-js_uri_parsing
grpc-js: Use a more structured representation of URIs internally
2020-04-20 12:19:18 -07:00
..
src Merge pull request #1364 from murgatroid99/grpc-js_uri_parsing 2020-04-20 12:19:18 -07:00
test Merge pull request #1364 from murgatroid99/grpc-js_uri_parsing 2020-04-20 12:19:18 -07:00
.eslintrc grpc-js: Fix how package.json is loaded 2020-04-14 13:58:12 -07:00
LICENSE Don't fill in any templates in LICENSE files 2019-03-06 11:01:44 -08:00
README.md grpc-js: rename grpc-js-core to match npm 2018-11-01 16:56:57 -04:00
gulpfile.ts grpc-js: skip gulp tasks based on Node version 2019-05-18 11:25:06 -04:00
package.json grpc-js: Interact with proxies properly 2020-04-14 10:43:36 -07:00
prettier.config.js build: add full gts configuration and fix TSLint issues 2019-11-07 22:14:24 +01:00
tsconfig.json grpc-js: resolve node/no-unpublished-require 2020-04-12 17:20:28 +02:00

README.md

Pure JavaScript gRPC Client

Note: This is an beta-level release. Some APIs may not yet be present and there may be bugs. Please report any that you encounter

Installation

Node 10 is recommended. The exact set of compatible Node versions can be found in the engines field of the package.json file.

npm install @grpc/grpc-js

Features

  • Unary and streaming calls
  • Cancellation
  • Deadlines
  • TLS channel credentials
  • Call credentials (for auth)
  • Simple reconnection
  • Channel API

This library does not directly handle .proto files. To use .proto files with this library we recommend using the @grpc/proto-loader package.

Some Notes on API Guarantees

The public API of this library follows semantic versioning, with some caveats:

  • Some methods are prefixed with an underscore. These methods are internal and should not be considered part of the public API.
  • The class Call is only exposed due to limitations of TypeScript. It should not be considered part of the public API.
  • In general, any API that is exposed by this library but is not exposed by the grpc library is likely an error and should not be considered part of the public API.