https://github.com/colonelbundy/nodebridge
Bridge between .net standard and node.js for pre/server side rendering or node specific tasks.
https://github.com/colonelbundy/nodebridge
aspnetcore bridge netstandard netstandard20 node nodeservices-prerendering server-side-rendering ssr
Last synced: 8 days ago
JSON representation
Bridge between .net standard and node.js for pre/server side rendering or node specific tasks.
- Host: GitHub
- URL: https://github.com/colonelbundy/nodebridge
- Owner: ColonelBundy
- License: mit
- Created: 2019-07-18T21:37:20.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2023-01-07T07:57:42.000Z (over 2 years ago)
- Last Synced: 2023-08-06T06:52:48.323Z (almost 2 years ago)
- Topics: aspnetcore, bridge, netstandard, netstandard20, node, nodeservices-prerendering, server-side-rendering, ssr
- Language: C#
- Homepage:
- Size: 498 KB
- Stars: 4
- Watchers: 2
- Forks: 1
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
⛓️ Nodebridge ⛓️
[](https://www.nuget.org/packages/NodeBridge/)
> Bridge between .net standard 2.0 and node.js for pre/server side rendering or node specific tasks.
## ❔ Why use this instead of nodeservices from Microsoft?
> Nodeservices from microsoft spawn a new process almost every new request. And sometimes in situations where you need to persist the process for configuration purposes or just for plain performance, you can't with nodeservices.
> Nodeservices also supports streams where I choose to skip that, if that is needed check the implementation [here](https://github.com/aspnet/JavaScriptServices/blob/bc8984693d4ffe215cc741c97772911c60a2f512/src/Microsoft.AspNetCore.NodeServices/HostingModels/HttpNodeInstance.cs#L96) and create a pr.
## 📄 Prerequisites
* node >= 10.5 (prefer 12.x)
* .net standard 2.0
## 🚀 Usage
### In Startup -> ConfigureServices
```C#
services.AddNodeBridge(options => {
options.Workingdirectory = ""; // Optional: base directory for your node files. Default: Working directory of your project.
options.Instances = 1; // Optional: Number of worker threads to spawn. Default: Number of cores of your system.
options.Logger = loggerInstance; // Optional: Attach any logger that implements the ILogger interface. Default: standard ILogger.
options.Port = 3000; // Optional: Port for the node bridge to listen on. Default: Random port.
});
```
### Usage in controllers
```C#
public class ValuesController : Controller
{
private readonly Bridge _bridge;
public ValuesController(Bridge bridge)
{
_bridge = bridge;
}
public async Task Index()
{
// Note!
// Any exported function should return a promise.
var result = _bridge.Invoke("file.js", "test", "hello"); // Will invoke function test in file.js with hello as the first argument.
ViewBag.result = result;
return View();
}
}
```
## 📝 License
Copyright © 2020 [Colonelbundy](https://github.com/ColonelBundy).
This project is [MIT](https://github.com/ColonelBundy/Nodebridge/blob/master/LICENSE) licensed.