Skip to content

Files

Latest commit

7b8308c · May 5, 2024

History

History
This branch is 2 commits ahead of, 290 commits behind grpc/grpc-node:master.

examples

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
Oct 2, 2023
Feb 12, 2024
Sep 26, 2023
May 5, 2024
Mar 21, 2024
Mar 13, 2024
Feb 12, 2024
Jun 27, 2023
Nov 29, 2023
Jun 22, 2023
Jun 22, 2023
Jun 22, 2023
Apr 30, 2024

gRPC in 3 minutes (Node.js)

PREREQUISITES

  • node: This requires Node 8.13.0 or greater.

INSTALL

$ # Get the gRPC repository
$ export REPO_ROOT=grpc-node # REPO root can be any directory of your choice
$ git clone -b RELEASE_TAG_HERE https://github.com/grpc/grpc-node $REPO_ROOT
$ cd $REPO_ROOT

$ cd examples
$ npm install

TRY IT!

There are two ways to generate the code needed to work with protocol buffers in Node.js - one approach uses Protobuf.js to dynamically generate the code at runtime, the other uses code statically generated using the protocol buffer compiler protoc. The examples behave identically, and either server can be used with either client.

  • Run the server

    $ # from this directory
    $ node ./helloworld/dynamic_codegen/greeter_server.js &
    $ # OR
    $ node ./helloworld/static_codegen/greeter_server.js &
  • Run the client

    $ # from this directory
    $ node ./helloworld/dynamic_codegen/greeter_client.js
    $ # OR
    $ node ./helloworld/static_codegen/greeter_client.js

TUTORIAL

You can find a more detailed tutorial in gRPC Basics: Node.js