Skip to content

Repository files navigation

ReactiveExtensionsSharp

buildNuGetdocslicense

A .NET port of RxJS — same operators, same semantics, same names you already know, in idiomatic C#.

Why a new Rx library when Rx.NET exists? ReactiveExtensionsSharp isn't trying to replace it — it's a deliberately faithful port of RxJS specifically, built to make it painless to bring JS reactive code (and the libraries built on it, like Puppeteer) over to .NET without re-learning a different Rx dialect. If you know pipe(map(...), filter(...), takeUntil(...)), you already know ReactiveExtensionsSharp.

Quick taste

// RxJSimport{fromEvent,interval}from'rxjs';import{map,filter,takeUntil}from'rxjs/operators';constclicks$=fromEvent(button,'click');interval(1000).pipe(map(x=>x*x),filter(x=>x%2===0),takeUntil(clicks$),).subscribe(x=>console.log(x));

Same pipeline in ReactiveExtensionsSharp — real, compiling code:

varclicks=Observable.FromEvent<EventArgs>(h =>button.Click+=h, h =>button.Click-=h);Observable.Interval(TimeSpan.FromSeconds(1)).Map(x =>x*x).Filter(x =>x%2==0).TakeUntil(clicks).Subscribe(x =>Console.WriteLine(x));

snippet source | anchor

What about pipe?

RxJS's pipe(op1, op2, op3) is mostly just method chaining wearing a different hat — source.Map(...).Filter(...) above is the translation. But RxJS's pipe() has a second job: called on its own (not as an Observable method), it builds a reusable transformation out of several operators, so you can define it once and apply it to multiple streams. ReactiveExtensionsSharp covers that with OperatorFunction<TSource, TResult> + Pipe:

publicstaticvoidRun(Observable<int>numbersA,Observable<int>numbersB){// A reusable transformation, defined once - the equivalent of RxJS's standalone// `const squareAndFilterEven = pipe(map(x => x * x), filter(x => x % 2 === 0));`OperatorFunction<int,int>squareAndFilterEven= source =>source.Map(x =>x*x).Filter(x =>x%2==0);numbersA.Pipe(squareAndFilterEven).Subscribe(x =>Console.WriteLine(x));numbersB.Pipe(squareAndFilterEven).Subscribe(x =>Console.WriteLine(x));}

snippet source | anchor

There's no hand-written 9-arity pipe(op1, op2, ..., op9) overload set, deliberately — it exists in RxJS mainly to work around JS not having method chaining with generics the way C# does. Pipe here only takes a single, already-composed OperatorFunction; build that function with ordinary chaining, same as everywhere else.

The example that started this project

Puppeteer (the JS browser-automation library) builds its Locator.click()/.fill() actions on exactly one rxjs combinator: retry a flaky DOM action, racing the whole thing against a timeout and a cancellation signal. Its own wrapper for this is pipe(retry({delay}), raceWith(fromAbortSignal(...), timeout(...))) — three operators composed once, reused everywhere it needs "keep trying until this works, but don't wait forever." Puppeteer's own .NET port, puppeteer-sharp, doesn't have that composition available, so the equivalent logic there is a hand-rolled while(true) loop with a linked CancellationTokenSource and five catch clauses to tell "timed out" apart from "cancelled" apart from "just retry."

ReactiveExtensionsSharp ports that exact combinator as RetryAndRaceWithSignalAndTimer, proven against a real launched Chrome:

// Retries a flaky async operation - "find an element that may not have rendered yet" is the// Puppeteer case, but this works for any operation that fails until some condition is met -// until it succeeds, times out, or the caller cancels.publicstaticasyncTask<string>FindElementOnceItRendersAsync(Func<Task<string>>tryFindElement,CancellationTokencancellationToken)=>awaitObservable.Defer(()=>Observable.From(tryFindElement())).RetryAndRaceWithSignalAndTimer(TimeSpan.FromSeconds(5),cancellationToken).ConfigureAwait(false);

snippet source | anchor

Install

dotnet add package ReactiveExtensionsSharp

Targets netstandard2.0, net8.0, and net10.0.

Contributing

Every operator PR follows the same recipe: find its spec in upstream RxJS (spec/operators/*-spec.ts or spec/observables/*-spec.ts at tag 7.8.2), port the test cases first, then implement until green. See CLAUDE.md for the full set of conventions.

License

MIT

About

A .NET port of RxJS (Reactive Extensions for JavaScript)

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages