vscode-jsonrpc

VSCode JSON RPC

This npm module implements the base messaging protocol spoken between a VSCode language server and a VSCode language client.

The npm module can also be used standalone to establish a JSON-RPC channel between a client and a server. Below an example how to setup a JSON-RPC connection. First the client side.

import * as cp from 'child_process';
import * as rpc from 'vscode-jsonrpc/node';

let childProcess = cp.spawn(...);

// Use stdin and stdout for communication:
let connection = rpc.createMessageConnection(
	new rpc.StreamMessageReader(childProcess.stdout),
	new rpc.StreamMessageWriter(childProcess.stdin));

let notification = new rpc.NotificationType<string, void>('testNotification');

connection.listen();

connection.sendNotification(notification, 'Hello World');

The server side looks very symmetrical:

import * as rpc from 'vscode-jsonrpc/node';


let connection = rpc.createMessageConnection(
	new rpc.StreamMessageReader(process.stdin),
	new rpc.StreamMessageWriter(process.stdout));

let notification = new rpc.NotificationType<string, void>('testNotification');
connection.onNotification(notification, (param: string) => {
	console.log(param); // This prints Hello World
});

connection.listen();

History

For the history please see the main repository

License

MIT

Similar packages

Other packages similar to vscode-jsonrpc

json-rpc2

The json-rpc2 package is a JSON-RPC 2.0 implementation for Node.js. It provides similar functionality to vscode-jsonrpc, including creating servers and clients, sending requests, and handling notifications. However, it is a more general-purpose library and does not include some of the higher-level abstractions found in vscode-jsonrpc.

vscode-languageserver

The vscode-languageserver package builds on top of vscode-jsonrpc to provide a framework for implementing language servers. It includes additional features and abstractions specifically for language server development, such as handling text document synchronization and providing language features like completion and hover.

node-json-rpc

The node-json-rpc package is another JSON-RPC 2.0 implementation for Node.js. It provides basic functionality for creating JSON-RPC servers and clients, sending requests, and handling notifications. It is simpler and more lightweight compared to vscode-jsonrpc, but may lack some of the advanced features and flexibility.